- 动态与公告
- 产品简介
- 购买指南
- 新手指引
- Demo 体验
- 视频通话（含 UI）
- 组件介绍（TUICallKit）
- 开通服务（TUICallKit）
- 跑通 Demo（TUICallKit）
- 快速接入（TUICallKit）
- Chat 集成通话能力（TUICallKit）
- 界面定制（TUICallKit）
- 离线唤醒（TUICallKit）
- AI 降噪（TUICallKit）
- 虚拟背景（TUICallKit）
- 会话聊天（TUICallKit）
- 云端录制（TUICallKit）
- 更多特性（TUICallKit）
- 解决方案（TUICallKit）
- 服务端 API（TUICallKit）
- 客户端 API（TUICallKit）
- 错误码表（TUICallkit）
- 发布日志（TUICallKit）
- 常见问题（TUICallKit）
- 多人会议（含 UI）
- 组件介绍（TUIRoomKit）
- 开通服务（TUIRoomKit）
- 跑通 Demo（TUIRoomKit）
- 快速接入（TUIRoomKit）
- 屏幕共享（TUIRoomKit）
- 预定会议（TUIRoomKit）
- 会中呼叫（TUIRoomKit）
- 界面定制（TUIRoomKit）
- 虚拟背景（TUIRoomKit）
- 会议控制（TUIRoomKit）
- 云端录制（TUIRoomKit）
- AI 降噪（TUIRoomKit）
- 会中聊天（TUIRoomKit）
- 机器人推流（TUIRoomKit）
- 更多特性（TUIRoomKit）
- 客户端 API（TUIRoomKit）
- 服务端 API（TUIRoomKit）
- 常见问题（TUIRoomKit）
- 错误码 (TUIRoomKit)
- SDK更新日志（TUIRoomKit）
- 在线直播（含 UI）
- Live 视频直播计费说明
- 组件介绍（TUILiveKit）
- 开通服务（TUILiveKit）
- 跑通 Demo（TUILiveKit）
- 快速接入（TUILiveKit）
- 界面定制（TUILiveKit）
- 开播和观看（TUILiveKit）
- 房间列表（TUILiveKit）
- 关注主播（TUILiveKit）
- 主播连线（TUILiveKit）
- 主播 PK（TUILiveKit）
- 观众连麦（TUILiveKit）
- 互动弹幕（TUILiveKit）
- 互动礼物（TUILiveKit）
- 礼物特效（TUILiveKit）
- 美颜特效（TUILiveKit）
- 悬浮窗（TUILiveKit）
- 客户端 API（TUILiveKit）
- 服务端 API（TUILiveKit）
- 错误码（TUILiveKit）
- 发布日志（TUILiveKit）
- 常见问题（TUILiveKit）
- 语音聊天室（含 UI）
- 无 UI 集成
- 高级功能
- 服务端 API
- 控制台指南
- 解决方案
- 常见问题
- 旧版文档
- 协议与策略
- TRTC 政策
- 词汇表
- 动态与公告
- 产品简介
- 购买指南
- 新手指引
- Demo 体验
- 视频通话（含 UI）
- 组件介绍（TUICallKit）
- 开通服务（TUICallKit）
- 跑通 Demo（TUICallKit）
- 快速接入（TUICallKit）
- Chat 集成通话能力（TUICallKit）
- 界面定制（TUICallKit）
- 离线唤醒（TUICallKit）
- AI 降噪（TUICallKit）
- 虚拟背景（TUICallKit）
- 会话聊天（TUICallKit）
- 云端录制（TUICallKit）
- 更多特性（TUICallKit）
- 解决方案（TUICallKit）
- 服务端 API（TUICallKit）
- 客户端 API（TUICallKit）
- 错误码表（TUICallkit）
- 发布日志（TUICallKit）
- 常见问题（TUICallKit）
- 多人会议（含 UI）
- 组件介绍（TUIRoomKit）
- 开通服务（TUIRoomKit）
- 跑通 Demo（TUIRoomKit）
- 快速接入（TUIRoomKit）
- 屏幕共享（TUIRoomKit）
- 预定会议（TUIRoomKit）
- 会中呼叫（TUIRoomKit）
- 界面定制（TUIRoomKit）
- 虚拟背景（TUIRoomKit）
- 会议控制（TUIRoomKit）
- 云端录制（TUIRoomKit）
- AI 降噪（TUIRoomKit）
- 会中聊天（TUIRoomKit）
- 机器人推流（TUIRoomKit）
- 更多特性（TUIRoomKit）
- 客户端 API（TUIRoomKit）
- 服务端 API（TUIRoomKit）
- 常见问题（TUIRoomKit）
- 错误码 (TUIRoomKit)
- SDK更新日志（TUIRoomKit）
- 在线直播（含 UI）
- Live 视频直播计费说明
- 组件介绍（TUILiveKit）
- 开通服务（TUILiveKit）
- 跑通 Demo（TUILiveKit）
- 快速接入（TUILiveKit）
- 界面定制（TUILiveKit）
- 开播和观看（TUILiveKit）
- 房间列表（TUILiveKit）
- 关注主播（TUILiveKit）
- 主播连线（TUILiveKit）
- 主播 PK（TUILiveKit）
- 观众连麦（TUILiveKit）
- 互动弹幕（TUILiveKit）
- 互动礼物（TUILiveKit）
- 礼物特效（TUILiveKit）
- 美颜特效（TUILiveKit）
- 悬浮窗（TUILiveKit）
- 客户端 API（TUILiveKit）
- 服务端 API（TUILiveKit）
- 错误码（TUILiveKit）
- 发布日志（TUILiveKit）
- 常见问题（TUILiveKit）
- 语音聊天室（含 UI）
- 无 UI 集成
- 高级功能
- 服务端 API
- 控制台指南
- 解决方案
- 常见问题
- 旧版文档
- 协议与策略
- TRTC 政策
- 词汇表
本文档主要介绍如何使用
RTC Room Engine SDK 实现 音频设置相关功能。前提条件
使用指引
开启/关闭本地麦克风
您可以分别通过调用
openLocalMicrophone和closeLocalMicrophone两个接口，来开启或关闭您本地的麦克风。在调用
openLocalMicrophone开启麦克风时，需要传入一个TUIAudioQuality 类型的参数 quality以设置音频编码质量，TUIAudioQuality包含以下类型，您可以根据您的业务需求进行选择：枚举值类型 | 含义 |
speech | 人声模式。单声道；音频裸码率：18kbps；适合语音通话为主的场景。 |
default | 默认模式。单声道；音频裸码率：50kbps；SDK 默认的音频质量，如无特殊需求推荐选择之。 |
music | 音乐模式。双声道 + 全频带；音频裸码率：128kbps；适合需要高保真传输音乐的场景，比如在线K歌、音乐直播等。 |
您可以分别通过调用
openLocalMicrophone和closeLocalMicrophone两个接口，来开启或关闭您本地的麦克风。在调用
openLocalMicrophone开启麦克风时，需要传入一个AudioQuality 类型的参数 quality以设置音频编码质量，AudioQuality包含以下类型，您可以根据您的业务需求进行选择：枚举值类型 | 含义 |
SPEECH | 人声模式。单声道；音频裸码率：18kbps；适合语音通话为主的场景。 |
DEFAULT | 默认模式。单声道；音频裸码率：50kbps；SDK 默认的音频质量，如无特殊需求推荐选择之。 |
MUSIC | 音乐模式。双声道 + 全频带；音频裸码率：128kbps；适合需要高保真传输音乐的场景，比如在线K歌、音乐直播等。 |
下面以默认模式为例，提供了开启本地麦克风和关闭本地麦克风的示例代码。
import RTCRoomEnginelet roomEngine = TUIRoomEngine.sharedInstance()// 开启本地麦克风roomEngine.openLocalMicrophone(.default) {// 开启麦克风成功} onError: { code, message in// 开启麦克风失败}// 关闭本地麦克风roomEngine.closeLocalMicrophone()
TUIRoomEngine roomEngine = TUIRoomEngine.sharedInstance();// 开启本地麦克风roomEngine.openLocalMicrophone(TUIRoomDefine.AudioQuality.DEFAULT, new TUIRoomDefine.ActionCallback() {@Overridepublic void onSuccess() {// 开启麦克风成功}@Overridepublic void onError(TUICommonDefine.Error error, String message) {// 开启麦克风失败}});// 关闭本地麦克风roomEngine.closeLocalMicrophone();
更新本地音频编码质量
更新本地音频编码质量时，需要传入的参数类型
TUIAudioQuality 与上文中提到的相同。下面以默认模式为例，调用updateAudioQuality接口更新本地音频的编码质量：import RTCRoomEnginelet audioQuality: TUIAudioQuality = .defaultTUIRoomEngine.sharedInstance().updateAudioQuality(audioQuality)
更新本地音频编码质量时，需要传入的参数类型
AudioQuality 与上文中提到的相同。下面以默认模式为例，调用updateAudioQuality接口更新本地音频的编码质量：TUIRoomDefine.AudioQuality audioQuality = TUIRoomDefine.AudioQuality.DEFAULT;TUIRoomEngine.sharedInstance().updateAudioQuality(audioQuality);
暂停/恢复发布本地音频流
当您在直播间内时，您可能需要暂停/恢复发布您的本地音频流，您可以通过调用以下接口来实现：
import RTCRoomEnginelet roomEngine = TUIRoomEngine.sharedInstance()// 暂停发布本地音频流roomEngine.muteLocalAudio()// 恢复发布本地音频流roomEngine.unmuteLocalAudio() {// 恢复发布成功} onError: { code, message in// 恢复发布失败}
TUIRoomEngine roomEngine = TUIRoomEngine.sharedInstance();// 暂停发布本地音频流roomEngine.muteLocalAudio();// 恢复发布本地音频流roomEngine.unmuteLocalAudio(new TUIRoomDefine.ActionCallback() {@Overridepublic void onSuccess() {// 恢复发布成功}@Overridepublic void onError(TUICommonDefine.Error error, String message) {// 恢复发布失败}});
说明：
是
否
本页内容是否解决了您的问题？