Video

用于播放視頻文件并控制其播放狀態的組件。

說明：

該組件從API Version 7開始支持。后續版本如有新增內容，則采用上角標單獨標記該內容的起始版本。

權限列表

使用網絡視頻時，需要申請權限ohos.permission.INTERNET。具體申請方式請參考[權限申請聲明]。

子組件

不支持子組件。

接口

Video(value: {src?: string | Resource, currentProgressRate?: number | string | PlaybackSpeed, previewUri?: string | PixelMap | Resource, controller?: VideoController})

參數：

PlaybackSpeed8+枚舉說明

屬性

除支持[通用屬性]外，還支持以下屬性：

事件

除支持[通用事件]外，還支持以下事件：

VideoController

一個VideoController對象可以控制一個或多個video，可用視頻播放實例請參考[@ohos.multimedia.media])。

導入對象

let controller: VideoController = new VideoController()

start

start(): void

開始播放。

pause

pause(): void

暫停播放，顯示當前幀，再次播放時從當前位置繼續播放。

stop

stop(): void

停止播放，顯示當前幀，再次播放時從頭開始播放。

setCurrentTime

setCurrentTime(value: number)

指定視頻播放的進度位置。

參數：

requestFullscreen

requestFullscreen(value: boolean)

請求全屏播放。

參數：

exitFullscreen

exitFullscreen()

退出全屏播放。

setCurrentTime8+

setCurrentTime(value: number, seekMode: SeekMode)

指定視頻播放的進度位置，并指定跳轉模式。

參數：

SeekMode8+枚舉說明

示例

// xxx.ets
@Entry
@Component
struct VideoCreateComponent {
  @State videoSrc: Resource = $rawfile('video1.mp4')
  @State previewUri: Resource = $r('app.media.poster1')
  @State curRate: PlaybackSpeed = PlaybackSpeed.Speed_Forward_1_00_X
  @State isAutoPlay: boolean = false
  @State showControls: boolean = true
  controller: VideoController = new VideoController()

  build() {
    Column() {
      Video({
        src: this.videoSrc,
        previewUri: this.previewUri,
        currentProgressRate: this.curRate,
        controller: this.controller
      })
        .width('100%')
        .height(600)
        .autoPlay(this.isAutoPlay)
        .controls(this.showControls)
        .onStart(() = > {
          console.info('onStart')
        })
        .onPause(() = > {
          console.info('onPause')
        })
        .onFinish(() = > {
          console.info('onFinish')
        })
        .onError(() = > {
          console.info('onError')
        })
        .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)
          }
        })

      Row() {
        Button('src').onClick(() = > {
          this.videoSrc = $rawfile('video2.mp4') // 切換視頻源
        }).margin(5)
        Button('previewUri').onClick(() = > {
          this.previewUri = $r('app.media.poster2') // 切換視頻預覽海報
        }).margin(5)
        Button('controls').onClick(() = > {
          this.showControls = !this.showControls // 切換是否顯示視頻控制欄
        }).margin(5)
      }

      Row() {
        Button('start').onClick(() = > {
          this.controller.start() // 開始播放
        }).margin(5)
        Button('pause').onClick(() = > {
          this.controller.pause() // 暫停播放
        }).margin(5)
        Button('stop').onClick(() = > {
          this.controller.stop() // 結束播放
        }).margin(5)
        Button('setTime').onClick(() = > {
          this.controller.setCurrentTime(10, SeekMode.Accurate) // 精準跳轉到視頻的10s位置
        }).margin(5)
      }

      Row() {
        Button('rate 0.75').onClick(() = > {
          this.curRate = PlaybackSpeed.Speed_Forward_0_75_X // 0.75倍速播放
        }).margin(5)
        Button('rate 1').onClick(() = > {
          this.curRate = PlaybackSpeed.Speed_Forward_1_00_X // 原倍速播放
        }).margin(5)
        Button('rate 2').onClick(() = > {
          this.curRate = PlaybackSpeed.Speed_Forward_2_00_X // 2倍速播放
        }).margin(5)
      }
    }
  }
}

interface DurationObject {
  duration: number;
}

interface TimeObject {
  time: number;
}

審核編輯 黃宇