- 动态与公告
- 产品简介
- 购买指南
- 新手指引
- 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）
- 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）
- 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 政策
- 词汇表
本文档主要介绍主播如何发布自己的音视频流，所谓“发布”，也就是打开麦克风和摄像头，让自己的声音和视频能够被房间中其他用户听到和看到的意思。
调用指引
步骤1：完成前序步骤
步骤2：打开摄像头预览
您可以调用 startLocalPreview 接口打开摄像头预览，此时 SDK 会向系统申请摄像头的使用权限，需要用户授权通过后才会开启摄像头的采集流程。
如果您希望设置本地画面的渲染参数，可以通过调用 setLocalRenderParams 接口来设置本地预览的渲染参数。为防止先开启预览再设置预览参数会出现画面跳动，如果您需要设置预览参数，推荐在开启预览之前调用。
如果您希望控制摄像头的各种控制参数，可以用过调用 TXDeviceManager 接口来完成“切换前后摄像头”、“设置对焦模式”、“打开、关闭闪光灯”等一系列操作。
// 设置本地画面的预览模式：开启左右镜像，设置画面为填充模式trtcCloud.setLocalRenderParams(TRTCRenderParams(fillMode: TRTCCloudDef.TRTC_VIDEO_RENDER_MODE_FILL mirrorType: TRTCCloudDef.TRTC_VIDEO_MIRROR_TYPE_ENABLE);// 启动本地摄像头的预览（viewId 是 TRTCCloudVideoView 创建过程中 onViewCreated 调用时给予的视图唯一标识符）trtcCloud.startLocalPreview(isFrontCamera, viewId);// 通过 TXDeviceManager 开启自动对焦并将闪光灯打开bool? isAutoFocusEnabled = await manager.isAutoFocusEnabled(); if (isAutoFocusEnabled ?? false) { manager.enableCameraAutoFocus(true); } manager.enableCameraTorch(true);
步骤3：打开麦克风采集
您可以调用 startLocalAudio 来开启麦克风采集，该接口需要您通过
quality 参数确定采集模式。虽然这个参数的名字叫做 quality，但并不是说质量越高越好，不同的业务场景有最适合的参数选择（这个参数更准确的含义是 scene）。TRTC_AUDIO_QUALITY_SPEECH
该模式下的 SDK 音频模块会专注于提炼语音信号，尽最大限度的过滤周围的环境噪音，同时该模式下的音频数据也会获得最好的差质量网络的抵抗能力，因此该模式特别适合于“视频通话”和“在线会议”等侧重于语音沟通的场景。
TRTC_AUDIO_QUALITY_MUSIC
该模式下的 SDK 会采用很高的音频处理带宽以及立体式模式，在最大限度地提升采集质量的同时也会将音频的 DSP 处理模块调节到最弱的级别，从而最大限度地保证音质。因此该模式适合“音乐直播”场景，尤其适合主播采用专业的声卡进行音乐直播的场景。
TRTC_AUDIO_QUALITY_DEFAULT
该模式下的 SDK 会启用智能识别算法来识别当前环境，并针对性地选择最佳的处理模式。不过再好的识别算法也总是有不准确的时候，如果您非常清楚自己的产品定位，更推荐您在专注语音通信的 SPEECH 和专注音乐音质的 MUSIC 之间二选一。
// 开启麦克风采集，并设置当前场景为：语音模式（高噪声抑制能力、强弱网络抗性）trtcCloud.startLocalAudio(TRTCCloudDef.TRTC_AUDIO_QUALITY_SPEECH );// 开启麦克风采集，并设置当前场景为：音乐模式（高保真采集、低音质损失，推荐配合专业声卡使用）trtcCloud.startLocalAudio(TRTCCloudDef.TRTC_AUDIO_QUALITY_MUSIC);
步骤4：进入 TRTC 房间
注意：
当然，您可以在进入房间（enterRoom）后再启动摄像头预览和麦克风采集，不过在直播场景下，我们需要先给主播一个测试麦克风和调整美颜的时间，所以更常见的做法是先启动摄像头和麦克风再进入房间。
// 创建 TRTCCloud 单例 trtcCloud = (await TRTCCloud.sharedInstance())!; // 注册 TRTC 事件回调 trtcCloud.registerListener(onRtcListener);enterRoom() async { try { userInfo['userSig'] = await GenerateTestUserSig.genTestSig(userInfo['userId']); meetModel.setUserInfo(userInfo); } catch (err) { userInfo['userSig'] = ''; print(err); }// 如果您的场景为“互动视频直播”，请将场景设置为 TRTC_APP_SCENE_LIVE，并在TRTCParams中为role字段设置相应的值。 await trtcCloud.enterRoom( TRTCParams( sdkAppId: GenerateTestUserSig.sdkAppId, userId: userInfo['userId'], userSig: userInfo['userSig'], role: TRTCCloudDef.TRTCRoleAnchor, roomId: meetId!), TRTCCloudDef.TRTC_APP_SCENE_LIVE); }
步骤5：角色和角色的切换
TRTC 中的“角色”
在“视频通话”（TRTC_APP_SCENE_VIDEOCALL ） 和 “语音通话”（TRTC_APP_SCENE_AUDIOCALL）这两个场景中，您无需要在进入房间时设置角色，因为在这两个模式下每个用户默认都是主播（Anchor）。
在“视频直播”（TRTC_APP_SCENE_LIVE） 和 “语音直播”（TRTC_APP_SCENE_VOICE_CHATROOM）这两个场景中，每个用户在进入房间时都需要指定自己的“角色”，要么是“主播（Anchor）”，要么是“观众（Audience）”。
角色的切换
在 TRTC 中，只有“主播（Anchor）”才有权限发布音视频流，“观众（Audience）”是不能发布音视频流的。
因此，如果您在进房时使用的角色是“观众（Audience）”，需要先调用 switchRole 接口将角色切换成“主播（Anchor）”，才能发布音视频流（也就是俗称的“上麦”）。
// 如果您当前的角色是观众（Audience），需要先调用 switchRole 切换到主播（Anchor）// If your current role is 'audience', you need to call switchRole to switch to 'anchor' firsttrtcCloud.switchRole(TRTCCloudDef.TRTCRoleAnchor);trtcCloud.startLocalAudio(TRTCCloudDef.TRTC_AUDIO_QUALITY_DEFAULT);trtcCloud.startLocalPreview(true, cameraVideo);// 如果切换角色失败，onSwitchRole 回调的错误码便不是 0// If switching operation failed, the error code of the 'onSwitchRole' is not zeroonRtcListener(type, param) async { if (type == TRTCCloudListener.onSwitchRole) { if (param['errCode'] ！= 0) { // TO DO } } }
注意：
如果房间中已有的主播已经太多，会导致 switchRole 角色切换失败，并通过 TRTC 的 onSwitchRole 将错误码回调通知您。所以，当您不再需要发布音视频流（也就是俗称的“下麦”）时，就需要您再次调用 switchRole 并切换为“观众（Audience）”。
说明：
进阶指引
1. 一个房间中同时最多可以有多少路音频和视频？
一个 TRTC 房间中最多允许同时有 50 路音视频流，超出的音视频流会按照“先到先得”的原则被放弃掉。
在绝大多数场景下，小到两个人之间的视频通话，大到几万人同时观看的在线直播，50 路的音视频流都能满足应用场景的需求，但前提是您要做好角色管理。
所谓的“角色管理”就是您需要为进入房间的用户分配角色。
如果一个用户本身就是直播场景中的“主播”，或者是在线教育场景中的“老师”，抑或是在线会议场景中的“主持人”，都可以分配给“主播（Anchor）”这个角色。
如果一个用户本身就是直播场景中的“观众”，或者是在线教育场景中的“学生”，抑或是在线会议场景中的“旁听者”，应当分配为“观众（Audience）”这个角色，否则他们庞大的人数会瞬间将主播的人数限制“挤爆”。
只有当“观众”需要发布音视频流（“上麦”）时，才需要通过 switchRole 切换成“主播”角色，等不再需要发布音视频流（“下麦”）时，则需要立刻切回观众角色。
通过合理得角色管理，您会发现房间中同时需要发布音视频流的“主播”是通常不会超过 50 路的，否则整个房间中就会“乱糟糟”，毕竟同时说话的人声一旦超过 6 路，普通人就很难从声音中辨识出当前究竟是谁在说话了。
是
否
本页内容是否解决了您的问题？