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; // 存儲定時器IDprivate 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處理Promiseconst 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.PREPAREDthis.avPlayer?.prepare();break;case 'prepared': // 原media.AVPlayerState.PREPAREDconsole.log('準備完成');break;case 'playing': // 原media.AVPlayerState.PLAYINGthis.isPlaying = true;this.startProgressTracking();break;case 'paused': // 原media.AVPlayerState.PAUSEDthis.isPlaying = false;this.stopProgressUpdate();break;case 'completed': // 原media.AVPlayerState.COMPLETEDthis.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獲取精確文件長度

參數關系與開發規范

參數	典型取值范圍	異常處理建議
fd	≥0（0表示無效句柄）	檢查fs.open()返回值是否有效
offset	0 ≤ offset ≤ 文件大小-1	配合fs.stat驗證偏移有效性
length	1 ≤ length ≤ 剩余字節數	動態計算：length = 文件大小 - offset

示例

播放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')回調中處理文件訪問異常（如權限不足或文件損壞）