# 音频规格

## 音频流类型与通路配置

|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|**描述**|应用使用[AudioRenderer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-audiorenderer)、[OHAudio](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohaudio)等音频接口播放音频流，需按实际业务场景及用途正确配置StreamUsage。比如：听歌场景使用STREAM_USAGE_MUSIC；看视频场景使用STREAM_USAGE_MOVIE等。|
|**类型**|建议|
|**适用设备**|通用|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|支持的音频流使用类型请参见[StreamUsage](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-e#streamusage)|

|-----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|**描述**|应用使用[AudioCapturer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-audiocapturer)、[OHAudio](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohaudio)等音频接口采集音频流，需按实际业务场景及用途正确配置SourceType。比如：语音识别场景使用SOURCE_TYPE_VOICE_RECOGNITION；VOIP通话场景使用SOURCE_TYPE_VOICE_COMMUNICATION等。|
|**类型**|建议|
|**适用设备**|通用|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|支持的音频源使用类型请参见[SourceType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-e#sourcetype8)|

|-----------|--------------------------------------------------------------------------------------------------------------------------------|
|**描述**|为保证功耗与音频性能，建议仅在有时延需求的场景下（如K歌耳返、游戏音效等）才使用[低时延接口](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohaudio)。|
|**类型**|建议|
|**适用设备**|通用|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[设置音频流的时延模式](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ohaudio)|

## 并发、音量与设备管理

|-----------|----------------------------------------------------------------------------------------------------------------------------------------------|
|**描述**|应用播放/采集音频时，应用需监听音频打断事件。当音频打断事件发生时，系统会根据预设策略，对音频流做出相应的操作，并针对状态发生改变的音频流，向所属的应用发送音频打断事件。应用收到音频打断事件后，需根据其内容提示，做出相应的处理，避免出现应用状态与预期效果不一致的问题（如暂停/恢复）。|
|**类型**|规则|
|**适用设备**|通用|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[监听音频打断事件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/audio-playback-concurrency)|

|-----------|------------------------------------------------------------------------------------------------|
|**描述**|在长时音视频播放场景下，音视频媒体资源为应用/元服务界面中用户关注首要场景，且需用户长时聚焦在播音频资源时，应用/元服务音频播放时需采用stop音频焦点策略，打断后台音乐、听书等音频业务播放。|
|**类型**|建议|
|**适用设备**|通用|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[音频播放概述](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/audio-playback-overview)|

|-----------|-----------------------------------------------------------------------------------------------|
|**描述**|在短时音视频播放场景下，音视频媒体资源内嵌于用户界面，非用户关注首要场景，且用户仅需短时聚焦在播音频资源时，应用/元服务播放时需采用pause音频焦点策略，暂停后台音乐、听书等音频业务播放。|
|**类型**|建议|
|**适用设备**|通用|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[音频播放概述](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/audio-playback-overview)|

|-----------|-----------------------------------------------------------------------------------------------|
|**描述**|在音视频静音播放场景下，应用/元服务在静音播放时需采用share音频焦点策略，不得打断其他音频业务播放。|
|**类型**|规则|
|**适用设备**|通用|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[音频播放概述](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/audio-playback-overview)|

|-----------|---------------------------------------------------------------------------------------------------|
|**描述**|在短音、瞬态音播放场景，应用/元服务需采用share、duck或pause音频焦点策略，实现与其它音频业务并发播放或短暂暂停后台音乐、听书等音频业务播放，不得打断其它音频业务并使其无法自动恢复播放。|
|**类型**|规则|
|**适用设备**|通用|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[音频播放概述](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/audio-playback-overview)|

|-----------|----------------------------------------------------------------------------------------------------------------------------------------------|
|**描述**|在VOIP通话场景下，应用/元服务需合理管理音频设备，不使用废弃接口；需合理管理音频焦点策略，按场景配置正确的流类型；需保证铃音流与通话流切换过程中不因丢失音频焦点造成后台应用出现漏音问题；需关注并处理焦点打断事件，通话过程被其它VOIP通话打断后，需实现挂断通话或等待通话恢复功能。|
|**类型**|建议|
|**适用设备**|通用|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[音频通话开发概述](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/audio-call-overview)|

|-----------|-------------------------------------------------------------------------------------------------------|
|**描述**|应用在播放声音的情况下，应该监听发声设备变化，如果发声设备不可用导致发声设备切换到外放时，建议应用暂停播放。|
|**类型**|建议|
|**适用设备**|通用|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[响应音频流输出设备变更](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/audio-output-device-change)|

## 音视频播控服务

|-----------|-----------------------------------------------------------------------------------------------------|
|**描述**|创建AVSession后，音视频应用应提供基础的媒体会话元数据和媒体会话播放状态，包含但不限于音视频源的封面、标题、歌曲作者、副标题、时长、播放状态（暂停、播放）、播放位置等。|
|**类型**|建议|
|**适用设备**|通用|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[设置元数据](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/avsession-access-scene#设置元数据信息)|

|-----------|------------------------------------------------------------------------------------------------------|
|**描述**|音乐、视频、听书类应用需要通过AVSession监听耳机的按键事件，并做正确的响应，如暂停、恢复播放、下一首、上一首等。|
|**类型**|规则|
|**适用设备**|通用|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[注册控制命令](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/avsession-access-scene#控制命令的处理)|