# 实现音频进阶功能 (/zh-CN/solutions/chatroom/sdk/build/set-audio) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). <_PlatformTabsGroup> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="android" /> 本文介绍语聊房解决方案中常用的进阶功能。实现进阶功能前,请确保你已实现基础的语聊房功能,例如登录即时通讯系统、获取房间列表、创建房间、加入房间。详见[实现语聊房](/zh-CN/solutions/chatroom/sdk/build/quick-integration)。 ## 设置高音质 [#设置高音质] 高音质会给语聊房带来更好的音频体验。专业的音频直播间需要主播使用声卡进行音频采集,以获取更好的语音效果。你可以参考如下示例代码,调用声网实时互动 SDK 中的 [`setAudioProfile`](/zh-CN/api-reference/rtc/android/audio/audio-basic#api_irtcengine_setaudioprofile2)、[`setAudioScenario`](/zh-CN/api-reference/rtc/android/audio/audio-basic#api_irtcengine_setaudioscenario)、[`setParameters`](/zh-CN/api-reference/rtc/android/network#api_irtcengine_setparameters) 方法来为专业直播和普通直播设置高音质: - (专业直播)当主播使用声卡采集音频时,设置高音质: ```kotlin setAudioProfile(Constants.MUSIC_HIGH_QUALITY_STEREO) setAudioScenario(Constants.AUDIO_SCENARIO_GAME_STREAMING) setParameters("{\"che.audio.enable.aec\":false}") setParameters("{\"che.audio.enable.ns\":false}") setParameters("{\"che.audio.enable.agc\":false}") // 如果用户设备含有 Web 端, 则需删除下一行代码 // 下一行代码设置的音频格式会让 Web 端出现音频解析问题 setParameters("{\"che.audio.custom_payload_type\":78}") setParameters("{\"che.audio.custom_bitrate\":128000}") setParameters("{\"che.audio.input_channels\":2}") ``` - (普通直播)当主播未使用声卡采集音频时,设置高音质: ```kotlin setAudioProfile(Constants.MUSIC_HIGH_QUALITY_STEREO) setAudioScenario(Constants.AUDIO_SCENARIO_GAME_STREAMING) setParameters("{\"che.audio.custom_bitrate\":128000}") // 如果用户设备含有 Web 端, 则需删除下一行代码 // 下一行代码设置的音频格式会让 Web 端出现音频解析问题 setParameters("{\"che.audio.custom_payload_type\":78}") ``` :::info[信息] 上述高音质设置仅适用于语聊房。如果在其他场景解决方案中需要设置高音质,可以[联系技术支持](https://ticket.shengwang.cn)。 ::: ## 播放背景音乐和音效 [#播放背景音乐和音效] 播放背景音乐和音效可以活跃语聊房内的气氛。本节介绍如何在语聊房中播放多种来源的音乐: - 本地音乐文件或在线音乐文件。 - 声网在 GitHub 上提供开源示例项目的版权音乐。 - 第三方厂商提供的版权音乐。 ### 本地音乐文件或在线音乐文件 [#本地音乐文件或在线音乐文件] 如果主播使用的音乐文件是本地文件或在线文件,播放方式有如下两种: - 调用声网实时互动 SDK 中的 [`startAudioMixing`](/zh-CN/api-reference/rtc/android/play/audio-mixing#api_irtcengine_startaudiomixing2) 方法播放文件。 - 使用声网实时互动 SDK 中的[内置媒体播放器](/zh-CN/realtime-media/rtc/build/audio/media-player)来播放文件。 ### 声网版权音乐 [#声网版权音乐] 声网和[中国音像著作权集体管理协会](https://www.cavca.org)合作提供了数十万首热门歌曲。声网支持你在语聊房和直播间播放有版权的背景音乐。你可以参考如下步骤使用声网版权音乐来给语聊房增加趣味性: 1. 联系 sales@shengwang.cn 开通声网版权音乐和内容中心服务。 2. 在你的业务服务器中,通过 RESTful API 向声网内容中心获取歌曲详细信息,并将信息保存在你的服务端。详见[声网内容中心 RESTful API](/zh-CN/solutions/online-ktv/ktv-scenario/build/extend-karaoke/get-music)。 3. 在你的业务客户端中,增加歌曲搜索和点歌的功能。当用户点击播放某首歌曲时,你需要获得歌曲的 `SongCode`(标识音乐资源的编号),然后通过声网实时互动 SDK 中的[版权音乐 API](/zh-CN/api-reference/rtc/android/play/drm#toc_drm) 预加载歌曲,再通过声网实时互动 SDK 中的[内置媒体播放器](/zh-CN/realtime-media/rtc/build/audio/media-player)播放歌曲。详见[点歌](/zh-CN/solutions/online-ktv/ktv-scenario/build/extend-karaoke/get-music)。 4. 如果需要展示歌词,你可以通过版权音乐 API 和 `SongCode` 来获取歌词文件地址,获取后你就可以展示歌词。详见[歌词打分组件](/zh-CN/solutions/online-ktv/ktv-scenario/build/extend-karaoke/lyrics-scoring)。 ### 第三方版权音乐 [#第三方版权音乐] 你还可以在语聊房中使用第三方厂商提供的版权音乐,例如[腾讯正版曲库直通车 (AME)](https://cloud.tencent.com/product/ame)。参考如下步骤在语聊房中播放第三方版权音乐: 1. 在你的业务客户端中,通过第三方版权音乐 SDK 实现歌曲搜索、点歌功能。当用户选中歌曲播放时,你需要使用第三方版权音乐 SDK 对音乐进行解码,但不进行播放。 2. 通过第三方版权音乐 SDK 的原始音频数据 API,获取 PCM 格式的原始音频数据。 3. 通过[声网音频自采集功能](/zh-CN/realtime-media/rtc/build/audio/custom-audio-source)将你之前获取的原始音频数据发送给声网实时互动 SDK。声网实时互动 SDK 内部会自动将麦克风采集到的声音和第三方版权音乐的歌曲声混合,并发送到声网 RTC 频道中,频道内的听众都可以听到这个混音。 :::info[信息] 在自采集音频时,你需要将 [`createCustomAudioTrack`](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#createcustomaudiotrack) 方法中的 `enableLocalPlayback` 字段设置为 `true`,以使第三方音频可以在本地播放。 ::: ## 增加音量波纹提示 [#增加音量波纹提示] 语聊房中的音量波纹提示功能可以让房间的听众看到谁正在发言。该功能的实现流程如下: 1. 调用声网实时互动 SDK 中的 [`enableAudioVolumeIndication`](/zh-CN/api-reference/rtc/android/audio/audio-basic#api_irtcengine_enableaudiovolumeindication) 方法启用音量提示功能,建议你在启用音量提示时设置音量提示时间间隔为 500 毫秒。 2. 你可以从 SDK 触发的 [`onAudioVolumeIndication`](/zh-CN/api-reference/rtc/android/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调获得本地和远端讲话者的音量信息。建议你在 `volume` 值大于 20 时给出音量提示并在 UI 上制作音量对应的波纹效果。 <_PlatformProcessedMarker close="true" /> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="ios" /> 本文介绍语聊房解决方案中常用的进阶功能。 实现进阶功能前,请确保你已实现基础的语聊房功能,例如登录即时通讯系统、获取房间列表、创建房间、加入房间。详见[实现语聊房](/zh-CN/solutions/chatroom/sdk/build/quick-integration)。 ## 设置高音质 [#设置高音质-1] 高音质会给语聊房带来更好的音频体验。专业的音频直播间需要主播使用声卡进行音频采集,以获取更好的语音效果。你可以参考如下示例代码,调用声网实时互动 SDK 中的 [`setAudioProfile`](/zh-CN/api-reference/rtc/ios/audio/audio-basic#api_irtcengine_setaudioprofile2)、[`setAudioScenario`](/zh-CN/api-reference/rtc/ios/audio/audio-basic#api_irtcengine_setaudioscenario)、[`setParameters`](/zh-CN/api-reference/rtc/ios/network#api_irtcengine_setparameters) 方法来为专业直播和普通直播设置高音质: - (专业直播)当主播使用声卡采集音频时,设置高音质: ```swift rtcKit.setAudioProfile(.musicHighQualityStereo) rtcKit.setAudioScenario(.gameStreaming) rtcKit.setParameters("{\"che.audio.enable.aec\":false}") rtcKit.setParameters("{\"che.audio.enable.ns\":false}") rtcKit.setParameters("{\"che.audio.enable.agc\":false}") // 如果用户设备含有 Web 端,则需删除下一行代码 // 下一行代码设置的音频格式会让 Web 端出现音频解析问题 rtcKit.setParameters("{\"che.audio.custom_payload_type\":78}") rtcKit.setParameters("{\"che.audio.custom_bitrate\":128000}") rtcKit.setParameters("{\"che.audio.input_channels\":2}") ``` - (普通直播)当主播未使用声卡采集音频时,设置高音质: ```swift rtcKit.setAudioProfile(.musicHighQualityStereo) rtcKit.setAudioScenario(.gameStreaming) rtcKit.setParameters("{\"che.audio.custom_bitrate\":128000}") // 如果用户设备含有 Web 端,则需删除下一行代码 // 下一行代码设置的音频格式会让 Web 端出现音频解析问题 rtcKit.setParameters("{\"che.audio.custom_payload_type\":78}") ``` :::info[信息] 上述高音质设置仅适用于语聊房。如果在其他场景解决方案中需要设置高音质,可以[联系技术支持](https://ticket.shengwang.cn)。 ::: ## 播放背景音乐和音效 [#播放背景音乐和音效-1] 播放背景音乐和音效可以活跃语聊房内的气氛。本节介绍如何在语聊房中播放多种来源的音乐: - 本地音乐文件或在线音乐文件 - 声网在 GitHub 上提供开源示例项目的版权音乐 - 第三方厂商提供的版权音乐 ### 本地音乐文件或在线音乐文件 [#本地音乐文件或在线音乐文件-1] 如果主播使用的音乐文件是本地文件或在线文件,播放方式有如下两种: - 调用声网实时互动 SDK 中的 [`startAudioMixing`](/zh-CN/api-reference/rtc/ios/play/audio-mixing#api_irtcengine_startaudiomixing2) 方法播放文件。 - 使用声网实时互动 SDK 中的[内置媒体播放器](/zh-CN/realtime-media/rtc/build/audio/media-player)播放文件。 ### 声网版权音乐 [#声网版权音乐-1] 声网和[中国音像著作权集体管理协会](https://www.cavca.org)合作提供了数十万首热门歌曲。声网支持你在语聊房和直播间播放有版权的背景音乐。你可以参考如下步骤使用声网版权音乐来给语聊房增加趣味性: 1. 联系 sales@shengwang.cn 开通声网版权音乐和内容中心服务。 2. 在你的业务服务器中,通过 RESTful API 向声网内容中心获取歌曲详细信息,并将信息保存在你的服务端。详见[声网内容中心 RESTful API](/zh-CN/solutions/online-ktv/ktv-scenario/build/extend-karaoke/get-music)。 3. 在你的业务客户端中,增加歌曲搜索和点歌的功能。当用户点击播放某首歌曲时,你需要获得歌曲的 `SongCode`(标识音乐资源的编号),然后通过声网实时互动 SDK 中的[版权音乐 API](/zh-CN/api-reference/rtc/ios/play/drm#toc_drm) 预加载歌曲,通过声网实时互动 SDK 中的[内置媒体播放器](/zh-CN/realtime-media/rtc/build/audio/media-player)播放歌曲。详见[点歌](/zh-CN/solutions/online-ktv/ktv-scenario/build/extend-karaoke/get-music)。 4. 如果需要展示歌词,你可以通过版权音乐 API 和 `SongCode` 来获取歌词文件地址,获取后你就可以展示歌词。详见[歌词打分组件](/zh-CN/solutions/online-ktv/ktv-scenario/build/extend-karaoke/lyrics-scoring)。 ### 第三方版权音乐 [#第三方版权音乐-1] 你还可以在语聊房中使用第三方厂商提供的版权音乐,例如[腾讯正版曲库直通车 (AME)](https://cloud.tencent.com/product/ame)。参考如下步骤在语聊房中播放第三方版权音乐: 1. 在你的业务客户端中,通过第三方版权音乐 SDK 实现歌曲搜索、点歌功能。当用户选中歌曲播放时,你需要使用第三方版权音乐 SDK 对音乐进行解码,但不进行播放。 2. 通过第三方版权音乐 SDK 的原始音频数据 API,获取 PCM 格式的原始音频数据。 3. 通过[声网音频自采集功能](/zh-CN/realtime-media/rtc/build/audio/custom-audio-source)将你之前获取的原始音频数据发送给声网实时互动 SDK。声网实时互动 SDK 内部会自动将麦克风采集到的声音和第三方版权音乐的歌曲声混合,并发送到声网 RTC 频道中,频道内的听众都可以听到这个混音。 :::info[信息] 在自采集音频时,你需要将 [`createCustomAudioTrack`](/zh-CN/api-reference/rtc/ios/audio/audio-custom-capturenrendering#api_irtcengine_createcustomaudiotrack) 方法中的 `enableLocalPlayback` 字段设置为 `true`,以使第三方音频可以在本地播放。 ::: ## 增加音量波纹提示 [#增加音量波纹提示-1] 语聊房中的音量波纹提示功能可以让房间的听众看到谁正在发言。该功能的实现流程如下: 1. 调用声网实时互动 SDK 中的 [`enableAudioVolumeIndication`](/zh-CN/api-reference/rtc/ios/audio/audio-basic#api_irtcengine_enableaudiovolumeindication) 方法启用音量提示功能,建议你在启用音量提示时设置音量提示时间间隔为 500 毫秒。 2. 你可以从 SDK 触发的 [`reportAudioVolumeIndicationOfSpeakers`](/zh-CN/api-reference/rtc/ios/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调获得本地和远端讲话者的音量信息。建议你在 `volume` 值大于 20 时给出音量提示并在 UI 上制作音量对应的波纹效果。 <_PlatformProcessedMarker close="true" />