##HarmonyOS Next实战##HarmonyOS SDK应用服务##教育##
目标:实现视频组件的播放、暂停、结束播放、重置和跳转至特定位置播放。
Video组件用于播放视频文件并控制其播放状态,常用于为短视频和应用内部视频的列表页面。当视频完整出现时会自动播放,用户点击视频区域则会暂停播放,同时显示播放进度条,通过拖动播放进度条指定视频播放到具体位置。具体用法请参考Video。
加载视频资源
Video组件支持加载本地视频和网络视频。
添加属性
Video组件属性主要用于设置视频的播放形式。例如设置视频播放是否静音、播放是否显示控制条等。
事件调用
Video组件回调事件主要为播放开始、暂停结束、播放失败、播放停止、视频准备和操作进度条等事件,除此之外,Video组件也支持通用事件的调用,如点击、触摸等事件的调用。
Video控制器使用
Video控制器主要用于控制视频的状态,包括播放、暂停、停止以及设置进度等,详细使用请参考VideoController使用说明。
- 默认控制器:默认的控制器支持视频的开始、暂停、进度调整、全屏显示四项基本功能。
- 自定义控制器:使用自定义的控制器,先将默认控制器关闭掉,之后可以使用button以及slider等组件进行自定义的控制与显示,适合自定义较强的场景下使用。
其他说明
Video组件已经封装好了视频播放的基础能力,开发者无需进行视频实例的创建,视频信息的设置获取,只需要设置数据源以及基础信息即可播放视频,相对扩展能力较弱。
实战:VideoPage
@Entry
@Component
struct VideoPage {
@State videoSrc: Resource = $rawfile('video_demo.mp4')
@State previewUri: Resource = $rawfile('video_preview.jpg')
@State curRate: PlaybackSpeed = PlaybackSpeed.Speed_Forward_1_00_X
@State isAutoPlay: boolean = false
@State showControls: boolean = true
@State isShortcutKeyEnabled: boolean = false
controller: VideoController = new VideoController()
build() {
Column() {
Video({
src: this.videoSrc,
previewUri: this.previewUri,
currentProgressRate: this.curRate,
controller: this.controller
})
.width('100%')
.aspectRatio(16/9)
.autoPlay(this.isAutoPlay)
.controls(this.showControls)
.enableShortcutKey(this.isShortcutKeyEnabled)
.onStart(() => {
console.info('onStart')
})
.onPause(() => {
console.info('onPause')
})
.onFinish(() => {
console.info('onFinish')
})
.onError(() => {
console.info('onError')
})
.onStop(() => {
console.info('onStop')
})
.onPrepared((e?: DurationObject) => {
if (e != undefined) {
console.info('onPrepared is ' + e.duration)
}
})
.onSeeking((e?: TimeObject) => {
if (e != undefined) {
console.info('onSeeking is ' + e.time)
}
})
.onSeeked((e?: TimeObject) => {
if (e != undefined) {
console.info('onSeeked is ' + e.time)
}
})
.onUpdate((e?: TimeObject) => {
if (e != undefined) {
console.info('onUpdate is ' + e.time)
}
})
.onFullscreenChange((e?: FullscreenObject) => {
if (e != undefined) {
console.info('onFullscreenChange is ' + e.fullscreen)
}
})
Row() {
Button('播放').onClick(() => {
this.controller.start() // 开始播放
}).margin(2)
Button('暂停').onClick(() => {
this.controller.pause() // 暂停播放
}).margin(2)
Button('结束播放').onClick(() => {
this.controller.stop() // 结束播放
}).margin(2)
}
Row(){
Button('重置视频').onClick(() => {
this.controller.reset() // 重置AVPlayer
}).margin(2)
Button('跳至第10秒').onClick(() => {
this.controller.setCurrentTime(10, SeekMode.Accurate) // 精准跳转到视频的10s位置
}).margin(2)
}
}
}
}
interface DurationObject {
duration: number;
}
interface TimeObject {
time: number;
}
interface FullscreenObject {
fullscreen: boolean;
}