【Harmony Next】使用 AVPlayer 播放音頻

在鴻蒙Next系統中，AVPlayer為開發者提供了強大的音頻播放功能。以下將詳細介紹如何使用AVPlayer來實現音頻播放。

播放狀態變化示意圖

基本使用步驟

創建AVPlayer實例：通過media.createAVPlayer()方法創建AVPlayer實例，用于控制音頻的播放。示例代碼如下：

async createAVPlayerInstance() {
    const avPlayer = await media.createAVPlayer(); // 異步
    return avPlayer;
}

設置播放源：指定本地 rawFile 路徑，如 test.mp3

  async setSourcePath(path: string) {
  setTimeout(async () => {
    if (!this.checkNull()) {
      try {
        let context = getContext(this) as common.UIAbilityContext;
        let fileDescriptor = await context.resourceManager.getRawFd(path);
        let fileFd: number = JSON.parse(JSON.stringify(fileDescriptor))['fd']
        let fileOffset: number = JSON.parse(JSON.stringify(fileDescriptor))['offset']
        this.avFileDescriptor = { fd: fileFd, offset: fileOffset, length: -1 };
        this.avPlayer!.fdSrc = this.avFileDescriptor;
      } catch (err) {
        console.info('Set Url failed : ' + JSON.stringify(err))
      }
    }
  }, 500)
}

監聽狀態變化：監聽stateChange事件來了解播放器的狀態，從而做出相應操作。示例代碼如下：


/**
 * avplayer回調
 */
private setAVPlayerCallback() {
  if (this.checkNull()) {
    return
  }
  // seek操作結果回調
  this.avPlayer!.on('seekDone', (seekDoneTime) => {
    console.info(`AVPlayer seek succeeded, seek time is ${seekDoneTime}`);
  })

  // 音量變化回調
  this.avPlayer!.on('volumeChange', (volume) => {
    console.info(`volumeChange called, and new volume is :${volume}`);
  })

  // 音頻總時長
  this.avPlayer!.on('durationUpdate', (duration) => {
    console.info(`durationUpdate :${duration}`);
  })

  // 當前播放進度
  this.avPlayer!.on('timeUpdate', (time) => {
    let now = Math.floor(time/1000)
    if (this.process != now) {
      console.info(`timeUpdate :${now}`);
    }
    this.process = now
  })

  // error回調監聽函數,當avPlayer在操作過程中出現錯誤時調用reset接口觸發重置流程
  this.avPlayer!.on('error', (err) => {
    console.error(`Invoke avPlayer failed, code is ${err.code}, message is ${err.message}`);
    this.avPlayer!.reset(); // 調用reset重置資源，觸發idle狀態
  })

  // 狀態機變化回調函數
  this.avPlayer!.on('stateChange', async (state, reason) => {
    switch (state) {
      case 'idle': // 成功調用reset接口后觸發該狀態機上報
        console.info('AVPlayer state idle called.');
        this.avPlayer!.release(); // 調用release接口銷毀實例對象
        break;
      case 'initialized': // avplayer 設置播放源后觸發該狀態上報
        console.info('AVPlayer state initialized called.');
        this.avPlayer!.prepare().then(() => {
          console.info('AVPlayer prepare succeeded.');
        }, () => {
          console.error(`Invoke prepare failed, code is`);
        });
        break;
      case 'prepared': // prepare調用成功后上報該狀態機
        console.info('AVPlayer state prepared called.');
        this.avPlayer!.loop = this.loop
        this.avPlayer!.setVolume(this.volume)
        if (this.autoPlay) {
          this.avPlayer!.play(); // 調用播放接口開始播放
        }
        break;
      case 'playing': // play成功調用后觸發該狀態機上報
        console.info('AVPlayer state playing called.');
        break;
      case 'paused': // pause成功調用后觸發該狀態機上報
        console.info('AVPlayer state paused called.');
        break;
      case 'completed': // 播放結束后觸發該狀態機上報
        console.info('AVPlayer state completed called.');
        if (this.loop == true) {
          this.avPlayer!.seek(0)
          this.avPlayer!.play()
        }
        break;
      case 'stopped': // stop接口成功調用后觸發該狀態機上報
        console.info('AVPlayer state stopped called.');
        break;
      case 'released':
        console.info('AVPlayer state released called.');
        break;
      default:
        console.info('AVPlayer state unknown called.');
        break;
    }
  })
}

控制音頻播放：可以調用play()、pause()、stop()、seek()等方法對音頻進行播放、暫停、停止、跳轉等操作。示例代碼如下：


play() {
  if (this.checkNull()) {
    this.autoPlay = true
    return
  }

  this.avPlayer!.play().then(() => {
    console.info('Play success')
  }).catch((err: BusinessError) => {
    console.info('Play failed : ' + JSON.stringify(err))
  })
}

pause() {
  if (this.checkNull()) {
    this.autoPlay = false
    return
  }
  this.avPlayer!.pause().then(() => {
    console.info('Pause success')
  }).catch((err: BusinessError) => {
    console.info('Pause failed : ' + JSON.stringify(err))
  })
}

release() {
  if (this.checkNull()) {
    this.autoPlay = false
    return
  }
  this.avPlayer!.release().then(() => {
    console.info('Release success')
    setTimeout(() => {
    }, 500)
  }).catch((err: BusinessError) => {
    console.info('Release failed : ' + JSON.stringify(err))
  })
}

setVolume(volume: number) {
  console.info(`setVolume ${volume}`)
  this.volume = volume
  if (this.checkNull()) {
    return
  }
  this.avPlayer!.setVolume(volume)
}

setLoop() {
  console.info('setLoop')
  this.loop = true
  if (this.checkNull()) {
    return
  }
  this.avPlayer!.loop = true
}

設置音量和循環播放時需要在狀態 prepared 后調用，否則會報錯

Invoke avPlayer failed, code is 5400102, message is Operate Not Permit: current state is not prepared/playing/paused/completed, unsupport loop operation

釋放資源：當音頻播放完成或者不再需要播放時，調用release()方法釋放資源，避免內存泄漏。示例代碼如下：

async function releasePlayer(avPlayer) {
    await avPlayer.release();
}

注意事項

權限申請：如果要訪問在線媒體資源，需要在配置文件中申請ohos.permission.INTERNET權限。
資源格式：確保音頻文件格式與鴻蒙系統支持的格式兼容，以避免無法播放的情況。
異常處理：在播放過程中可能會遇到網絡中斷、文件損壞等異常情況，需要添加異常處理邏輯，如監聽error事件來進行相應處理。

希望通過以上介紹，能幫助開發者在鴻蒙Next應用開發中熟練使用AVPlayer實現音頻播放功能，為用戶帶來更好的音頻體驗。

本文由博客一文多發平臺 OpenWrite 發布！

posted @ 2025-03-07 14:19 Brian512 閱讀(229) 評論(0) 收藏舉報

刷新頁面返回頂部

【Harmony Next】使用 AVPlayer 播放音頻

播放狀態變化示意圖

基本使用步驟

注意事項

公告