【鸿蒙开发】视频播放

发布于:2024-04-17 ⋅ 阅读:(36) ⋅ 点赞:(0)

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

VideoController

设置视频控制器,可以控制视频的播放状态。

属性:

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

名称

参数类型

描述

muted

boolean

是否静音。

默认值:false

autoPlay

boolean

是否自动播放。

默认值:false

controls

boolean

控制视频播放的控制栏是否显示。

默认值:true

objectFit

ImageFit

设置视频显示模式。

默认值: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%')
  }
}