W3Cschool
恭喜您成為首批注冊(cè)用戶
獲得88經(jīng)驗(yàn)值獎(jiǎng)勵(lì)
用于播放視頻文件并控制其播放狀態(tài)的組件。
該組件從API Version 7開(kāi)始支持。后續(xù)版本如有新增內(nèi)容,則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。
使用網(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 | 否 | 設(shè)置視頻控制器,可以控制視頻的播放狀態(tài)。 |
名稱 | 描述 |
---|---|
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 | 設(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則表示非全屏播放。 |
一個(gè)VideoController對(duì)象可以控制一個(gè)或多個(gè)video,可用視頻播放實(shí)例請(qǐng)參考media.createAVPlayer。
setCurrentTime(value: number)
指定視頻播放的進(jìn)度位置。
參數(shù):
參數(shù)名 | 參數(shù)類型 | 必填 | 參數(shù)描述 |
---|---|---|---|
value | number | 是 | 視頻播放進(jìn)度位置,單位為s。 |
requestFullscreen(value: boolean)
請(qǐng)求全屏播放。
參數(shù):
參數(shù)名 | 參數(shù)類型 | 必填 | 參數(shù)描述 |
---|---|---|---|
value | boolean | 是 | 是否全屏(填充滿應(yīng)用窗口)播放。 |
setCurrentTime(value: number, seekMode: SeekMode)
指定視頻播放的進(jìn)度位置,并指定跳轉(zhuǎn)模式。
參數(shù):
參數(shù)名 | 參數(shù)類型 | 必填 | 參數(shù)描述 |
---|---|---|---|
value | number | 是 | 視頻播放進(jìn)度位置,單位為s。 |
seekMode | SeekMode | 是 | 跳轉(zhuǎn)模式。 |
名稱 | 描述 |
---|---|
PreviousKeyframe | 跳轉(zhuǎn)到前一個(gè)最近的關(guān)鍵幀。 |
NextKeyframe | 跳轉(zhuǎn)到后一個(gè)最近的關(guān)鍵幀。 |
ClosestKeyframe | 跳轉(zhuǎn)到最近的關(guān)鍵幀。 |
Accurate | 精準(zhǔn)跳轉(zhuǎn),不論是否為關(guān)鍵幀。 |
- // 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) => {
- console.info('onPrepared is ' + e.duration)
- })
- .onSeeking((e) => {
- console.info('onSeeking is ' + e.time)
- })
- .onSeeked((e) => {
- console.info('onSeeked is ' + e.time)
- })
- .onUpdate((e) => {
- 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') // 切換視頻預(yù)覽海報(bào)
- }).margin(5)
- Button('controls').onClick(() => {
- this.showControls = !this.showControls // 切換是否顯示視頻控制欄
- }).margin(5)
- }
- Row() {
- Button('start').onClick(() => {
- this.controller.start() // 開(kāi)始播放
- }).margin(5)
- Button('pause').onClick(() => {
- this.controller.pause() // 暫停播放
- }).margin(5)
- Button('stop').onClick(() => {
- this.controller.stop() // 結(jié)束播放
- }).margin(5)
- Button('setTime').onClick(() => {
- this.controller.setCurrentTime(10, SeekMode.Accurate) // 精準(zhǔn)跳轉(zhuǎn)到視頻的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)
- }
- }
- }
- }
Copyright©2021 w3cschool編程獅|閩ICP備15016281號(hào)-3|閩公網(wǎng)安備35020302033924號(hào)
違法和不良信息舉報(bào)電話:173-0602-2364|舉報(bào)郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號(hào)
聯(lián)系方式:
更多建議: