HarmonyOS鸿蒙Next中AVCastPicker组件需要切换音乐用途的音频输出设备

HarmonyOS鸿蒙Next中AVCastPicker组件需要切换音乐用途的音频输出设备 我发现创建AudioRenderer时用audio.StreamUsage.STREAM_USAGE_VOICE_COMMUNICATION，用AVCastPicker组件可以正常切换音频输出设备，但是如果用audio.StreamUsage.STREAM_USAGE_MUSIC就无法切换音频输出设备，可是目前我的app有这样一个需求：

我的app需要自己选择音频输出使用通话音量还是音乐音量，并且还需要在启用音频输出的时候切换音频输出设备。

目前是如果用音乐音量就无法切换音频输出设备，需要让AVCastPicker组件也可以支持音乐用途。

我专门写了一个测试的demo：https://gitee.com/chen_yi_ze/TestAVCastPicker/tree/master/


更多关于HarmonyOS鸿蒙Next中AVCastPicker组件需要切换音乐用途的音频输出设备的实战教程也可以访问 https://www.itying.com/category-93-b0.html

3 回复

开发者您好，接入AVSession并使用AVCastPicker进行音频输出设备切换时，音乐用途为audio.StreamUsage.STREAM_USAGE_VOICE_COMMUNICATION时，播放的是voip语音通话流，为voip通话类应用用途，需要创建’voice_call’类型的AVSession并使用AVCastPicker组件进行音频输出设备切换，此时AVCastPicker组件的图标样式，设备选择页面均为通话类应用用途，效果同开发者您的测试工程。

当音乐用途为audio.StreamUsage.STREAM_USAGE_MUSIC是，播放的是媒体流，此时属于媒体类应用，应该选择创建’audio’或’video’类型的AVSession，再使用AVCastPicker进行音频输出设备切换。可参考投播组件开发步骤：投播组件开发步骤。

您也可以参考下：通话类应用自动和手动切换音频输出设备问题。

更多关于HarmonyOS鸿蒙Next中AVCastPicker组件需要切换音乐用途的音频输出设备的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在HarmonyOS Next中，AVCastPicker组件用于媒体投播控制。要切换音乐用途的音频输出设备，需使用AVSession框架。通过AVSessionManager获取音频输出设备列表，并调用AVSession的selectOutputDevice方法指定目标设备。设备筛选可通过AudioDeviceDescriptor中的usage属性（如MEDIA）实现。

在HarmonyOS Next中，AVCastPicker组件目前主要设计用于媒体播放场景，其音频路由策略与音频流的用途（StreamUsage）紧密相关。根据你的描述和测试，当使用STREAM_USAGE_VOICE_COMMUNICATION（通话音量）时，AVCastPicker可以正常切换音频输出设备，这是因为该用途通常关联到系统通话或实时通信路由，系统允许其输出设备被动态切换。

而使用STREAM_USAGE_MUSIC（音乐音量）时无法切换，是因为在当前的音频管理策略中，音乐流默认被视为主媒体播放用途，其输出设备通常在音频会话创建时被确定，并且默认绑定到系统首选设备（如扬声器或有线耳机），AVCastPicker可能未针对此用途开放设备切换控制。

针对你的需求：需要让App能选择使用通话音量或音乐音量，并能在播放时切换输出设备。
建议的解决思路是：

  1. 明确音频用途与设备切换的关系
    如果你的应用场景更接近媒体播放（如音乐、播客），应优先使用STREAM_USAGE_MUSIC，但需注意当前AVCastPicker对此用途的支持限制。如果必须切换设备，可考虑在创建AudioRenderer时尝试结合audio.StreamUsage.STREAM_USAGE_MEDIA（若适用）或检查是否可通过音频会话属性（AudioSessionInfo）动态调整输出路由。

  2. 使用通话音量作为备选方案
    如果业务允许，当需要切换设备时，可临时采用STREAM_USAGE_VOICE_COMMUNICATION作为音频用途，但需注意通话音量通常关联系统通话音频策略（如可能启用回声抑制），可能对音乐播放音质产生影响。

  3. 通过音频管理API直接控制输出设备
    如果AVCastPicker无法满足需求，可考虑通过audio.AudioManager或相关音频路由API（如audio.AudioRoutingManager）主动获取可用设备列表，并通过AudioRenderer的会话信息动态切换输出目标。例如：

    • 使用audio.getAudioManager()获取管理器实例。
    • 通过AudioRoutingManager查询可用输出设备（如听筒、扬声器、蓝牙设备）。
    • 在创建或播放过程中，通过AudioRenderer的会话ID或属性设置输出设备。

  4. 关注HarmonyOS版本更新
    AVCastPicker的功能可能随版本迭代扩展，建议关注官方文档或更新日志，查看是否后续版本会增加对STREAM_USAGE_MUSIC的设备切换支持。

由于当前AVCastPicker对音乐用途的支持有限，若上述方法仍无法解决，可能需要结合音频路由管理API实现自定义设备切换逻辑，同时确保应用音频用途符合业务场景。

回到顶部