TRTCMeeting 是基于腾讯云实时音视频（TRTC）和即时通信 IM 服务组合而成的，支持以下功能：

• 主持人创建会议房间，参会人员输入房间号后进入会议。
• 参会人员之间进行屏幕分享。
• 支持发送各种文本消息和自定义消息。

TRTCMeeting 是一个开源的 Class，依赖腾讯云的两个闭源 SDK，具体的实现过程请参见 多人视频会议(Android)。

• TRTC SDK：使用 TRTC SDK 作为低延时视频会议组件。
• IM SDK：使用 IM SDK 的 MeetingRoom 实现会议中聊天室的功能。

TRTCMeeting API 概览

SDK 基础函数

会议房间相关接口函数

远端用户相关接口

本地视频操作接口

本地音频操作接口

录屏接口

美颜滤镜相关接口函数

分享相关接口

消息发送相关接口函数

TRTCMeetingDelegate API 概览

通用事件回调

会议房间事件回调

成员进出事件回调

成员音视频事件回调

消息事件回调

录屏事件回调

SDK 基础函数

sharedInstance

获取 TRTCMeeting 单例对象。

public static synchronized TRTCMeeting sharedInstance(Context context);

参数如下表所示：

destroySharedInstance

销毁 TRTCMeeting 单例对象。

说明：

销毁实例后，外部缓存的 TRTCMeeting 实例无法再使用，需要重新调用 sharedInstance 获取新实例。

public static void destroySharedInstance();

setDelegate

TRTCMeeting 事件回调，您可以通过 TRTCMeetingDelegate 获得 TRTCMeeting 的各种状态通知。

public abstract void setDelegate(TRTCMeetingDelegate delegate);

说明：

setDelegate 是 TRTCMeeting 的代理回调。

setDelegateHandler

设置事件回调所在的线程。

public abstract void setDelegateHandler(Handler handler);

参数如下表所示：

login

登录。

public abstract void login(int sdkAppId,
 String userId, String userSig,
 TRTCMeetingCallback.ActionCallback callback);

参数如下表所示：

logout

登出。

public abstract void logout(TRTCMeetingCallback.ActionCallback callback);

参数如下表所示：

setSelfProfile

修改个人信息。

public abstract void setSelfProfile(String userName, String avatarURL, TRTCMeetingCallback.ActionCallback callback);

参数如下表所示：

会议房间相关接口函数

createMeeting

创建会议（主持人调用）。

public abstract void createMeeting(int roomId, TRTCMeetingCallback.ActionCallback callback);

参数如下表所示：

主持人正常调用流程如下：

1. 【主持人】调用 createMeeting() 创建会议，会议房间创建成功与否会通过 ActionCallback 通知给主持人。
2. 【主持人】调用 startCameraPreview() 打开摄像头预览，此时可以调整美颜参数。
3. 【主持人】调用 startMicrophone() 打开麦克风采集。

destroyMeeting

销毁会议房间（主持人调用）。主持人在创建会议后，可以调用该函数来销毁会议。

public abstract void destroyMeeting(int roomId, TRTCMeetingCallback.ActionCallback callback);

参数如下表所示：

enterMeeting

进入会议（参会成员调用）。

public abstract void enterMeeting(int roomId, TRTCMeetingCallback.ActionCallback callback);

参数如下表所示：

参会成员进入会议的正常调用流程如下：

1. 【参会成员】调用enterMeeting并传入 roomId 即可进入会议房间。
2. 【参会成员】调用 startCameraPreview() 打开摄像头预览，调用 startMicrophone() 打开麦克风采集。
3. 【参会成员】收到onUserVideoAvailable的事件，调用startRemoteView(userId)并传入成员的 userId 开始播放。

leaveMeeting

离开会议（参会成员调用）。

public abstract void leaveMeeting(TRTCMeetingCallback.ActionCallback callback);

参数如下表所示：

远端用户相关接口

getUserInfoList

获取房间内所有的人员列表，enterMeeting() 成功后调用才有效。

public abstract void getUserInfoList(TRTCMeetingCallback.UserListCallback userListCallback);

参数如下表所示：

getUserInfo

获取房间内指定人员的详细信息，enterMeeting() 成功后调用才有效。

public abstract void getUserInfo(String userId, TRTCMeetingCallback.UserListCallback userListCallback);

参数如下表所示：

startRemoteView

播放指定成员的远端视频画面。在 onUserVideoAvailable() 为true回调时，调用该接口。

public abstract void startRemoteView(String userId, TXCloudVideoView view, final TRTCMeetingCallback.ActionCallback callback);

参数如下表所示：

stopRemoteView

停止播放远端视频画面。在 onUserVideoAvailable() 为false回调时，调用该接口。

public abstract void stopRemoteView(String userId, final TRTCMeetingCallback.ActionCallback callback);

参数如下表所示：

setRemoteViewFillMode

根据用户id和设置远端图像的渲染模式。

public abstract void setRemoteViewFillMode(String userId, int fillMode);

参数如下表所示：

setRemoteViewRotation

设置远端图像的顺时针旋转角度。

public abstract void setRemoteViewRotation(String userId, int rotation);

参数如下表所示：

muteRemoteAudio

静音远端音频。

public abstract void muteRemoteAudio(String userId, boolean mute);

参数如下表所示：

muteRemoteVideoStream

屏蔽指定成员的视频流。

public abstract void muteRemoteVideoStream(String userId, boolean mute);

参数如下表所示：

本地视频操作接口

startCameraPreview

开启本地视频的预览画面。

public abstract void startCameraPreview(boolean isFront, TXCloudVideoView view);

参数如下表所示：

stopCameraPreview

停止本地视频采集及预览。

public abstract void stopCameraPreview();

switchCamera

切换前后摄像头

public abstract void switchCamera(boolean isFront);

参数如下表所示：

setVideoResolution

设置分辨率

public abstract void setVideoResolution(int resolution);

参数如下表所示：

setVideoFps

设置帧率

public abstract void setVideoFps(int fps);

参数如下表所示：

说明：

【推荐取值】 15fps或20fps，5fps以下，卡顿感明显。10fps以下，会有轻微卡顿感。20fps以上，则过于浪费（电影的帧率为24fps）。

setVideoBitrate

设置码率

public abstract void setVideoBitrate(int bitrate);

参数如下表所示：

说明：

【推荐取值】请参考本 TRTCVideoResolution 在各档位注释的最佳码率，也可以在此基础上适当调高。 例如 TRTC_VIDEO_RESOLUTION_1280_720 对应1200kbps的目标码率，您也可以设置为1500kbps以便获得更好的清晰度观感。

setLocalViewMirror

设置本地画面镜像预览模式

public abstract void setLocalViewMirror(int type);

参数如下表所示：

本地音频操作接口

startMicrophone

开启麦克风采集

public abstract void startMicrophone();

stopMicrophone

停止麦克风采集

public abstract void stopMicrophone();

setAudioQuality

设置音质

public abstract void setAudioQuality(int quality);

参数如下表所示：

muteLocalAudio

静音/取消静音本地的音频

public abstract void muteLocalAudio(boolean mute);

参数如下表所示：

setSpeaker

设置开启扬声器

public abstract void setSpeaker(boolean useSpeaker);

参数如下表所示：

setAudioCaptureVolume

设置麦克风采集音量

public abstract void setAudioCaptureVolume(int volume);

参数如下表所示：

setAudioPlayoutVolume

设置播放音量

public abstract void setAudioPlayoutVolume(int volume);

参数如下表所示：

startFileDumping

开始录音

public abstract void startFileDumping(TRTCCloudDef.TRTCAudioRecordingParams trtcAudioRecordingParams);

参数如下表所示：

说明：

该方法调用后， SDK 会将通话过程中的所有音频（包括本地音频，远端音频，BGM 等）录制到一个文件里。无论是否进房，调用该接口都生效。如果调用 exitMeeting 时还在录音，录音会自动停止。

stopFileDumping

停止录音

public abstract void stopFileDumping();

enableAudioEvaluation

启用音量大小提示

public abstract void enableAudioEvaluation(boolean enable);

参数如下表所示：

说明：

开启后会在 onUserVolumeUpdate 中获取到 SDK 对音量大小值的评估。

录屏接口

startScreenCapture

启动屏幕分享。

public abstract void startScreenCapture(TRTCCloudDef.TRTCVideoEncParam encParams, TRTCCloudDef.TRTCScreenShareParams screenShareParams);

参数如下表所示：

说明：

详情请参见TRTC SDK

stopScreenCapture

停止屏幕采集。

public abstract void stopScreenCapture();

pauseScreenCapture

暂停屏幕分享。

public abstract void pauseScreenCapture();

resumeScreenCapture

恢复屏幕分享。

public abstract void resumeScreenCapture();

分享接口

getLiveBroadcastingURL

获取 CDN 分享链接。

public abstract String getLiveBroadcastingURL();

返回值如下表所示：

美颜滤镜相关接口函数

getBeautyManager

获取美颜管理对象 TXBeautyManager。

public abstract TXBeautyManager getBeautyManager();

通过美颜管理，您可以使用以下功能：

• 设置“美颜风格”、“美白”、“红润”、“大眼”、“瘦脸”、“V脸”、“下巴”、“短脸”、“小鼻”、“亮眼”、“白牙”、“祛眼袋”、“祛皱纹”、“祛法令纹”等美容效果。
• 调整“发际线”、“眼间距”、“眼角”、“嘴形”、“鼻翼”、“鼻子位置”、“嘴唇厚度”、“脸型”。
• 设置人脸挂件（素材）等动态效果。
• 添加美妆。
• 进行手势识别。

消息发送相关接口函数

sendRoomTextMsg

在房间中广播文本消息。

public abstract void sendRoomTextMsg(String message, TRTCMeetingCallback.ActionCallback callback);

参数如下表所示：

sendRoomCustomMsg

发送自定义文本消息。

public abstract void sendRoomCustomMsg(String cmd, String message, TRTCMeetingCallback.ActionCallback callback);

参数如下表所示：

TRTCMeetingDelegate 事件回调

通用事件回调

onError

错误回调。

说明：

SDK 不可恢复的错误，一定要监听，并分情况给用户适当的界面提示。

void onError(int code, String message);

参数如下表所示：

房间事件回调

onRoomDestroy

房间被销毁的回调。主持人退房时，房间内的所有用户都会收到此通知。

void onRoomDestroy(String roomId);

参数如下表所示：

onNetworkQuality

网络状态回调。

void onNetworkQuality(TRTCCloudDef.TRTCQuality localQuality, List<TRTCCloudDef.TRTCQuality> remoteQuality);

参数如下表所示：

说明：

详情请参见 TRTC SDK

onUserVolumeUpdate

启用音量大小提示，会通知每个成员的音量大小

void onUserVolumeUpdate(String userId, int volume);

参数如下表所示：

成员进出事件回调

onUserEnterRoom

新成员进房通知。

void onUserEnterRoom(String userId);

参数如下表所示：

onUserLeaveRoom

成员退房通知。

void onUserLeaveRoom(String userId);

参数如下表所示：

成员音视频事件回调

onUserVideoAvailable

成员开启/关闭摄像头的通知。

void onUserVideoAvailable(String userId, boolean available);

参数如下表所示：

onUserAudioAvailable

成员开启/关闭麦克风的通知。

void onUserAudioAvailable(String userId, boolean available);

参数如下表所示：

消息事件回调

onRecvRoomTextMsg

收到文本消息。

void onRecvRoomTextMsg(String message, TRTCMeetingDef.UserInfo userInfo);

参数如下表所示：

onRecvRoomCustomMsg

收到自定义消息。

void onRecvRoomCustomMsg(String cmd, String message, TRTCMeetingDef.UserInfo userInfo);

参数如下表所示：

录屏事件回调

onScreenCaptureStarted

录屏开始通知。

void onScreenCaptureStarted();

onScreenCapturePaused

录屏暂停通知。

void onScreenCapturePaused();

onScreenCaptureResumed

录屏恢复通知。

void onScreenCaptureResumed();

onScreenCaptureStoped

录屏停止通知。

void onScreenCaptureStopped(int reason);

参数如下表所示：