鸿蒙-AVPlayer

compileVersion 5.0.2（14）

音频播放

import media from '@ohos.multimedia.media';
import common from '@ohos.app.ability.common';
import { BusinessError } from '@ohos.base';

@Entry
@Component
struct AudioPlayer {
  private avPlayer: media.AVPlayer | null = null;
  @State isPlaying: boolean = false;
  @State playProgress: number = 0;
  private timerId: number | null = null; // 存储定时器ID
  private readonly audioPath: string = 'qingtian.mp3';

  //页面初始化
  aboutToAppear() {
    this.initAudioPlayer();
  }

  //页面销毁
  aboutToDisappear(): void {
    this.releasePlayer();
  }

  // 修改为异步函数
  private async initAudioPlayer() {
    console.log('initAudioPlayer=====');
    const context = getContext(this) as common.UIAbilityContext;
    const resourceManager = context.resourceManager;

    try {
      // 添加await处理Promise
      const fdObj = await resourceManager.getRawFd(this.audioPath);
      const avFileDescriptor: media.AVFileDescriptor = {
        fd: fdObj.fd,
        offset: fdObj.offset, // 已正确处理offset属性
        length: fdObj.length
      };

      media.createAVPlayer((err: BusinessError, player: media.AVPlayer) => {
        if (err) {
          console.error('创建播放器失败: ' + JSON.stringify(err));
          return;
        }
        console.info('创建播放器success');
        this.avPlayer = player;
        this.setupPlayerEvents();
        this.avPlayer.fdSrc = avFileDescriptor;
      });
    } catch (error) {
      console.error('文件加载失败: ' + JSON.stringify(error));
    }
  }

  private setupPlayerEvents() {
    if (!this.avPlayer) {
      return;
    }

    // 修改为字符串状态匹配
    this.avPlayer.on('stateChange', (state: string) => {
      console.log('stateChange:' + state);
      switch (state) {
        case 'initialized': // 原media.AVPlayerState.PREPARED
          this.avPlayer?.prepare();
          break;
        case 'prepared': // 原media.AVPlayerState.PREPARED
          console.log('准备完成');
          break;
        case 'playing': // 原media.AVPlayerState.PLAYING
          this.isPlaying = true;
          this.startProgressTracking();
          break;
        case 'paused': // 原media.AVPlayerState.PAUSED
          this.isPlaying = false;
          this.stopProgressUpdate();
          break;
        case 'completed': // 原media.AVPlayerState.COMPLETED
          this.isPlaying = false;
          this.playProgress = 100;
          this.stopProgressUpdate();
          break;
      }
    });

    this.avPlayer.on('error', (err: BusinessError) => {
      console.error('播放错误: ' + JSON.stringify(err));
      this.releasePlayer();
      this.initAudioPlayer();
    });
  }

  // 开始播放进度跟踪
  private startProgressTracking() {
    console.log('startProgressTracking=====');
    this.timerId = setInterval(() => {
      if (this.avPlayer && this.avPlayer.duration > 0) {
        console.log('setInterval currentTime=' + this.avPlayer.currentTime + ' duration=' + this.avPlayer.duration);
        this.playProgress = (this.avPlayer.currentTime / this.avPlayer.duration) * 100;
      }
    }, 1000);
    console.log('this.timerId=' + this.timerId);
  }

  // 停止进度更新
  private stopProgressUpdate() {
    console.log('stopProgressUpdate=====');
    if (this.timerId !== null) {
      clearInterval(this.timerId);
      this.timerId = null;
    }
  }

  // 释放播放器资源
  private releasePlayer() {
    console.log('releasePlayer=====');
    if (this.avPlayer) {
      this.avPlayer.release();
      this.avPlayer = null;
    }
  }

  // 播放/暂停控制
  private togglePlayback() {
    if (!this.avPlayer) {
      return;
    }
    if (this.isPlaying) {
      this.avPlayer.pause();
    } else {
      if (this.avPlayer.currentTime >= this.avPlayer.duration) {
        this.avPlayer.seek(0);
      }
      this.avPlayer.play();
    }
  }

  build() {
    Column() {
      // 播放控制区域
      Row({ space: 20 }) {
        Button(this.isPlaying ? '暂停' : '播放')
          .onClick(() => this.togglePlayback())
          .width(100)
          .height(40)

        Progress({ value: this.playProgress, total: 100 })
          .width('60%')
          .height(10)
          .color('#409EFF')
      }
      .padding(20)
      .width('100%')

      // 音频信息显示
      Text('当前播放：' + this.audioPath.split('/').pop())
        .fontSize(16)
        .margin({ top: 20 })
    }
    .width('100%')
    .height('100%')
    .padding(20)
    .backgroundColor('#F5F5F5')
  }
}

media.AVFileDescriptor

fd：文件描述符

• ​含义：操作系统分配的唯一标识符，代表已打开的文件句柄（file descriptor）。
• ​作用：
• • 系统通过该标识符定位具体的媒体文件（如存储在rawfile目录下的音频文件或HAP包内嵌资源）
  • 用于跨进程文件访问时传递文件引用（如播放器服务与UI界面的数据交互）
  • 示例：通过resourceManager.getRawFd('music.mp3')获取打包资源文件的描述符

​offset：文件偏移量

• ​含义：从文件起始位置到目标数据的字节偏移量（单位：字节）。
• ​技术细节：
• • 当媒体文件被压缩或打包时（如HAP资源文件），需跳过文件头等非音频数据部分
  • 支持精确指定播放起始点（如从视频第10秒开始播放，需计算对应的字节偏移）
  • 示例：若资源文件在HAP包中的物理偏移为1024字节，则offset需设为1024

​length：数据长度

• ​含义：需要读取的媒体数据总长度（单位：字节）。
• ​关键作用：
• • 限制播放器读取范围，避免处理无关数据（如仅播放某段音频或视频片段）
  • 防止越界读取导致的崩溃（如文件实际大小小于声明长度时触发错误码5400102）
  • 示例：从HAP包中读取一个30秒的MP3片段时，需通过fs.statSync获取精确文件长度

参数关系与开发规范

示例

播放HAP内嵌资源

typescriptconst fdObj = await resourceManager.getRawFd('music.mp3');
const avFileDescriptor = {
  fd: fdObj.fd,
  offset: fdObj.offset, // 自动处理HAP打包偏移
  length: fdObj.length   // 精确获取资源实际长度
};
avPlayer.fdSrc = avFileDescriptor;  // 直接绑定播放源[3](@ref)

分段播放大型文件​

typescript// 播放视频第60-120秒的内容
const startOffset = 60 * bitrate;   // 根据码率计算字节偏移
const playLength = 60 * bitrate;
avPlayer.fdSrc = { fd, offset: startOffset, length: playLength };

开发注意事项：

• 若offset + length超过实际文件大小，将触发BusinessError 5400102（参数非法）
• 使用fs.close(fd)在aboutToDisappear生命周期关闭文件描述符，避免资源泄漏
• 在on('error')回调中处理文件访问异常（如权限不足或文件损坏）