1. Video 视频组件
用于播放视频文件并控制其播放状态的组件。
接口:
Video(value: {src?: string | Resource, currentProgressRate?: number | string | PlaybackSpeed, previewUri?: string | PixelMap | Resource, controller?: VideoController})
参数:
参数名 | 参数类型 | 必填 | 参数描述 |
---|---|---|---|
src | string | Resource | 否 | 视频播放源的路径,支持本地视频路径和网络路径。 支持在resources下面的video或rawfile文件夹里放置媒体资源。 支持dataability://的路径前缀,用于访问通过Data Ability提供的视频路径,具体路径信息详见DataAbility说明。 支持file:///data/storage路径前缀的字符串,用于读取应用沙箱路径内的资源。需要保证目录包路径下的文件有可读权限。 说明: 视频支持的格式是:mp4、mkv、webm、TS。 |
currentProgressRate | number | string | PlaybackSpeed8+ | 否 | 视频播放倍速。 说明: number取值仅支持:0.75,1.0,1.25,1.75,2.0。 默认值:1.0 | PlaybackSpeed.Speed_Forward_1_00_X |
previewUri | string | PixelMap8+ | Resource | 否 | 视频未播放时的预览图片路径,默认不显示图片。 |
controller | 否 | 设置视频控制器,可以控制视频的播放状态。 |
属性:
除支持通用属性外,还支持以下属性:
名称 | 参数类型 | 描述 |
---|---|---|
muted | boolean | 是否静音。 默认值:false |
autoPlay | boolean | 是否自动播放。 默认值:false |
controls | boolean | 控制视频播放的控制栏是否显示。 默认值:true |
objectFit | 设置视频显示模式。 默认值:Cover | |
loop | boolean | 是否单个视频循环播放。 默认值:false |
事件:
除支持通用事件外,还支持以下事件:
名称 | 功能描述 |
---|---|
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) | 操作进度条过程时上报时间信息。 time:当前视频播放的进度,单位为s。 |
onSeeked(callback:(event?: { time: number }) => void) | 操作进度条完成后,上报播放时间信息。 time:当前视频播放的进度,单位为s。 |
onUpdate(callback:(event?: { time: number }) => void) | 播放进度变化时触发该事件。 time:当前视频播放的进度,单位为s。 |
onFullscreenChange(callback:(event?: { fullscreen: boolean }) => void) | 在全屏播放与非全屏播放状态之间切换时触发该事件。 fullscreen:返回值为true表示进入全屏播放状态,为false则表示非全屏播放。 |
示例
@Entry
@Component
struct VideoIndex {
// 本地视频
@State videoSrc: Resource = $rawfile('we are.mp4')
// 在线视频
@State videoSrc2: string = "https://alist.webdq.top/p/store/mp4/we%20are.mp4?sign=_tS2RcvZPYe8BqloYtulXBAwcwaJupOfz439FUOFcQ4=:0"
// 本地音频
@State audioSrc: Resource = $rawfile('we are.mp3')
build() {
Row() {
Tabs() {
TabContent() {
Video({
src: this.videoSrc
})
.width('100%')
.aspectRatio(1.4)
}
.tabBar("本地视频")
TabContent() {
Column() {
Video({
src: this.videoSrc2
})
.width('100%')
.aspectRatio(1.4)
}
.width('100%')
}.tabBar("在线视频")
TabContent() {
Video({
src: this.audioSrc
})
.width('100%')
.aspectRatio(1.4)
}
.tabBar("音频")
}
.animationDuration(300)
}
.height('100%')
}
}
2. VideoController 控制器
一个VideoController对象可以控制一个或多个video,可用视频播放实例请参考media.createAVPlayer。
start
start(): void
开始播放。
pause
pause(): void
暂停播放,显示当前帧,再次播放时从当前位置继续播放。
stop
stop(): void
停止播放,显示当前帧,再次播放时从头开始播放。
setCurrentTime
setCurrentTime(value: number)
指定视频播放的进度位置。
参数:
参数名 | 参数类型 | 必填 | 参数描述 |
---|---|---|---|
value | number | 是 | 视频播放进度位置,单位为s。 |
requestFullscreen
requestFullscreen(value: boolean)
请求全屏播放。
参数:
参数名 | 参数类型 | 必填 | 参数描述 |
---|---|---|---|
value | boolean | 是 | 是否全屏(填充满应用窗口)播放。 |
exitFullscreen
exitFullscreen()
退出全屏播放。
setCurrentTime8+
setCurrentTime(value: number, seekMode: SeekMode)
指定视频播放的进度位置,并指定跳转模式。
参数:
参数名 | 参数类型 | 必填 | 参数描述 |
---|---|---|---|
value | number | 是 | 视频播放进度位置,单位为s。 |
seekMode | SeekMode | 是 | 跳转模式。 |
SeekMode8+枚举说明
名称 | 描述 |
---|---|
PreviousKeyframe | 跳转到前一个最近的关键帧。 |
NextKeyframe | 跳转到后一个最近的关键帧。 |
ClosestKeyframe | 跳转到最近的关键帧。 |
Accurate | 精准跳转,不论是否为关键帧。 |
3. 自定义控制器
使用 new VideoController 创建一个控制器实例
把 VideoController 实例传给 Video 组件
@Entry
@Component
struct Index {
controller: VideoController = new VideoController()
@State speed: number = 1
build() {
Column() {
Video({
src: $rawfile("we are.mp4"),
currentProgressRate: this.speed,
controller: this.controller
})
.width("100%")
.aspectRatio(1)
Row() {
Text(`播放速度:${this.speed}`)
}
Slider({
value: this.speed,
min: 0.75,
max: 2,
step: 0.25,
style: SliderStyle.InSet
})
.showSteps(true)
.onChange((value) => {
this.speed = value
})
Row() {
Button("开始").onClick(() => {
this.controller.start()
})
Button("暂停").onClick(() => {
this.controller.pause()
})
Button("跳转到第30秒").onClick(() => {
this.controller.setCurrentTime(30, SeekMode.Accurate) //单位秒
})
Button("结束").onClick(() => {
this.controller.stop()
})
}
}
.height('100%')
.width('100%')
}
}