建站
咨詢
售后
建站咨詢
新聞中心
這里有您想知道的互聯(lián)網(wǎng)營銷解決方案
創(chuàng)新互聯(lián)鴻蒙OS教程：鴻蒙OS 音頻播放開發(fā)指導
場景介紹
音頻播放的主要工作是將音頻數(shù)據(jù)轉(zhuǎn)碼為可聽見的音頻模擬信號并通過輸出設備進行播放，同時對播放任務進行管理。
接口說明
| 接口名 | 描述 |
|---|---|
| AudioRenderer(AudioRendererInfo audioRendererInfo, PlayMode pm) throws IllegalArgumentException | 構造函數(shù)，設置播放相關音頻參數(shù)和播放模式，使用默認播放設備。 |
| AudioRenderer(AudioRendererInfo audioRendererInfo, PlayMode pm, AudioDeviceDescriptor outputDevice) throws IllegalArgumentException | 構造函數(shù)，設置播放相關音頻參數(shù)、播放模式和播放設備。 |
| boolean start() | 播放音頻流。 |
| boolean write(byte[] data, int offset, int size) | 將音頻數(shù)據(jù)以 byte 流寫入音頻接收器以進行播放。 |
| boolean write(short[] data, int offset, int size) | 將音頻數(shù)據(jù)以 short 流寫入音頻接收器以進行播放。 |
| boolean write(float[] data, int offset, int size) | 將音頻數(shù)據(jù)以 float 流寫入音頻接收器以進行播放。 |
| boolean write(java.nio.ByteBuffer data, int size) | 將音頻數(shù)據(jù)以 ByteBuffer 流寫入音頻接收器以進行播放。 |
| boolean pause() | 暫停播放音頻流。 |
| boolean stop() | 停止播放音頻流。 |
| boolean release() | 釋放播放資源。 |
| AudioDeviceDescriptor getCurrentDevice() | 獲取當前工作的音頻播放設備。 |
| boolean setPlaybackSpeed(float speed) | 設置播放速度。 |
| boolean setPlaybackSpeed(AudioRenderer.SpeedPara speedPara) | 設置播放速度與音調(diào)。 |
| boolean setVolume(ChannelVolume channelVolume) | 設置指定聲道上的輸出音量。 |
| boolean setVolume(float vol) | 設置所有聲道上的輸出音量。 |
| static int getMinBufferSize(int sampleRate, AudioStreamInfo.EncodingFormat format, AudioStreamInfo.ChannelMask channelMask) | 獲取Stream播放模式所需的buffer大小。 |
| State getState() | 獲取音頻播放的狀態(tài)。 |
| int getRendererSessionId() | 獲取音頻播放的 session ID。 |
| int getSampleRate() | 獲取采樣率。 |
| int getPosition() | 獲取音頻播放的幀數(shù)位置。 |
| boolean setPosition(int position) | 設置起始播放幀位置。 |
| AudioRendererInfo getRendererInfo() | 獲取音頻渲染信息。 |
| boolean duckVolume() | 降低音量并將音頻與另一個擁有音頻焦點的應用程序混合。 |
| boolean unduckVolume() | 恢復音量。 |
| SpeedPara getPlaybackSpeed() | 獲取播放速度、音調(diào)參數(shù)。 |
| boolean setSpeed(SpeedPara speedPara) | 設置播放速度、音調(diào)參數(shù)。 |
| Timestamp getAudioTime() | 獲取播放時間戳信息。 |
| boolean flush() | 刷新當前的播放流數(shù)據(jù)隊列。 |
| static float getMaxVolume() | 獲取播放流可設置的最大音量。 |
| static float getMinVolume() | 獲取播放流可設置的最小音量。 |
| StreamType getStreamType() | 獲取播放流的音頻流類型。 |
開發(fā)步驟
- 構造音頻流參數(shù)的數(shù)據(jù)結構 AudioStreamInfo，推薦使用 AudioStreamInfo.Builder 類來構造，模板如下，模板中設置的均為 AudioStreamInfo.Builder 類的默認值，根據(jù)音頻流的具體規(guī)格來設置具體參數(shù)。
AudioStreamInfo audioStreamInfo = new AudioStreamInfo.Builder().sampleRate(
AudioStreamInfo.SAMPLE_RATE_UNSPECIFIED)
.audioStreamFlag(AudioStreamInfo.AudioStreamFlag.AUDIO_STREAM_FLAG_NONE)
.encodingFormat(AudioStreamInfo.EncodingFormat.ENCODING_INVALID)
.channelMask(AudioStreamInfo.ChannelMask.CHANNEL_INVALID)
.streamUsage(AudioStreamInfo.StreamUsage.STREAM_USAGE_UNKNOWN)
.build();以真實的播放pcm流為例：
AudioStreamInfo audioStreamInfo = new AudioStreamInfo.Builder().sampleRate(44100) // 44.1kHz
.audioStreamFlag(AudioStreamInfo.AudioStreamFlag.AUDIO_STREAM_FLAG_MAY_DUCK) // 混音
.encodingFormat(AudioStreamInfo.EncodingFormat.ENCODING_PCM_16BIT) // 16-bit PCM
.channelMask(AudioStreamInfo.ChannelMask.CHANNEL_OUT_STEREO) // 雙聲道
.streamUsage(AudioStreamInfo.StreamUsage.STREAM_USAGE_MEDIA) // 媒體類音頻
.build();- 使用創(chuàng)建的音頻流構建音頻播放的參數(shù)結構AudioRendererInfo，推薦使用AudioRendererInfo.Builder類來構造，模板如下，模板中設置的均為AudioRendererInfo.Builder類的默認值，根據(jù)音頻播放的具體規(guī)格來設置具體參數(shù)。
AudioRendererInfo audioRendererInfo = new AudioRendererInfo.Builder().audioStreamInfo(audioStreamInfo)
.audioStreamOutputFlag(AudioRendererInfo.AudioStreamOutputFlag.AUDIO_STREAM_OUTPUT_FLAG_NONE)
.bufferSizeInBytes(0)
.distributedDeviceId("")
.isOffload(false)
.sessionID(AudioRendererInfo.SESSION_ID_UNSPECIFIED)
.build();以真實的播放pcm流為例：
AudioRendererInfo audioRendererInfo = new AudioRendererInfo.Builder().audioStreamInfo(audioStreamInfo)
.audioStreamOutputFlag(AudioRendererInfo.AudioStreamOutputFlag.AUDIO_STREAM_OUTPUT_FLAG_DIRECT_PCM) // pcm格式的輸出流
.bufferSizeInBytes(100)
.distributedDeviceId("E54***5E8") // 使用分布式設備E54***5E8播放
.isOffload(false) // false表示分段傳輸buffer并播放，true表示整個音頻流一次性傳輸?shù)紿AL層播放
.build();- 根據(jù)要播放音頻流指定 PlayMode，不同的 PlayMode 在寫數(shù)據(jù)時存在差異，詳情見[步驟7]，其余播放流程是無區(qū)別的。并通過構造函數(shù)獲取 AudioRenderer 類的實例化對象。
- 使用構造函數(shù)獲取 AudioRenderer 類的實例化對象，其中[步驟2]，[步驟3]中的數(shù)據(jù)為構造函數(shù)的必選參數(shù)，指定播放設備為可選參數(shù)，根據(jù)使用場景選擇不同的構造函數(shù)。
- （可選）構造音頻播放回調(diào)，首先構造對象 AudioInterrupt，其中 setInterruptListener 方法的入?yún)⑿枰獙崿F(xiàn)接口類 InterruptListener， setStreamInfo 方法使用[步驟1]的 AudioStreamInfo 作為入?yún)?。然后調(diào)用 AudioManager 類的 activateAudioInterrupt(AudioInterrupt interrupt)方法進行音頻播放回調(diào)注冊。代碼示例如下：
AudioInterrupt audioInterrupt = new AudioInterrupt();
AudioManager audioManager = new AudioManager();
audioInterrupt.setStreamInfo(streamInfo);
audioInterrupt.setInterruptListener(new AudioInterrupt.InterruptListener() {
@Override
public void onInterrupt(int type, int hint) {
if (type == AudioInterrupt.INTERRUPT_TYPE_BEGIN
&& hint == AudioInterrupt.INTERRUPT_HINT_PAUSE) {
renderer.pause();
} else if (type == AudioInterrupt.INTERRUPT_TYPE_BEGIN
&& hint == AudioInterrupt.INTERRUPT_HINT_NONE) {
} else if (type == AudioInterrupt.INTERRUPT_TYPE_END && (
hint == AudioInterrupt.INTERRUPT_HINT_NONE
|| hint == AudioInterrupt.INTERRUPT_HINT_RESUME)) {
renderer.play();
} else {
}
}
});
audioManager.activateAudioInterrupt(audioInterrupt);- 調(diào)用 AudioRenderer 實例化對象的 start() 方法啟動播放任務。
- 將要播放的音頻數(shù)據(jù)讀取為 byte 流或 short 流，對于選擇 MODE_STREAM 模式的 PlayMode，需要循環(huán)調(diào)用 write 方法進行數(shù)據(jù)寫入。對于選擇 MODE_STATIC 模式的 PlayMode，只能通過調(diào)用一次 write 方法將要播放的音頻數(shù)據(jù)全部寫入，因此該模式限制在文件規(guī)格較小的音頻數(shù)據(jù)播放場景下才能使用。
- （可選）當需要對音頻播放進行暫?；蛲Ｖ箷r，調(diào)用 AudioRenderer 實例化對象的 pause() 或 stop() 方法進行暫?；蛲Ｖ共シ拧?/li>
- （可選）調(diào)用 AudioRenderer 實例化對象的 setSpeed 調(diào)節(jié)播放速度，setVolume 調(diào)節(jié)播放音量。
- 播放任務結束后，調(diào)用 AudioRenderer 實例化對象的 release() 釋放資源。
當前文章：創(chuàng)新互聯(lián)鴻蒙OS教程：鴻蒙OS 音頻播放開發(fā)指導
鏈接分享：http://www.5511xx.com/article/dpsojdo.html
