实现音视频播放功能鸿蒙示例代码

鸿蒙场景化示例代码技术工程师

发布于 2025-3-19 10:55

浏览

0收藏

本文原创发布在华为开发者社区。

介绍

本示例基于Avplayer构建了一个音视频播放器，包括音视频的播放、暂停、全屏播放、倍速播放、快进等基本操作。

实现音视频播放功能源码链接

效果预览

实现音视频播放功能鸿蒙示例代码-鸿蒙开发者社区

使用说明

打开应用，展示视频播放器，选择不同按钮进行不同操作。
切换音频，展示音频播放器，选择不同按钮进行不同操作。

实现思路

AVPlayer播放主流程

播放的全流程包含：创建AVPlayer，设置播放资源，设置播放参数（音量/倍速），播放控制（播放/暂停/上一个视频/下一个视频），重置，销毁资源。

createAVPlayer() {
  media.createAVPlayer().then((video: media.AVPlayer) => {
    if (video != null) {
      this.avPlayer = video;
      this.setAVPlayerCallback(this.avPlayer);
      if (this.avPlayer && this.sourceFiles.length > this.currentIndex) {
        this.avPlayer.fdSrc = this.sourceFiles[this.currentIndex];
      }
    } 
  }
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

视频播放之前需要初始化XComponent组件用于展示视频画面。XComponent组件初始化成功之后在onLoad()中获取surfaceID用于与AVPlayer实例关联。

.onLoad(() => {
  this.xComponentController.setXComponentSurfaceRect({
    surfaceWidth: 1920,
    surfaceHeight: 1080
  });
  this.surfaceID = this.xComponentController.getXComponentSurfaceId();
})
1.
2.
3.
4.
5.
6.
7.

使用AVPlayer前需要通过createAVPlayer()构建一个实例对象，并为AVPlayer实例绑定状态机，状态机具体请参考AVPlayerState。

  createAVPlayer() {
    media.createAVPlayer().then((video: media.AVPlayer) => {
      if (video != null) {
        this.avPlayer = video;
        this.setAVPlayerCallback(this.avPlayer);
        if (this.avPlayer && this.sourceFiles.length > this.currentIndex) {
          this.avPlayer.fdSrc = this.sourceFiles[this.currentIndex];
        }
      } 
  })
  }
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

AVPlayer实例需设置播放路径（本地资源使用fd、offset、length构建media.AVFileDescriptor对象对AVPlayer.fdSrc属性赋值或使用fd://${fd}格式对AVPlayer.url属性赋值，网络资源可直接使用网络地址对AVPlayer.url属性赋值）和XComponent中获取的surfaceID，设置播放路径之后AVPlayer状态机变为initialized状态，在此状态下调用prepare()，进入prepared状态。

case 'initialized': 
  logger.info('AVPlayerDemo AVPlayer state initialized called.');
  this.reset()
  if (this.isVideo) {
    avPlayer.surfaceId = this.surfaceID;
  }
  avPlayer.prepare();
  break;
1.
2.
3.
4.
5.
6.
7.
8.

在prepared状态下可获取当前播放路径对应视频的总时长，并执行play()进行视频播放。
视频播放后，变为playing状态，可通过“播放/暂停”按钮切换播放状态，当视频暂停时状态机变为paused状态。
视频播放完成之后，进入completed状态，需调用reset()对视频进行重置，此时变为idle转态，在idle状态下设置下一个视频的播放地址，又会进入initialized状态。
播放网络视频需要声明ohos.permission.INTERNET权限

使用pipWindow实现画中画

初始化：使用pipWindow.create(PiPConfiguration)初始化PiPController画中画控制器，可在PiPConfiguration设置对应的XComponent控制器、点击画中画返回应用的navigationId、画中画类型（视频播放VIDEO_PLAY、视频电话VIDEO_CALL、视频会议VIDEO_MEETING、视频直播VIDEO_LIVE）、画中画宽高。

pipWindow.create(config).then((data: pipWindow.PiPController) => {
  logger.info(`AVPlayerDemo Succeeded in creating pip controller. Data:${data}`);
  this.pipController = data;
  this.setPipWindowCallback(data)
})
1.
2.
3.
4.
5.

设置回调：初始化完成后，可在回调中设置相关监听处理，来处理小屏播放时播放控制。
启动画中画：调用pipController.startPiP()可以开启画中画，在开启前可以设置返回桌面时是否自动启动画中画pipController.setAutoStartEnabled(true/false)。

  startPipWindow() {
    if (this.pipController) {
      this.pipController.setAutoStartEnabled(true)
      this.pipController.startPiP().then(() => {
        ···
      });
    }
  }
1.
2.
3.
4.
5.
6.
7.
8.

停止画中画：调用pipController.stopPiP()可以停止画中画。

  stopPipWindow() {
    if (this.pipController) {
      this.pipController.stopPiP().then(() => {
        logger.info(`AVPlayerDemo Succeeded in stop pip.`);
      }).catch((err: BusinessError) => {
        logger.error(`AVPlayerDemo Failed to stop pip. Cause:${err.code}, message:${err.message}`);
      });
    }
  }
1.
2.
3.
4.
5.
6.
7.
8.
9.

使用AVSession接入播控中心

初始化：使用avSession.createAVSession(context: Context, tag: string, type: AVSessionType): Promise<AVSession>创建媒体会话，可以通过第三个参数设置媒体会话类型：视频video、音频audio。

  async createAVSession() {
    let type: avSession.AVSessionType = this.isVideo ? 'video' : 'audio';
    await avSession.createAVSession(getContext(this), 'AVPlayerDemo', type).then((data: avSession.AVSession) => {
      logger.info(`AVPlayerDemo CreateAVSession : SUCCESS : sessionId = ${data.sessionId}`);
      this.currentAVSession = data;
      this.curSessionId = data.sessionId;
      this.setAVSessionCallback(data);
    })
    }
1.
2.
3.
4.
5.
6.
7.
8.
9.

设置回调：创建完媒体会话后，可以设置回调事件，监听播控中心播放、暂停、停止、上一个、下一个、快进、快退等播控事件，可以在这些回调中触发avplyer实例来实现对应功能。
设置元数据：通过setAVMetadata(data: AVMetadata): Promise<void>方法为媒体会话设置元数据，主要设置当前媒体源ID、标题、时长、上一个媒体源ID、下一个媒体源ID、展示图片等，其中媒体源ID是媒体的唯一标识，由业务自定义。

  async startAVSession() {
    if (!this.currentAVSession) {
      logger.error('AVPlayerDemo currentAVSession is undefined.')
      return;
    }
    let metadata: avSession.AVMetadata = this.generateAVMetadata();
    await this.currentAVSession.setAVMetadata(metadata).then(() => {
      ···
    });
  }
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.

设置播放状态：通过setAVPlaybackState(state: AVPlaybackState): Promise<void>设置播放状态、当前播放进度、播放速率、循环模式、媒体音量等。

 this.currentAVSession.setAVPlaybackState()
1.

激活媒体会话：通过activate(): Promise<void>可激活媒体会话，激活后可以在播控中心看到设置的元数据。

    await this.currentAVSession.activate().then(() => {
      logger.info(`AVPlayerDemo Activate : SUCCESS `);
    })
1.
2.
3.

进度展示：在avplayer的timeUpdate回调事件中，可以通过setAVPlaybackState(state: AVPlaybackState): Promise<void>实时更新当前媒体源的播放进度。
状态同步：在avplayer的stateChange回调事件中，可以通过setAVPlaybackState(state: AVPlaybackState): Promise<void>实时同步当前媒体源的播放状态。
后台播放：如果想实现应用切换后台后，播控中心仍能控制媒体播放，需要申请audioPlayback的长时任务，声明ohos.permission.KEEP_BACKGROUND_RUNNING权限

分类

标签