使用合适的音频流类型
==========

[音频流](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/audio-kit-intro#音频流介绍)类型是定义音频数据播放和录制方式的关键属性。对于播放流，其类型由[StreamUsage](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-e#streamusage)确定；对于录制流，则由[SourceType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-e#sourcetype8)决定。音频流类型对音量控制、音频焦点管理以及输入/输出设备的选择具有决定性影响。

为了确保音频行为符合预期并提供优质的用户体验，应用开发者应根据具体业务场景和实际需求，为音频选择恰当的流类型。

接下来，文档将介绍[常用的音频流类型及其适用场景](#常用的音频流类型及其适用场景)，同时说明[不同流类型对音频业务的影响](#流类型对音频业务的影响)。最后，指导开发者在采用不同方法实现音频播放和音频录制时，应当如何[设置音频流类型](#设置音频流类型)。

#### 常用的音频流类型及其适用场景

#### \[h2\]播放音频流类型

下表中列举常用的播放音频流类型，由[StreamUsage](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-e#streamusage)定义。

| 音频流使用类型（StreamUsage） | 适用场景 |
| :-- | :-- |
| STREAM\_USAGE\_MUSIC | 适用于播放音乐，同样适用于其他媒体场景，如[使用SoundPool](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/using-soundpool-for-playback)播放简短音效等。 |
| STREAM\_USAGE\_MOVIE | 适用于播放短视频、电影、电视剧等各类视频内容。 |
| STREAM\_USAGE\_AUDIOBOOK | 适用于播放有声读物、新闻、播客等。 |
| STREAM\_USAGE\_GAME | 适用于游戏内配乐、配音，后台音乐不会被打断；游戏内语音，建议使用STREAM\_USAGE\_VOICE\_COMMUNICATION。 |
| STREAM\_USAGE\_NAVIGATION | 适用于导航场景的语音播报功能。 |
| STREAM\_USAGE\_VOICE\_MESSAGE | 适用于播放语音短消息。 |
| STREAM\_USAGE\_VOICE\_COMMUNICATION | 适用于VoIP语音通话。 |
| STREAM\_USAGE\_ALARM | 适用于播放闹铃。 |
| STREAM\_USAGE\_RINGTONE | 适用于VoIP来电响铃等。 |
| STREAM\_USAGE\_NOTIFICATION | 适用于播放通知音、提示音。 |

#### \[h2\]录制音频流类型

下表中列举常用的录制音频流类型，由[SourceType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-e#sourcetype8)定义。

| 音频流使用类型（SourceType） | 适用场景 |
| :-- | :-- |
| SOURCE\_TYPE\_MIC | 适用于普通录音。 |
| SOURCE\_TYPE\_VOICE\_RECOGNITION9+ | 适用于语音识别。 |
| SOURCE\_TYPE\_PLAYBACK\_CAPTURE | 
（API12已废弃）适用于录制其他应用送到系统中播放的原始音频数据。

AudioKit不再提供内录接口，请通过[录屏接口AVScreenCapture](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-avscreencapture)进行内录。

 |
| SOURCE\_TYPE\_VOICE\_COMMUNICATION | 适用于VoIP语音通话，能够增强人声录制，同时抑制环境音等其他非人声。 |
| SOURCE\_TYPE\_VOICE\_MESSAGE | 适用于录制语音短消息。 |
| SOURCE\_TYPE\_CAMCORDER13+ | 适用于相机录像。 |
| SOURCE\_TYPE\_UNPROCESSED14+ | 适用于获取麦克风采集到的纯净音频数据（系统不做任何算法处理）。 |
| SOURCE\_TYPE\_LIVE20+ | 适用于直播，在支持的设备上会提供系统回声消除能力。 |

#### 流类型对音频业务的影响

不同的流类型会影响用户在控制音量时的体验，以及系统在调整音频焦点和选择输入/输出设备时的表现。此外，系统还会根据录制流类型对采集到的音频数据配置对应的优化处理策略，因此录制流类型的选择会影响到录制的音频效果。例如：如果在VoIP通话场景下使用了SOURCE\_TYPE\_MIC而不是SOURCE\_TYPE\_VOICE\_COMMUNICATION类型，可能会使降噪、环境音消除等优化策略不生效，造成VoIP通话体验不佳。建议开发者根据业务场景选择合适的音频流类型。

#### \[h2\]音量控制

播放流类型（[StreamUsage](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-e#streamusage)）决定了音频流所属的音量类型（[AudioVolumeType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-e#audiovolumetype)），各类音量类型（如媒体、铃声、闹钟、通话等）拥有独立的音量值，在用户界面上可独立调节，相互之间不会影响。

常见的播放流类型与音量类型的对应关系为：

| 音频流使用类型（StreamUsage） | 音量类型（AudioVolumeType） |
| :-- | :-- |
| MUSIC、MOVIE、AUDIOBOOK、GAME | 媒体音量（MEDIA） |
| RINGTONE、NOTIFICATION | 铃声音量（RINGTONE） |
| VOICE\_COMMUNICATION | 通话音量（VOICE\_CALL） |
| ALARM | 闹钟音量（ALARM） |

#### \[h2\]音频焦点调整

音频流类型在音频焦点管理中扮演着关键角色，不同类型的音频流具有不同的默认优先级和处理方式。

当应用启动音频播放或录制时，系统会根据音频流类型自动申请焦点，这可能会中断其他音频或降低其音量。音频焦点的具体介绍可参考[音频焦点介绍](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/audio-playback-concurrency)。

此处仅说明常见的音频流类型影响音频焦点的表现。

*   启动导航（Navigation）时，正在播放的音乐（Music）音量会自动调低，待导航（Navigation）结束后，音乐（Music）音量将自动恢复。
    
*   开始播放视频（Movie）时，将会停止正在播放的音乐（Music）；当视频（Movie）播放结束后，音乐（Music）播放不会自动恢复，对应的应用也不会收到任何恢复通知。
    
*   开始语音通话（VoiceCommunication）时，将会暂停正在播放的音乐（Music）；当语音通话（VoiceCommunication）结束后，播放音乐（Music）的应用将收到恢复播放的通知。
    
*   音乐（Music）和游戏音频（Game）可以混音播放，两者互不影响。
    
*   开始录制语音短消息（VoiceMessage）时，会自动暂停正在播放的音乐（Music）；当语音短消息（VoiceMessage）录制结束后，播放音乐（Music）的应用将收到恢复播放的通知。
    

#### \[h2\]输入/输出设备选择

对于不同类型的音频流，系统会为其选定相应的输入/输出设备。

此处仅说明常见的音频流类型对应的输入/输出设备。

*   音乐（Music）类型音频流的默认输出设备为扬声器。
    
*   语音通话（VoiceCommunication）类型音频流的默认输入设备为麦克风，默认输出设备为听筒。
    
*   闹铃（Alarm）类型音频流的默认输出设备为扬声器‌。若先连接蓝牙耳机，再开始播放Alarm音频，则扬声器和蓝牙耳机会同时播放。
    

若默认的输入/输出设备不符合使用诉求，应用也可以调用相关接口主动修改。应用[使用AudioRenderer开发音频播放功能(ArkTs)](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/using-audiorenderer-for-playback)时，可以调用[setDefaultOutputDevice](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-audiorenderer#setdefaultoutputdevice12)接口，设置默认发声设备。

#### 设置音频流类型

应用可采用多种方法实现音频播放或录音功能，因此，设置音频流类型的方式也各不相同。

常见的设置播放音频流类型的方法有：

*   **[使用AudioRenderer开发音频播放功能(ArkTs)](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/using-audiorenderer-for-playback)**：
    
    可以在调用[createAudioRenderer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-f#audiocreateaudiorenderer8)以获取音频渲染器时，传入对应的[StreamUsage](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-e#streamusage)。
    
    createAudioRenderer的参数options类型为AudioRendererOptions，包含AudioRendererInfo渲染器信息，使用AudioRendererInfo.usage可指定StreamUsage音频流类型。
    
*   **[推荐使用OHAudio开发音频播放功能(C/C++)](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/using-ohaudio-for-playback)**：
    
    可以在调用[OH\_AudioStreamBuilder\_SetRendererInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-audiostreambuilder-h#oh_audiostreambuilder_setrendererinfo)接口时，传入对应的[OH\_AudioStream\_Usage](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-audiostream-base-h#oh_audiostream_usage)指定音频流类型。
    
*   **[使用AVPlayer播放音频(ArkTS)](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/using-avplayer-for-playback)**：
    
    可以通过设置AVPlayer的[属性](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-media-avplayer#属性)audioRendererInfo来实现。AVPlayer.audioRendererInfo的类型为audio.AudioRendererInfo。使用AudioRendererInfo.usage可指定[StreamUsage](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-e#streamusage)音频流类型。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8b/v3/qg59AaWqRmuD9QfL-sSBgA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073503Z&HW-CC-Expire=86400&HW-CC-Sign=32D87870699832632A0E87A3684570761B43550B1CA1A83B4967EA24333AF533)
    
    在设置AVPlayer的audioRendererInfo属性时，只允许在initialized状态下设置。
    
    如果应用未主动设置该属性，AVPlayer将进行默认处理。当媒体源包含视频时，usage的默认值为STREAM\_USAGE\_MOVIE；否则，usage的默认值为STREAM\_USAGE\_MUSIC。
    
*   **[使用AVPlayer播放音频(C/C++)](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/using-ndk-avplayer-for-playback)**：
    
    可以在调用[OH\_AVPlayer\_SetAudioRendererInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-avplayer-h#oh_avplayer_setaudiorendererinfo)接口时，传入对应的[OH\_AudioStream\_Usage](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-audiostream-base-h#oh_audiostream_usage)指定音频流类型。
    
*   **[使用SoundPool播放短音频(ArkTS)](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/using-soundpool-for-playback)**：
    
    可以在调用[createSoundPool](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-media-f#mediacreatesoundpool10)接口时，传入对应的[StreamUsage](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-e#streamusage)指定音频流类型。
    

常见的设置录制音频流类型的方法有：

*   **[使用AudioCapturer开发音频录制功能(ArkTs)](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/using-audiocapturer-for-recording)**：
    
    可以在调用[createAudioCapturer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-f#audiocreateaudiocapturer8)接口时，传入对应的[SourceType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-e#sourcetype8)。
    
    createAudioCapturer的参数options类型为AudioCapturerOptions，包含AudioCapturerInfo采集器信息，使用AudioCapturerInfo.source可指定SourceType音源类型。
    
*   **[推荐使用OHAudio开发音频录制功能(C/C++)](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/using-ohaudio-for-recording)**：
    
    可以在调用[OH\_AudioStreamBuilder\_SetCapturerInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-audiostreambuilder-h#oh_audiostreambuilder_setcapturerinfo)接口时，传入对应的[OH\_AudioStream\_SourceType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-audiostream-base-h#oh_audiostream_sourcetype)指定音源类型。
    
*   **[使用AVRecorder录制音频(ArkTS)](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/using-avrecorder-for-recording)**：
    
    可以在调用[AVRecorder.prepare](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-media-avrecorder#prepare9-1)接口时，传入对应的[AudioSourceType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-media-e#audiosourcetype9)。
    
    AVRecorder.prepare的参数config类型为AVRecorderConfig，使用AVRecorderConfig.audioSourceType可指定音源类型。
    

#### 使用不同音频通路

音频通路是指音频数据在系统内部的传输和处理路径，包括从应用到硬件输出的完整处理流程。不同的音频通路采用不同的数据处理策略和硬件资源分配方式，在延迟、功耗、音质等方面各有侧重。

系统根据不同的用户使用场景和音频流的参数信息，提供多种音频通路选择。系统通过应用指定的[StreamUsage](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-e#streamusage)和[SourceType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-e#sourcetype8)提供对应的场景信息，结合音频流的采样率、声道数、编码格式等参数，选择合适的音频通路。

常见的音频通路包括以下几种：

| 音频通路类型 | 特征 | 适用场景 |
| :-- | :-- | :-- |
| **低时延播放通路** | 通过缩短缓冲和最小化音效算法达到时延低的效果。 | 游戏音效、K歌耳返、乐器演奏等对延迟敏感的场景。 |
| **低时延录制通路** | 通过缩短缓冲和最小化音效算法达到时延低的效果。 | K歌场景。 |
| **多声道播放通路** | 支持多声道数据输出，避免下混（将多声道混合为双声道或单声道）。 | 多声道播放场景。 |
| **直通播放通路** | 音频数据在播放链路中不会改变音源格式，直接送到硬件输出。 | 播放高质量无损音乐、Hi-Fi音频等。 |
| **低功耗播放通路** | 通过大缓存减少与硬件交互，以减少功耗。 | 长时间播放音乐、有声读物等。 |
| **普通播放通路** | 通用通路，按当前设备默认音频格式输出。 | 视频播放、通知音、导航等。 |
| **普通录制通路** | 通用通路，按当前设备默认音频格式输入。 | 录音机、相机录制、语音消息等。 |

应用可以通过AudioStreamManager提供的查询接口，在创建音频流之前判断设备是否支持特定的音频通路，从而选择最合适的配置。

#### \[h2\]播放相关查询接口

| 接口 | 说明 |
| :-- | :-- |
| [isFastPlaybackSupported](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-audiostreammanager#isfastplaybacksupported) | 查询是否支持低时延播放。 |
| [isMultichannelPlaybackSupported](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-audiostreammanager#ismultichannelplaybacksupported) | 查询是否支持多声道播放。 |
| [isDirectPlaybackSupported](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-audiostreammanager#isdirectplaybacksupported) | 查询是否支持直通播放。 |
| [isOffloadPlaybackSupported](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-audiostreammanager#isoffloadplaybacksupported) | 查询是否支持低功耗播放。 |

#### \[h2\]录制相关查询接口

| 接口 | 说明 |
| :-- | :-- |
| [isFastRecordingSupported](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-audiostreammanager#isfastrecordingsupported) | 查询是否支持低时延录制。 |

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c8/v3/0VhLWXDkT0Sh-MjUADQ6_Q/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073503Z&HW-CC-Expire=86400&HW-CC-Sign=9168955989A3DCB910FBE5F911B4A1AB1777A94E164968EEA5C54AB885877831)

*   音频通路的支持情况取决于设备的硬件能力和系统配置，不同设备有所不同。
*   查询接口返回的结果仅表示在指定参数下系统是否支持对应的音频通路，音频流实际使用的通路还需结合系统当前的运行状态和资源配置情况确定。