【HarmonyOS-媒体技术-AVPlayer】音视频播放开发全攻略

// 1. 调用createAVPlayer()创建AVPlayer实例，初始化进入idle状态。
this.avPlayer = await media.createAVPlayer();
// 2. 设置业务需要的监听事件，搭配全流程场景使用。其中最关键的是AVPlayer状态变化：
this.avPlayer.on('stateChange', async (state, reason) => {
  if (this.avPlayer == null) {
    console.info(`${this.tag}: avPlayer has not init on state change`);
    return;
  }
  switch (state) {
    case 'idle': // 成功调用reset接口后触发该状态机上报
      console.info(`${this.tag}: setAVPlayerCallback AVPlayer state idle called.`);
      break;
    case 'initialized': // avplayer 设置播放源后触发该状态上报
      console.info(`${this.tag}: setAVPlayerCallback AVPlayer state initialized called.`);
      // 4.设置窗口：获取并设置属性SurfaceID，用于设置显示画面。可在收到initialized状态回调后设置,应用需要从XComponent组件获取surfaceID，获取方式请参考[XComponent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-xcomponent)
      if (this.surfaceId) {
        this.avPlayer.surfaceId = this.surfaceId; // 设置显示画面，当播放的资源为纯音频时无需设置
        console.info(`${this.tag}: setAVPlayerCallback this.avPlayer.surfaceId = ${this.avPlayer.surfaceId}`);
        // 5.准备播放：调用prepare()，AVPlayer进入prepared状态
        this.avPlayer.prepare();
      }
      break;
    case 'prepared': // prepare调用成功后上报该状态机
      console.info(`${this.tag}: setAVPlayerCallback AVPlayer state prepared called.`);
      // 6.视频播控：播放play()，暂停pause()，跳转seek()，停止stop() 等操作
      this.avPlayer.play(); // 调用播放接口开始播放
      break;
    case 'playing': // play成功调用后触发该状态机上报
      console.info(`${this.tag}: setAVPlayerCallback AVPlayer state playing called.`);
      break;
    case 'completed': // 播放结束后触发该状态机上报
      console.info(`${this.tag}: setAVPlayerCallback AVPlayer state completed called.`);
      break;
    case 'released':
      console.info(`${this.tag}: setAVPlayerCallback released called.`);
      break
    case 'stopped':
      console.info(`${this.tag}: setAVPlayerCallback AVPlayer state stopped called.`);
      break
    case 'error':
      console.error(`${this.tag}: setAVPlayerCallback AVPlayer state error called.`);
      // 7.（可选）更换资源：调用reset()重置资源，AVPlayer重新进入idle状态，允许更换资源url。
      this.avPlayer.reset();
      break
    case 'paused':
      console.info(`${this.tag}: setAVPlayerCallback AVPlayer state paused called.`);
      break
    default:
      console.info(`${this.tag}: setAVPlayerCallback AVPlayer state unknown called.`);
      break;
  }
});
// 3. 设置资源：设置属性url，AVPlayer进入initialized状态。
this.avPlayer.url = "xxx";

// 1.创建AVPlayer实例：调用OH_AVPlayer_Create()，AVPlayer初始化为AV_IDLE状态。
OH_AVPlayer *player = OH_AVPlayer_Create();
// 2.设置回调监听函数
OHAVPlayerOnInfoCallback(OH_AVPlayer *player, AVPlayerOnInfoType type, OH_AVFormat *infoBody, void *userData) {
  AVPlayerState avState = AV_IDLE;
  switch (type) {
    case AV_INFO_TYPE_STATE_CHANGE:
      LOG("AVPlayerOnInfoType AV_INFO_TYPE_STATE_CHANGE");
      OH_AVFormat_GetIntValue(infoBody, OH_PLAYER_STATE, &state);
  OH_AVFormat_GetIntValue(infoBody, OH_PLAYER_STATE_CHANGE_REASON, &stateChangeReason);
  LOG("OHAVPlayerOnInfoCallback AV_INFO_TYPE_STATE_CHANGE  state: %{public}d ,stateChangeReason: %{public}d",
  state, stateChangeReason);
  avState = static_cast<AVPlayerState>(state);
  switch (avState) {
    case AV_IDLE: // 成功调用reset接口后触发该状态机上报
      LOG("AVPlayerState  AV_IDLE");
      break;
    case AV_INITIALIZED: {
      LOG("AVPlayerState  AV_INITIALIZED");
      auto context = SampleManager::GetInstance();
      // 4.设置播放画面窗口：调用OH_AVPlayer_SetVideoSurface()设置播放画面窗口。此函数必须在SetSource之后，Prepare之前调用。
      ret = OH_AVPlayer_SetVideoSurface(player, context->nativeWindow_);
      LOG("OH_AVPlayer_SetVideoSurface ret:%{public}d", ret);
      // 5.准备播放：调用OH_AVPlayer_Prepare()，AVPlayer进入AV_PREPARED状态，此时可以获取时长，设置音量。
      ret = OH_AVPlayer_Prepare(player); // 设置播放源后触发该状态上报
      if (ret != AV_ERR_OK) {
        // 处理异常
        LOG("player  %{public}s", "OH_AVPlayer_Prepare Err");
      }
    } break;
    case AV_PREPARED:
      LOG("AVPlayerState AV_PREPARED");
      ret = OH_AVPlayer_SetAudioEffectMode(player, EFFECT_NONE); // 设置音频音效模式
      LOG("OH_AVPlayer_SetAudioEffectMode ret:%{public}d", ret);
      // 6.视频播控：播放OH_AVPlayer_Play()，暂停OH_AVPlayer_Pause()，跳转OH_AVPlayer_Seek()，停止OH_AVPlayer_Stop()等操作。
      ret = OH_AVPlayer_Play(player); // 调用播放接口开始播放
      LOG("OH_AVPlayer_Play ret:%{public}d", ret);
      break;
    case AV_PLAYING:
      LOG("AVPlayerState AV_PLAYING");
      break;
    case AV_PAUSED:
      LOG("AVPlayerState AV_PAUSED");
      break;
    case AV_STOPPED:
      LOG("AVPlayerState AV_STOPPED");
      break;
    case AV_COMPLETED:
      LOG("AVPlayerState AV_COMPLETED");
      break;
    case AV_ERROR:
      LOG("AVPlayerState AV_ERROR");
      break;
    case AV_RELEASED:
      LOG("AVPlayerState AV_RELEASED");
      break;
    default:
      break;
  }
}
// 3.设置资源：调用OH_AVPlayer_SetURLSource()，设置属性url，AVPlayer进入AV_INITIALIZED状态。
OH_AVPlayer_SetURLSource(player, url);