实时音视频
实时音视频
文档指南
请输入
实时音视频
快速入门
场景方案
开发指南
Token 鉴权
音频管理
视频管理
屏幕共享
SDK 升级指南
客户端 API 参考
服务端 API 参考
房间管理
转推直播
输入在线媒体流
WTN 流（原公共流）
实时数据监控
历史数据查询
业务标识管理
实时消息通信
历史版本（文档停止维护）
2023-08-01
2023-06-01
转推直播
2022-06-01
2020-12-01
转推直播
输入在线媒体流
获取数据指标
常见问题
集成相关
质量相关
AI 音视频互动方案
开始使用
开发指南
API 参考
硬件对话智能体
用户指南
服务端 API
智能体
实时信令
互动白板
客户端 API 参考
服务端 API 参考
- 文档首页
实时音视频实时音视频场景方案语音聊天室场景搭建（Android）
复制全文
下载 pdf场景搭建（Android）
文档反馈
问问助手SDK集成
整体实现流程
整体业务流程图
- 房主可以邀请观众上麦、下麦嘉宾、封锁麦位。
- 房主可以播放背景音乐、修改音乐音量、人声音量。
- 房主可以开关观众连线申请开关。开启开关后，观众申请上麦需要房主同意。
- 观众可以申请上麦、下麦。
核心功能实现
创建/加入房间模块
时序图
示例代码
public void joinRoom(String roomId, String token, String userId, boolean isHost) {
// 初始化 RTCVideo 对象
mRTCVideo = RTCVideo.createRTCVideo(applicationContext, appId,
mRTCVideoEventHandler, null, null);
// 初始化 RTCRoom 对象
mRTCRoom = mRTCVideo.createRTCRoom(roomId);
mRTCRoom.setRTCRoomEventHandler(mRTCRoomEventHandler);
// 主播开启麦克风采集，观众关闭麦克风采集
if (isHost) {
mRTCVideo.startAudioCapture();
} else {
mRTCVideo.stopAudioCapture();
}
// 设置音频路由模式
mRTCVideo.setDefaultAudioRoute(AudioRoute.AUDIO_ROUTE_SPEAKERPHONE);
// 开启发言者音量监听
AudioPropertiesConfig config = new AudioPropertiesConfig(300);
mRTCVideo.enableAudioPropertiesReport(config);
// 设置主播为可见状态，设置观众为隐身状态
mRTCRoom.setUserVisibility(isHost);
// 加入房间，开始连麦需要申请AppId和Token
UserInfo userInfo = new UserInfo(userId, null);
// 为了保证更好的语音聊天体验，profile 建议设置为 CHANNEL_PROFILE_CHAT_ROOM
RTCRoomConfig roomConfig = new RTCRoomConfig(ChannelProfile.CHANNEL_PROFILE_CHAT_ROOM,
true, true, false);
mRTCRoom.joinRoom(token, userInfo, roomConfig);
}
private final IRTCRoomEventHandler mRTCRoomEventHandler = new IRTCRoomEventHandler() {
/**
* 收到 RTC 加入房间结果
*/
@Override
public void onRoomStateChanged(String roomId, String uid, int state, String extraInfo) {
super.onRoomStateChanged(roomId, uid, state, extraInfo);
}
};
private final IRTCVideoEventHandler mRTCVideoEventHandler = new IRTCVideoEventHandler() {
/**
* 本地用户音量回调
*
* @param audioPropertiesInfos 本地音频信息
*/
@Override
public void onLocalAudioPropertiesReport(LocalAudioPropertiesInfo[] audioPropertiesInfos) {
super.onLocalAudioPropertiesReport(audioPropertiesInfos);
}
/**
* 远端用户音量回调
*
* @param audioPropertiesInfos 远端音频信息，其中包含音频流属性、房间 ID、用户 ID
* @param totalRemoteVolume 订阅的所有远端流混音后的总音量
*/
@Override
public void onRemoteAudioPropertiesReport(RemoteAudioPropertiesInfo[] audioPropertiesInfos, int totalRemoteVolume) {
super.onRemoteAudioPropertiesReport(audioPropertiesInfos, totalRemoteVolume);
}
}
高音质
上麦模块
时序图
示例代码
// 观众上麦/下麦
public void makeCoHost(boolean isCoHost) {
if (isCoHost) {
mRTCVideo.startAudioCapture();
mRTCRoom.setUserVisibility(true);
mRTCRoom.publishStream(MediaStreamType.RTC_MEDIA_STREAM_TYPE_AUDIO);
} else {
mRTCVideo.stopAudioCapture();
mRTCRoom.setUserVisibility(false);
mRTCRoom.unpublishStream(MediaStreamType.RTC_MEDIA_STREAM_TYPE_AUDIO);
}
}
背景音乐
时序图
示例代码
/**
* 设置背景音乐
* @param filePath 混音文件路径
*/
public void startBackgroundMusic(String filePath) {
// 获取 IMediaPlayer 对象
IMediaPlayer player = mRTCVideo.getMediaPlayer(0);
// 开启混音播放
player.open(filePath，new MediaPlayerConfig(AUDIO_MIXING_TYPE_PLAYOUT_AND_PUBLISH, -1));
}
/**
* 设置音频采集音量
* @param volume 采集的音量值和原始音量的比值。范围为 `[0, 400]`，建议范围是 `[0, 100]`。
*/
public void setRecordingVolume(int volume) {
// 设置麦克风采集音量
mRTCVideo.setCaptureVolume(StreamIndex.STREAM_INDEX_MAIN, volume);
}
/**
* 设置混音音量
* @param volume 混音音量相对原音量的比值。范围为 `[0, 400]`，建议范围是 `[0, 100]`。
*/
public void setMusicVolume(int volume) {
// 获取 IMediaPlayer 对象
IMediaPlayer player = mRTCVideo.getMediaPlayer(0);
player.setVolume(progress,AUDIO_MIXING_TYPE_PLAYOUT_AND_PUBLISH);
}
核心功能 API 与回调参考
API
技术逻辑 | API |
技术逻辑 | API |
创建 ByteRTCVideo 实例 | createRTCVideo |
创建 ByteRTCRoom 实例 | |
开启麦克风采集 | |
关闭麦克风采集 | |
设置音频路由模式 | |
开启发言者音量监听 | |
设置用户可见性 | |
加入 RTC 房间 | |
离开 RTC 房间 | leaveRoom |
销毁房间对象 | |
混音管理接口创建 | |
开启混音播放 | open |
设置混音音量 | |
设置麦克风采集音量 |
回调
技术逻辑 | CallBack |
技术逻辑 | CallBack |
本地用户加入 RTC 回调 | |
远端用户加入 RTC 回调 | |
本地用户音量回调 | |
远端用户音量回调 |
最近更新时间：2026.09.22 14:41:50
这个页面对您有帮助吗？
有用
有用
无用
无用