視頻

2024-01-22 18:01 更新

用于播放視頻文件并控制其播放狀態(tài)的組件。

說(shuō)明

該組件從API Version 7開(kāi)始支持。后續(xù)版本如有新增內(nèi)容,則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。

權(quán)限列表

使用網(wǎng)絡(luò)視頻時(shí),需要申請(qǐng)權(quán)限ohos.permission.INTERNET。具體申請(qǐng)方式請(qǐng)參考權(quán)限申請(qǐng)聲明。

子組件

不支持子組件。

接口

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

參數(shù):

參數(shù)名

參數(shù)類型

必填

參數(shù)描述

src

string | Resource

視頻播放源的路徑,支持本地視頻路徑和網(wǎng)絡(luò)路徑。

支持在resources下面的video或rawfile文件夾里放置媒體資源。

支持dataability://的路徑前綴,用于訪問(wèn)通過(guò)Data Ability提供的視頻路徑,具體路徑信息詳見(jiàn)DataAbility說(shuō)明。

支持file:///data/storage路徑前綴的字符串,用于讀取應(yīng)用沙箱路徑內(nèi)的資源。需要保證目錄包路徑下的文件有可讀權(quán)限。

說(shuō)明:

視頻支持的格式是:mp4、mkv、webm、TS。

currentProgressRate

number | string | PlaybackSpeed8+

視頻播放倍速。

說(shuō)明:

number取值僅支持:0.75,1.0,1.25,1.75,2.0。

默認(rèn)值:1.0 | PlaybackSpeed.Speed_Forward_1_00_X

previewUri

string | PixelMap8+ | Resource

視頻未播放時(shí)的預(yù)覽圖片路徑,默認(rèn)不顯示圖片。

controller

VideoController

設(shè)置視頻控制器,可以控制視頻的播放狀態(tài)。

PlaybackSpeed8+枚舉說(shuō)明

名稱

描述

Speed_Forward_0_75_X

0.75倍速播放。

Speed_Forward_1_00_X

1倍速播放。

Speed_Forward_1_25_X

1.25倍速播放。

Speed_Forward_1_75_X

1.75倍速播放。

Speed_Forward_2_00_X

2倍速播放。

屬性

除支持通用屬性外,還支持以下屬性:

名稱

參數(shù)類型

描述

muted

boolean

是否靜音。

默認(rèn)值:false

autoPlay

boolean

是否自動(dòng)播放。

默認(rèn)值:false

controls

boolean

控制視頻播放的控制欄是否顯示。

默認(rèn)值:true

objectFit

ImageFit

設(shè)置視頻顯示模式。

默認(rèn)值:Cover

loop

boolean

是否單個(gè)視頻循環(huán)播放。

默認(rèn)值:false

事件

除支持通用事件外,還支持以下事件:

名稱

功能描述

onStart(event:() => void)

播放時(shí)觸發(fā)該事件。

onPause(event:() => void)

暫停時(shí)觸發(fā)該事件。

onFinish(event:() => void)

播放結(jié)束時(shí)觸發(fā)該事件。

onError(event:() => void)

播放失敗時(shí)觸發(fā)該事件。

onPrepared(callback:(event?: { duration: number }) => void)

視頻準(zhǔn)備完成時(shí)觸發(fā)該事件。

duration:當(dāng)前視頻的時(shí)長(zhǎng),單位為秒(s)。

onSeeking(callback:(event?: { time: number }) => void)

操作進(jìn)度條過(guò)程時(shí)上報(bào)時(shí)間信息。

time:當(dāng)前視頻播放的進(jìn)度,單位為s。

onSeeked(callback:(event?: { time: number }) => void)

操作進(jìn)度條完成后,上報(bào)播放時(shí)間信息。

time:當(dāng)前視頻播放的進(jìn)度,單位為s。

onUpdate(callback:(event?: { time: number }) => void)

播放進(jìn)度變化時(shí)觸發(fā)該事件。

time:當(dāng)前視頻播放的進(jìn)度,單位為s。

onFullscreenChange(callback:(event?: { fullscreen: boolean }) => void)

在全屏播放與非全屏播放狀態(tài)之間切換時(shí)觸發(fā)該事件。

fullscreen:返回值為true表示進(jìn)入全屏播放狀態(tài),為false則表示非全屏播放。

VideoController

一個(gè)VideoController對(duì)象可以控制一個(gè)或多個(gè)video,可用視頻播放實(shí)例請(qǐng)參考media.createAVPlayer。

導(dǎo)入對(duì)象

  1. controller: VideoController = new VideoController()

start

start(): void

開(kāi)始播放。

pause

pause(): void

暫停播放,顯示當(dāng)前幀,再次播放時(shí)從當(dāng)前位置繼續(xù)播放。

stop

stop(): void

停止播放,顯示當(dāng)前幀,再次播放時(shí)從頭開(kāi)始播放。

setCurrentTime

setCurrentTime(value: number)

指定視頻播放的進(jìn)度位置。

參數(shù):

參數(shù)名

參數(shù)類型

必填

參數(shù)描述

value

number

視頻播放進(jìn)度位置,單位為s。

requestFullscreen

requestFullscreen(value: boolean)

請(qǐng)求全屏播放。

參數(shù):

參數(shù)名

參數(shù)類型

必填

參數(shù)描述

value

boolean

是否全屏(填充滿應(yīng)用窗口)播放。

exitFullscreen

exitFullscreen()

退出全屏播放。

setCurrentTime8+

setCurrentTime(value: number, seekMode: SeekMode)

指定視頻播放的進(jìn)度位置,并指定跳轉(zhuǎn)模式。

參數(shù):

參數(shù)名

參數(shù)類型

必填

參數(shù)描述

value

number

視頻播放進(jìn)度位置,單位為s。

seekMode

SeekMode

跳轉(zhuǎn)模式。

SeekMode8+枚舉說(shuō)明

名稱

描述

PreviousKeyframe

跳轉(zhuǎn)到前一個(gè)最近的關(guān)鍵幀。

NextKeyframe

跳轉(zhuǎn)到后一個(gè)最近的關(guān)鍵幀。

ClosestKeyframe

跳轉(zhuǎn)到最近的關(guān)鍵幀。

Accurate

精準(zhǔn)跳轉(zhuǎn),不論是否為關(guān)鍵幀。

示例

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct VideoCreateComponent {
  5. @State videoSrc: Resource = $rawfile('video1.mp4')
  6. @State previewUri: Resource = $r('app.media.poster1')
  7. @State curRate: PlaybackSpeed = PlaybackSpeed.Speed_Forward_1_00_X
  8. @State isAutoPlay: boolean = false
  9. @State showControls: boolean = true
  10. controller: VideoController = new VideoController()
  11. build() {
  12. Column() {
  13. Video({
  14. src: this.videoSrc,
  15. previewUri: this.previewUri,
  16. currentProgressRate: this.curRate,
  17. controller: this.controller
  18. }).width('100%').height(600)
  19. .autoPlay(this.isAutoPlay)
  20. .controls(this.showControls)
  21. .onStart(() => {
  22. console.info('onStart')
  23. })
  24. .onPause(() => {
  25. console.info('onPause')
  26. })
  27. .onFinish(() => {
  28. console.info('onFinish')
  29. })
  30. .onError(() => {
  31. console.info('onError')
  32. })
  33. .onPrepared((e) => {
  34. console.info('onPrepared is ' + e.duration)
  35. })
  36. .onSeeking((e) => {
  37. console.info('onSeeking is ' + e.time)
  38. })
  39. .onSeeked((e) => {
  40. console.info('onSeeked is ' + e.time)
  41. })
  42. .onUpdate((e) => {
  43. console.info('onUpdate is ' + e.time)
  44. })
  45. Row() {
  46. Button('src').onClick(() => {
  47. this.videoSrc = $rawfile('video2.mp4') // 切換視頻源
  48. }).margin(5)
  49. Button('previewUri').onClick(() => {
  50. this.previewUri = $r('app.media.poster2') // 切換視頻預(yù)覽海報(bào)
  51. }).margin(5)
  52. Button('controls').onClick(() => {
  53. this.showControls = !this.showControls // 切換是否顯示視頻控制欄
  54. }).margin(5)
  55. }
  56. Row() {
  57. Button('start').onClick(() => {
  58. this.controller.start() // 開(kāi)始播放
  59. }).margin(5)
  60. Button('pause').onClick(() => {
  61. this.controller.pause() // 暫停播放
  62. }).margin(5)
  63. Button('stop').onClick(() => {
  64. this.controller.stop() // 結(jié)束播放
  65. }).margin(5)
  66. Button('setTime').onClick(() => {
  67. this.controller.setCurrentTime(10, SeekMode.Accurate) // 精準(zhǔn)跳轉(zhuǎn)到視頻的10s位置
  68. }).margin(5)
  69. }
  70. Row() {
  71. Button('rate 0.75').onClick(() => {
  72. this.curRate = PlaybackSpeed.Speed_Forward_0_75_X // 0.75倍速播放
  73. }).margin(5)
  74. Button('rate 1').onClick(() => {
  75. this.curRate = PlaybackSpeed.Speed_Forward_1_00_X // 原倍速播放
  76. }).margin(5)
  77. Button('rate 2').onClick(() => {
  78. this.curRate = PlaybackSpeed.Speed_Forward_2_00_X // 2倍速播放
  79. }).margin(5)
  80. }
  81. }
  82. }
  83. }
以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)