[文章]基于ArkTS语言的OpenHarmony APP应用开发:多媒体管理

阅读量0
0
0

1、程序介绍

本示例展示了视频组件的基本功能,以及如何控制播放状态的相关能力,包括视频切换、封面切换、播放、暂停等。

本案例已在OpenHarmony凌蒙派-RK3568开发板验证通过,具体代码可参考:https://gitee.com/Lockzhiner-Electronics/lockzhiner-rk3568-openharmony/tree/master/samples/d08_SampleVideoPlayer

API版本:9

2、知识准备

2.1、Video

用于播放视频文件并控制其播放状态的组件。

使用网络视频时,需要申请权限ohos.permission.INTERNET。

2.1.1、接口

Video(value: {src?: string | Resource, currentProgressRate?: number | string | PlaybackSpeed, previewUri?: string | PixelMap | Resource, controller?: VideoController})

参数定义如下所示:

参数名 参数类型 必填 参数描述
src string Resource
currentProgressRate number string PlaybackSpeed
previewUri string PixelMap Resource
controller VideoController 设置视频控制器

其中,PlaybackSpeed定义如下所示:

名称 描述
Speed_Forward_0_75_X 0.75倍速播放
Speed_Forward_1_00_X 1倍速播放
Speed_Forward_1_25_X 1.25倍速播放
Speed_Forward_1_75_X 1.75倍速播放
Speed_Forward_2_00_X 2倍速播放

2.1.2、属性

除支持通用属性外,还支持以下属性:

名称 参数类型 描述
muted boolean 是否静音。 默认值:false
autoPlay boolean 是否自动播放。 默认值:false
controls boolean 控制视频播放的控制栏是否显示。 默认值:true
objectFit ImageFit 设置视频显示模式。 默认值:Cover
loop boolean 是否单个视频循环播放。 默认值:false

2.1.3、事件

除支持通用事件外,还支持以下事件:

名称 功能描述
onStart(event:() => void) 播放时触发该事件
onPause(event:() => void) 暂停时触发该事件
onFinish(event:() => void) 播放结束时触发该事件
onError(event:() => void) 播放失败时触发该事件
onPrepared(callback:(event?: { duration: number }) => void) 视频准备完成时触发该事件,通过duration可以获取视频时长,单位为秒(s)
onSeeking(callback:(event?: { time: number }) => void) 操作进度条过程时上报时间信息,单位为s
onSeeked(callback:(event?: { time: number }) => void) 操作进度条完成后,上报播放时间信息,单位为s
onUpdate(callback:(event?: { time: number }) => void) 播放进度变化时触发该事件,单位为s,更新时间间隔为250ms
onFullscreenChange(callback:(event?: { fullscreen: boolean }) => void) 在全屏播放与非全屏播放状态之间切换时触发该事件,返回值为true表示进入全屏播放状态,为false则表示非全屏播放

2.1.4、VideoController

一个VideoController对象可以控制一个或多个video。

(1)导入对象

controller: VideoController = new VideoController()

(2)start

start(): void

开始播放。

(3)pause

pause(): void

暂停播放,显示当前帧,再次播放时从当前位置继续播放。

(4)stop

stop(): void

停止播放,显示当前帧,再次播放时从头开始播放。

2.1.5、exitFullscreen

exitFullscreen()

退出全屏播放。

2.1.6、setCurrentTime

setCurrentTime(value: number)

指定视频播放的进度位置。

其中,参数定义如下:

参数名 参数类型 必填 参数描述
value number 视频播放进度位置,单位为s

3、程序解析

3.1、申请权限

申请网络视频权限,在entry/src/main/module.json5文件中添加如下内容:

"requestPermissions": [
  {
    "name": "ohos.permission.INTERNET"
  }
]

3.2、拷贝资源

(1)拷贝视频

将2个视频文件拷贝至entry/src/main/resources/rawfile中。

注意:不能拷贝到上述目录下,而是通过DevEco Studio拷贝rawfile目录下。如下图所示:
将视频拷贝至rawfile.png

(2)拷贝图片

将2个图片文件拷贝至entry/src/main/resources/base/media中。

注意:不能拷贝到上述目录下,而是通过DevEco Studio拷贝media目录下。如下图所示:
将图片拷贝至media.png

3.3、编写源代码

在entry/src/main/ets/pages/Index.ets文件中调用MainPage自定义组件。如下所示:

@Entry
@Component
struct Index {
  @State videoSrc: Resource = $rawfile('video1.mp4')                  // 设置视频
  @State previewUri: Resource = $r('app.media.video1_picture')        // 设置封面
  @State curRate: PlaybackSpeed = PlaybackSpeed.Speed_Forward_1_00_X  // 设置视频播放速度
  @State isAutoPlay: boolean = false
  @State showControls: boolean = true
  controller: VideoController = new VideoController()                 // 设置视频控制器
​
  build() {
    Column() {
      Video({
        src: this.videoSrc,                   // 设置视频数据文件
        previewUri: this.previewUri,          // 设置视频封面
        currentProgressRate: this.curRate,    // 设置视频播放速率
        controller: this.controller           // 设置视频控制器
      }).width(320).height(240)
        .autoPlay(this.isAutoPlay)
        .controls(this.showControls)
        .onStart(() => {
          console.info('onStart')
        })
        .onPause(() => {
          console.info('onPause')
        })
        .onFinish(() => {
          console.info('onFinish')
        })
        .onError(() => {
          console.info('onFinish')
        })
        .onPrepared((e) => {
          console.info('onPrepared is ' + e.duration)
        })
        .onSeeking((e) => {
          console.info('onSeeking is ' + e.time)
        })
        .onSeeked((e) => {
          console.info('onSeeked is ' + e.time)
        })
        .onUpdate((e) => {
          console.info('onUpdate is ' + e.time)
        })
​
      Row() {
        Button('切换视频').onClick(() => {
          this.videoSrc = $rawfile('video2.mp4') // 切换视频源
        }).margin(5)
        Button('切换封面').onClick(() => {
          this.previewUri = $r('app.media.video2_picture') // 切换视频预览海报
        }).margin(5)
        Button('切换控制栏').onClick(() => {
          this.showControls = !this.showControls          // 切换是否显示视频控制栏
        }).margin(5)
      }
​
      Row() {
        Button('开始播放').onClick(() => {
          this.controller.start() // 开始播放
        }).margin(5)
        Button('暂停播放').onClick(() => {
          this.controller.pause() // 暂停播放
        }).margin(5)
        Button('结束播放').onClick(() => {
          this.controller.stop() // 结束播放
        }).margin(5)
        Button('跳转位置').onClick(() => {
          this.controller.setCurrentTime(10, SeekMode.Accurate) // 精准跳转到视频的10s位置
        }).margin(5)
      }
​
      Row() {
        Button('0.75倍速').onClick(() => {
          this.curRate = PlaybackSpeed.Speed_Forward_0_75_X // 0.75倍速播放
        }).margin(5)
        Button('1倍速').onClick(() => {
          this.curRate = PlaybackSpeed.Speed_Forward_1_00_X // 原倍速播放
        }).margin(5)
        Button('2倍速').onClick(() => {
          this.curRate = PlaybackSpeed.Speed_Forward_2_00_X // 2倍速播放
        }).margin(5)
      }
    }
  }
}

注意:上述主要通过VideoController类对象相应接口控制视频。

4、项目编译

4.1、打开项目

打开DevEco Studio,再打开自定义通知项目。

4.2、编译程序

点击菜单栏上的“Build” -> "Rebuild Project"。如果出现无法编译,则注意查看Event Log界面。如下所示:
question_npm_install.png

点击Run 'npm install',让DevEco Studio安装相关依赖包。

重新点击菜单栏上的“Build” -> "Rebuild Project"。出现如下错误:
question_root_module.png
点击上图红色框部分,安装相关服务。

重新点击菜单栏上的“Build” -> "Rebuild Project",编译成功。
rebuild_project_successful.png

4.3、安装程序

点击“entry”按钮,将项目程序安装到设备端。如下图所示:
heap_install_to_device.png
如果出现下述报错,表示无法安装。如图所示:
heap_install_failed.png

点击上图红色框的蓝色字体,弹出"Project Structure"对话框,点击"Apply",再点击"OK"。如图所示:
project_structure.png

重新点击“entry”按钮,将项目程序安装到设备端。
entry_successful.png

5、运行结果

运行结果.jpg

回帖

声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容图片侵权或者其他问题,请联系本站作侵删。 侵权投诉
链接复制成功,分享给好友