
基于ArkTS语言的OpenHarmony APP应用开发:多媒体管理2 原创
1、程序介绍
本示例展示了视频组件的基本功能,以及如何控制播放状态的相关能力。包括视频组件化,全屏化,窗口化,上下轮播视频等。
本实例使用Video组件,具体如下:
-
进入首页点击播放按键。
-
点击视频播放按钮,视频开始播放。再次点击视频进入视频全屏页。
-
首页下滑500vp后,视频小窗口化。
-
4.点击直播按钮进入直播页,上下滑动视频。
本案例已在OpenHarmony凌蒙派-RK3568开发板验证通过,具体代码可参考:https://gitee.com/Lockzhiner-Electronics/lockzhiner-rk3568-openharmony/tree/master/samples/d09_VideoShow
API版本:9
2、知识准备
2.1、Video
用于播放视频文件并控制其播放状态的组件。
使用网络视频时,需要申请权限ohos.permission.INTERNET。
详细请参考:官方文档
2.1.1、接口
参数定义如下所示:
参数名 | 参数类型 | 必填 | 参数描述 |
---|---|---|---|
src | string | Resource | 否 | 视频播放源的路径,支持本地视频路径和网络路径。 支持在resources下面的video或rawfile文件夹里放置媒体资源。 视频支持的格式是:mp4、mkv、webm、ts。 |
currentProgressRate | number | string | PlaybackSpeed | 否 | 视频播放倍速。 number取值仅支持:0.75,1.0,1.25,1.75,2.0 |
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)导入对象
(2)start
开始播放。
(3)pause
暂停播放,显示当前帧,再次播放时从当前位置继续播放。
(4)stop
停止播放,显示当前帧,再次播放时从头开始播放。
2.1.5、exitFullscreen
退出全屏播放。
2.1.6、setCurrentTime
指定视频播放的进度位置。
其中,参数定义如下:
参数名 | 参数类型 | 必填 | 参数描述 |
---|---|---|---|
value | number | 是 | 视频播放进度位置,单位为s |
3、程序解析
本案例展示了视频组件的基本功能,以及如何控制播放状态的相关能力。包括视频组件化,全屏化,窗口化,上下轮播视频等。
本案例主要分为以下几个部分:
(1)MainPage.ets,负责主页面,通过调用其它自定义控件播放视频;
(2)VideoPage.ets:负责上方轮播图视频播放和控制;
(3)SmallVideo.ets:负责小窗口视频播放和控制;
(4)LivePage.ets:负责显示直播页面;
(5)FullPage.ets:全屏显示视频播放页面;
3.1、申请权限
申请网络视频权限,在entry/src/main/module.json5文件中添加如下内容:
3.2、MainPage.ets
在entry/src/main/ets/pages/Index.ets文件中调用MainPage自定义组件。
在VideoComponent/src/main/ets/components/pages/MainPage.ets文件中,首先设置媒体查询的查询条件。
其次,对监听句柄进行事件绑定。
再次,通过调用VideoPage显示轮播图视频播放。
再次,调用SmallVideo显示小视频播放。
最后,显示直播视频按键。
注意:当Flex触发鼠标按下事件,则通过router.push()跳转到LivePage.ets页面。
3.3、VideoPage.ets
首先,定义播放视频的资源以及视频播放控制器。
其次,调用Video组件,并将视频资源和视频控制器代入。
最后,通过video组件的.onClick()响应事件,控制视频播放。
其中,关于播放时间显示(即变量updateTime)需要特别注意。在此不赘述。
3.4、SmallVideo.ets
SmallVideo自定义组件则负责小窗口视频播放,通过调用Video播放视频文件。
首先,定义视频资源和视频控制器。
其次,将视频资源和视频控制器放入Video控件。
注意:.onFinish()事件是在视频播放完毕后触发。
3.5、LivePage.ets
LivePage.ets负责显示直播页面。
首先,定义一个媒体查询的监听句柄。
其次,在aboutToAppear()中将视频播放绑定,并通过http连接请求,获取网络视频信息。
最后,在build()中显示网络视频直播。
3.6、FullPage.ets
FullPage.ets负责全屏显示视频播放页面。
首先,定义一个媒体查询的监听句柄和视频控制器。
其次,在aboutToAppear()中绑定当前用例。
最后,调用Video组件控制视频播放。
4、项目编译
4.1、打开项目
打开DevEco Studio,再打开自定义通知项目。
4.2、编译程序
点击菜单栏上的“Build” -> “Rebuild Project”。如果出现无法编译,则注意查看Event Log界面。如下所示:
点击Run 'npm install'
,让DevEco Studio安装相关依赖包。
重新点击菜单栏上的“Build” -> “Rebuild Project”。出现如下错误:
点击上图红色框部分,安装相关服务。
重新点击菜单栏上的“Build” -> “Rebuild Project”,编译成功。
4.3、安装程序
点击“entry”按钮,将项目程序安装到设备端。如下图所示:
如果出现下述报错,表示无法安装。如图所示:
点击上图红色框的蓝色字体,弹出"Project Structure"对话框,点击"Apply",再点击"OK"。如图所示:
重新点击“entry”按钮,将项目程序安装到设备端。
5、运行结果
