視頻播放

開發(fā)指導

播放的全流程包含：創(chuàng)建AVPlayer，設(shè)置播放資源和窗口，設(shè)置播放參數(shù)（音量/倍速/縮放模式），播放控制（播放/暫停/跳轉(zhuǎn)/停止），重置，銷毀資源。在進行應用開發(fā)的過程中，開發(fā)者可以通過AVPlayer的state屬性主動獲取當前狀態(tài)或使用on('stateChange')方法監(jiān)聽狀態(tài)變化。如果應用在視頻播放器處于錯誤狀態(tài)時執(zhí)行操作，系統(tǒng)可能會拋出異常或生成其他未定義的行為。

狀態(tài)的詳細說明請參考AVPlayerState。當播放處于prepared / playing / paused / completed狀態(tài)時，播放引擎處于工作狀態(tài)，這需要占用系統(tǒng)較多的運行內(nèi)存。當客戶端暫時不使用播放器時，調(diào)用reset()或release()回收內(nèi)存資源，做好資源利用。

開發(fā)步驟及注意事項

詳細的API說明請參考AVPlayer API參考。

1. 創(chuàng)建實例createAVPlayer()，AVPlayer初始化idle狀態(tài)。
2. 設(shè)置業(yè)務需要的監(jiān)聽事件，搭配全流程場景使用。支持的監(jiān)聽事件包括：

   事件類型	說明
   stateChange	必要事件，監(jiān)聽播放器的state屬性改變。
   error	必要事件，監(jiān)聽播放器的錯誤信息。
   durationUpdate	用于進度條，監(jiān)聽進度條長度，刷新資源時長。
   timeUpdate	用于進度條，監(jiān)聽進度條當前位置，刷新當前時間。
   seekDone	響應API調(diào)用，監(jiān)聽seek()請求完成情況。 當使用seek()跳轉(zhuǎn)到指定播放位置后，如果seek操作成功，將上報該事件。
   speedDone	響應API調(diào)用，監(jiān)聽setSpeed()請求完成情況。 當使用setSpeed()設(shè)置播放倍速后，如果setSpeed操作成功，將上報該事件。
   volumeChange	響應API調(diào)用，監(jiān)聽setVolume()請求完成情況。 當使用setVolume()調(diào)節(jié)播放音量后，如果setVolume操作成功，將上報該事件。
   bitrateDone	響應API調(diào)用，用于HLS協(xié)議流，監(jiān)聽setBitrate()請求完成情況。 當使用setBitrate()指定播放比特率后，如果setBitrate操作成功，將上報該事件。
   availableBitrates	用于HLS協(xié)議流，監(jiān)聽HLS資源的可選bitrates，用于setBitrate()。
   bufferingUpdate	用于網(wǎng)絡播放，監(jiān)聽網(wǎng)絡播放緩沖信息。
   startRenderFrame	用于視頻播放，監(jiān)聽視頻播放首幀渲染時間。
   videoSizeChange	用于視頻播放，監(jiān)聽視頻播放的寬高信息，可用于調(diào)整窗口大小、比例。
   audioInterrupt	監(jiān)聽音頻焦點切換信息，搭配屬性audioInterruptMode使用。 如果當前設(shè)備存在多個媒體正在播放，音頻焦點被切換（即播放其他媒體如通話等）時將上報該事件，應用可以及時處理。

3. 設(shè)置資源：設(shè)置屬性url，AVPlayer進入initialized狀態(tài)。
   說明

   下面代碼示例中的url僅作示意使用，開發(fā)者需根據(jù)實際情況，確認資源有效性并設(shè)置：

   • 如果使用本地資源播放，必須確認資源文件可用，并使用應用沙箱路徑訪問對應資源，參考獲取應用文件路徑。應用沙箱的介紹及如何向應用沙箱推送文件，請參考文件管理。
   • 如果使用網(wǎng)絡播放路徑，需申請相關(guān)權(quán)限：ohos.permission.INTERNET。
   • 如果使用ResourceManager.getRawFd打開HAP資源文件描述符，使用方法可參考ResourceManager API參考。
   • 需要使用支持的播放格式與協(xié)議。
4. 設(shè)置窗口：獲取并設(shè)置屬性SurfaceID，用于設(shè)置顯示畫面。

   應用需要從XComponent組件獲取surfaceID，獲取方式請參考XComponent。

5. 準備播放：調(diào)用prepare()，AVPlayer進入prepared狀態(tài)，此時可以獲取duration，設(shè)置縮放模式、音量等。
6. 視頻播控：播放play()，暫停pause()，跳轉(zhuǎn)seek()，停止stop() 等操作。
7. （可選）更換資源：調(diào)用reset()重置資源，AVPlayer重新進入idle狀態(tài)，允許更換資源url。
8. 退出播放：調(diào)用release()銷毀實例，AVPlayer進入released狀態(tài)，退出播放。

完整示例

import media from '@ohos.multimedia.media';
import fs from '@ohos.file.fs';
import common from '@ohos.app.ability.common';

export class AVPlayerDemo {
  private avPlayer;
  private count: number = 0;
  private surfaceID: string; // surfaceID用于播放畫面顯示，具體的值需要通過Xcomponent接口獲取，相關(guān)文檔鏈接見上面Xcomponent創(chuàng)建方法

  // 注冊avplayer回調(diào)函數(shù)
  setAVPlayerCallback() {
    // seek操作結(jié)果回調(diào)函數(shù)
    this.avPlayer.on('seekDone', (seekDoneTime) => {
      console.info(`AVPlayer seek succeeded, seek time is ${seekDoneTime}`);
    })
    // error回調(diào)監(jiān)聽函數(shù),當avPlayer在操作過程中出現(xiàn)錯誤時調(diào)用reset接口觸發(fā)重置流程
    this.avPlayer.on('error', (err) => {
      console.error(`Invoke avPlayer failed, code is ${err.code}, message is ${err.message}`);
      this.avPlayer.reset(); // 調(diào)用reset重置資源，觸發(fā)idle狀態(tài)
    })
    // 狀態(tài)機變化回調(diào)函數(shù)
    this.avPlayer.on('stateChange', async (state, reason) => {
      switch (state) {
        case 'idle': // 成功調(diào)用reset接口后觸發(fā)該狀態(tài)機上報
          console.info('AVPlayer state idle called.');
          this.avPlayer.release(); // 調(diào)用release接口銷毀實例對象
          break;
        case 'initialized': // avplayer 設(shè)置播放源后觸發(fā)該狀態(tài)上報
          console.info('AVPlayerstate initialized called.');
          this.avPlayer.surfaceId = this.surfaceID; // 設(shè)置顯示畫面，當播放的資源為純音頻時無需設(shè)置
          this.avPlayer.prepare().then(() => {
            console.info('AVPlayer prepare succeeded.');
          }, (err) => {
            console.error(`Invoke prepare failed, code is ${err.code}, message is ${err.message}`);
          });
          break;
        case 'prepared': // prepare調(diào)用成功后上報該狀態(tài)機
          console.info('AVPlayer state prepared called.');
          this.avPlayer.play(); // 調(diào)用播放接口開始播放
          break;
        case 'playing': // play成功調(diào)用后觸發(fā)該狀態(tài)機上報
          console.info('AVPlayer state playing called.');
          if (this.count !== 0) {
            console.info('AVPlayer start to seek.');
            this.avPlayer.seek(this.avPlayer.duration); //seek到視頻末尾
          } else {
            this.avPlayer.pause(); // 調(diào)用暫停接口暫停播放
          }
          this.count++;
          break;
        case 'paused': // pause成功調(diào)用后觸發(fā)該狀態(tài)機上報
          console.info('AVPlayer state paused called.');
          this.avPlayer.play(); // 再次播放接口開始播放
          break;
        case 'completed': // 播放結(jié)束后觸發(fā)該狀態(tài)機上報
          console.info('AVPlayer state completed called.');
          this.avPlayer.stop(); //調(diào)用播放結(jié)束接口
          break;
        case 'stopped': // stop接口成功調(diào)用后觸發(fā)該狀態(tài)機上報
          console.info('AVPlayer state stopped called.');
          this.avPlayer.reset(); // 調(diào)用reset接口初始化avplayer狀態(tài)
          break;
        case 'released':
          console.info('AVPlayer state released called.');
          break;
        default:
          console.info('AVPlayer state unknown called.');
          break;
      }
    })
  }

  // 以下demo為使用fs文件系統(tǒng)打開沙箱地址獲取媒體文件地址并通過url屬性進行播放示例
  async avPlayerUrlDemo() {
    // 創(chuàng)建avPlayer實例對象
    this.avPlayer = await media.createAVPlayer();
    // 創(chuàng)建狀態(tài)機變化回調(diào)函數(shù)
    this.setAVPlayerCallback();
    let fdPath = 'fd://';
    let context = getContext(this) as common.UIAbilityContext;
    // 通過UIAbilityContext獲取沙箱地址filesDir，以下為Stage模型獲方式，如需在FA模型上獲取請參考《訪問應用沙箱》獲取地址
    let pathDir = context.filesDir;
    let path = pathDir  + '/H264_AAC.mp4'; 
    // 打開相應的資源文件地址獲取fd，并為url賦值觸發(fā)initialized狀態(tài)機上報
    let file = await fs.open(path);
    fdPath = fdPath + '' + file.fd;
    this.avPlayer.url = fdPath;
  }

  // 以下demo為使用資源管理接口獲取打包在HAP內(nèi)的媒體資源文件并通過fdSrc屬性進行播放示例
  async avPlayerFdSrcDemo() {
    // 創(chuàng)建avPlayer實例對象
    this.avPlayer = await media.createAVPlayer();
    // 創(chuàng)建狀態(tài)機變化回調(diào)函數(shù)
    this.setAVPlayerCallback();
    // 通過UIAbilityContext的resourceManager成員的getRawFd接口獲取媒體資源播放地址
    // 返回類型為{fd,offset,length},fd為HAP包fd地址，offset為媒體資源偏移量，length為播放長度
    let context = getContext(this) as common.UIAbilityContext;
    let fileDescriptor = await context.resourceManager.getRawFd('H264_AAC.mp4');
    // 為fdSrc賦值觸發(fā)initialized狀態(tài)機上報
    this.avPlayer.fdSrc = fileDescriptor;
  }
}