跳到主要内容

使用合适的音频流类型

音频流类型是定义音频数据播放和录制方式的关键属性。对于播放流，其类型由StreamUsage确定；对于录制流，则由SourceType决定。音频流类型对音量控制、音频焦点管理以及输入/输出设备的选择具有决定性影响。

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

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

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

播放音频流类型​

下表中列举常用的播放音频流类型，由StreamUsage定义。

音频流使用类型（StreamUsage）适用场景
STREAM_USAGE_MUSIC适用于播放音乐，同样适用于其他媒体场景，如使用SoundPool播放简短音效等。
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适用于播放通知音、提示音。

录制音频流类型​

下表中列举常用的录制音频流类型，由SourceType定义。

音频流使用类型（SourceType）适用场景
SOURCE_TYPE_MIC适用于普通录音。
SOURCE_TYPE_VOICE_RECOGNITION9+适用于语音识别。
SOURCE_TYPE_PLAYBACK_CAPTURE（API12已废弃）适用于录制其他应用送到系统中播放的原始音频数据。 AudioKit不再提供内录接口，请通过录屏接口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通话体验不佳。建议开发者根据业务场景选择合适的音频流类型。

音量控制​

播放流类型（StreamUsage）决定了音频流所属的音量类型（AudioVolumeType），各类音量类型（如媒体、铃声、闹钟、通话等）拥有独立的音量值，在用户界面上可独立调节，相互之间不会影响。

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

音频流使用类型（StreamUsage）音量类型（AudioVolumeType）
MUSIC、MOVIE、AUDIOBOOK、GAME媒体音量（MEDIA）
RINGTONE、NOTIFICATION铃声音量（RINGTONE）
VOICE_COMMUNICATION通话音量（VOICE_CALL）
ALARM闹钟音量（ALARM）

音频焦点调整​

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

当应用启动音频播放或录制时，系统会根据音频流类型自动申请焦点，这可能会中断其他音频或降低其音量。音频焦点的具体介绍可参考音频焦点介绍。

此处仅说明常见的音频流类型影响音频焦点的表现，其他类型可参考系统默认焦点策略表。

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

输入/输出设备选择​

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

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

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

若默认的输入/输出设备不符合使用诉求，应用也可以调用相关接口主动修改。应用使用AudioRenderer开发音频播放功能(ArkTs)时，可以调用setDefaultOutputDevice接口，设置默认发声设备。

设置音频流类型​

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

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

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