README_zh.md
1# 视频播放
2
3### 介绍
4视频播放的主要工作是将视频数据转码并输出到设备进行播放,同时管理播放任务。本文将对视频播放全流程、视频切换、视频循环播放等场景开发进行介绍说明。
5本示例主要展示了播放本地视频和网络视频相关功能,使用 [@ohos.multimedia.media](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-media.md#bufferinginfotype8),[@ohos.resourceManager](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-resource-manager.md),[@ohos.wifiManager](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-wifiManager.md)等接口,实现了视频播放、暂停、调节倍速、切换视频的功能;实现效果如下;
6
7### 效果预览
8| 播放 | 暂停 | 倍速弹窗 | 视频列表 |
9|------------------------------------------|---------------------------------------|--------------------------------------------|-------------------------------------------|
10|  |  |  |  |
11| 拖动滑动条 |
12|  |
13
14使用说明
15
161.点击视频界面,唤起视频操作面板,再次点击操作面板消失,如果不做任何操作操作界面会5s自动消失;
17
182.点击暂停/播放按钮,控制视频暂停播放;
19
203.滑动视频进度条,视频跳转到指定位置,在视频中间会出现时间进度方便用户查看视频进度;
21
224.点击倍速,可以选择1.0、1.25、1.75、2.0进行倍速调节;
23
245.点击下方视频名称,可以选择视频进行切换。注意:network是网络视频,检测到没有连接网络会退出应用,有网络能在本地视频和网络视频进行切换;
25
266.点击左上角退出箭头,退出应用。
27
28### 目录结构
29```
30VideoPlay/src/main/ets/
31|---components
32| |---ExitVideo.ets // 退出应用组件
33| |---SpeedDialog.ets // 播放倍速弹窗
34| |---VideoOperate.ets // 视频操作组件
35| |---VideoPanel.ets // 视频列表
36|---pages
37| |---Index.ets // 首页视频界面
38|---utils
39| |---Logger.ts // 日志帮助类
40| |---TimeUtils.ts // 视频时间帮助类
41|---videomanager
42| |---AvPlayManager.ts // 视频管理接口,统一封装了对外提供的功能接口
43```
44
45### 具体实现
46+ 视频倍速切换、暂停、播放、切换视频、视频跳转的功能接口都封装在AvPlayManager.ts,源码参考:[AvPlayManager.ts](entry%2Fsrc%2Fmain%2Fets%2Fvideomanager%2FAvPlayManager.ts);
47+ 使用media.createAVPlayer()来获取AVPlayer对象;
48+ 倍速切换:选择不同的倍速时调用avPlayer.setSpeed(speed: PlaybackSpeed);
49+ 暂停、播放:点击暂停、播放时调用avPlayer.pause()、avPlayer.play();
50+ 切换视频:在切换视频前要先调用avPlayer.reset()重置资源,再通过avPlayer.fdSrc为fdSrc赋值触发initialized状态机上报;
51+ 视频跳转:在拖动滑动条时调用avPlayer.seek()
52
53### 相关权限
54
55#### [ohos.permission.INTERNET](https://docs.openharmony.cn/pages/v3.2/zh-cn/application-dev/security/permission-list.md/)
56#### [ohos.permission.GET_WIFI_INFO](https://docs.openharmony.cn/pages/v3.2/zh-cn/application-dev/security/permission-list.md/)
57
58### 依赖
59不涉及。
60
61### 约束与限制
62
631.本示例仅支持标准系统上运行,需要联网才能够播放网络视频;
64
652.本示例已适配API9版本SDK,版本号:3.2.11.10,镜像版本号:OpenHarmony4.0.7.5;
66
673.本示例需要使用DevEco Studio 3.1 Beta2 (Build Version: 3.1.0.400, built on April 7, 2023)才可编译运行。
68
69### 下载
70如需单独下载本工程,执行如下命令:
71```
72git init
73git config core.sparsecheckout true
74echo code/BasicFeature/Media/VideoPlay/ > .git/info/sparse-checkout
75git remote add origin https://gitee.com/openharmony/applications_app_samples.git
76git pull origin master
77```