效果展示
您可以 下载 安装我们的 Demo 体验多人视频会议的效果,包括屏幕分享、美颜、低延时会议等 TRTC 在多人视频会议场景下的相关能力。
进入会议 | 屏幕分享 |
---|---|
如需快速接入多人视频会议功能,您可以直接基于我们提供的 Demo 进行修改适配,也可以使用我们提供的 TRTCMeeting 组件并实现自定义 UI 界面。
复用 Demo 的 UI 界面
步骤1:创建新的应用
- 登录实时音视频控制台,选择【开发辅助】>【快速跑通Demo】。
- 输入应用名称,例如 TestMeetingRoom ,单击【创建】。
注意:本功能同时使用了腾讯云 实时音视频 TRTC 和 即时通信 IM 两个基础 PaaS 服务,开通实时音视频后会同步开通即时通信 IM 服务。 即时通信 IM 属于增值服务,详细计费规则请参见 即时通信 IM 价格说明。
步骤2:下载 SDK 和 Demo 源码
- 根据实际业务需求下载 SDK 及配套的 Demo 源码。
- 下载完成后,单击【已下载,下一步】。
步骤3:配置 Demo 工程文件
- 进入修改配置页,根据您下载的源码包,选择相应的开发环境。
- 找到并打开
Android/TRTCScenesDemo/debug/src/main/java/com/tencent/liteav/debug/GenerateTestUserSig.java
文件。
3.设置GenerateTestUserSig.java
文件中的相关参数:- SDKAPPID:默认为0,请设置为实际的 SDKAppID。
- SECRETKEY:默认为空字符串,请设置为实际的密钥信息。
- 粘贴完成后,单击【已复制粘贴,下一步】即创建成功。
- 编译完成后,单击【回到控制台概览】即可。
注意:本文提到的生成 UserSig 的方案是在客户端代码中配置 SECRETKEY,该方法中 SECRETKEY 很容易被反编译逆向破解,一旦您的密钥泄露,攻击者就可以盗用您的腾讯云流量,因此该方法仅适合本地跑通 Demo 和功能调试。
正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端,并提供面向 App 的接口,在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig。
步骤4:运行 Demo
使用 Android Studio(3.5以上的版本)打开源码工程 TRTCScenesDemo
,单击【运行】即可开始调试本 Demo。
步骤5:修改 Demo 源代码
源码文件夹 trtcmeetingdemo
中包含两个子文件夹 ui 和 model,ui 文件夹中均为界面代码,如下表格列出了各个文件或文件夹及其所对应的 UI 界面,以便于您进行二次调整:
文件或文件夹 | 功能描述 |
---|---|
remote | 远端用户的列表界面 |
widget | 通用的 UI 组件 |
CreateMeetingActivity.java | 创建会议的界面 |
MeetingMainActivity.java | 视频会议的主界面 |
MeetingVideoView.java | 封装了 TRTC 的 TXCloudVideoView,用于展示自己和远端用户的视频数据 |
MemberEntity.java | UI 层的用户数据 |
MemberListAdapter.java | 视频会议主界面的 Adapter |
实现自定义 UI 界面
源码 中的 trtcmeetingdemo 文件夹包含两个子文件夹 ui 和 model,model 文件夹中包含可重用的开源组件 TRTCMeeting,您可以在TRTCMeeting.java
文件中看到该组件提供的接口函数,并使用对应接口实现自定义 UI 界面。
步骤1:集成 SDK
多人视频会议组件 TRTCMeeting 依赖 TRTC SDK 和 IM SDK,您可以按照如下步骤将两个 SDK 集成到项目中。
方法一:通过 Maven 仓库依赖
- 在 dependencies 中添加 TRTCSDK 和 IMSDK 的依赖。
dependencies { compile "com.tencent.liteav:LiteAVSDK_TRTC:latest.release" compile 'com.tencent.imsdk:imsdk:latest.release' }
说明:两个 SDK 的最新版本号,可以在 TRTC 和 IM 的 Github 首页获取。
- 在 defaultConfig 中,指定 App 使用的 CPU 架构。
defaultConfig { ndk { abiFilters "armeabi-v7a" } }
- 单击【Sync Now】,自动下载 SDK 并集成到工程里。
方法二:通过本地 AAR 依赖
若您的开发环境访问 maven 仓库较慢,您可以直接下载 ZIP 包,并按照集成文档手动集成到您的工程中。
SDK | 下载页面 | 集成指引 |
---|---|---|
TRTC SDK | DOWNLOAD | 集成文档 |
IM SDK | DOWNLOAD | 集成文档 |
步骤2:配置权限及混淆规则
在 AndroidManifest.xml 中配置 App 的权限,SDK 需要以下权限(6.0以上的 Android 系统需要动态申请相机、读取存储权限):
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-feature android:name="android.hardware.camera"/>
<uses-feature android:name="android.hardware.camera.autofocus" />
在 proguard-rules.pro 文件,将 SDK 相关类加入不混淆名单:
-keep class com.tencent.** { *; }
步骤3:导入 TRTCMeeting 组件
拷贝以下目录中的所有文件到您的项目中:
src/main/java/com/tencent/liteav/meeting/model
步骤4:创建并登录组件
- 调用
sharedInstance
接口可以创建一个 TRTCMeeting 组件的实例对象。 - 调用
setDelegate
函数注册组件的事件通知。 - 调用
login
函数完成组件的登录,请参考下表填写关键参数:参数名 作用 sdkAppId 您可以在 实时音视频控制台 中查看 SDKAppID。 userId 当前用户的 ID,字符串类型,只允许包含英文字母(a-z、A-Z)、数字(0-9)、连词符(-)和下划线(_)。 userSig 腾讯云设计的一种安全保护签名,获取方式请参考 如何计算 UserSig。 callback 登录回调,成功时 code 为0。 TRTCMeeting trtcMeeting = TRTCMeeting.sharedInstance(this);
trtcMeeting.login(SDKAPPID, userId, userSig, new TRTCMeetingCallback.ActionCallback() {
@Override
public void onCallback(int code, String msg) {
if (code == 0) {
//登录成功
}
}
});
步骤5:创建多人会议
- 主持人执行 步骤4 登录后,可以调用
setSelfProfile
设置自己的昵称和头像。 - 主持人调用
setDelegate
可以进行事件调用createMeeting
创建新的会议房间。 - 主持人可以调用
startCameraPreview
进行视频画面的采集,也可以调用startMicrophone
进行声音的采集。 - 如果主持人有美颜的需求,界面上可以配置美颜调节按钮调用,通过
getBeautyManager
进行美颜设置。说明:非企业版 SDK 不支持变脸和贴图挂件功能。
// 1.主持人设置昵称和头像
trtcMeeting.setSelfProfile("my_name", "my_avatar", null);
// 2.主持人创建房间
trtcMeeting.createMeeting(roomId, new TRTCMeetingCallback.ActionCallback() {
@Override
public void onCallback(int code, String msg) {
if (code == 0) {
// 3.打开摄像头和音频采集
TXCloudVideoView txCloudVideoView = new TXCloudVideoView(TestMeetingActivity.this);
parentView.add(view);
trtcMeeting.startCameraPreview(true, txCloudVideoView);
trtcMeeting.startMicrophone();
// 4.设置美颜
trtcMeeting.getBeautyManager().setBeautyStyle(1);
trtcMeeting.getBeautyManager().setBeautyLevel(6);
}
}
});
步骤6:参会成员进入多人会议
- 参会成员执行 步骤4 登录后,可以调用
setSelfProfile
设置自己的昵称和头像。 - 参会成员调用
enterMeeting
并传入会议房间号即可进入会议房间。 - 参会成员可以调用
startCameraPreview
进行视频画面的采集,调用startMicrophone
进行声音的采集。 - 如果有其他的参会成员打开了摄像头,会收到
onUserVideoAvailable
的事件,此时可以调用startRemoteView
并传入 userId 开始播放。
// 1.参会成员设置昵称和头像
trtcMeeting.setSelfProfile("my_name", "my_avatar", null);
// 2.参会成员调用 enterMeeting 进入会议房间号
trtcMeeting.enterMeeting(roomId, new TRTCMeetingCallback.ActionCallback() {
@Override
public void onCallback(int code, String msg) {
if (code == 0) {
// 3.进房成功,打开自己的摄像头和麦克风,同时可以打开美颜功能
TXCloudVideoView txCloudVideoView = new TXCloudVideoView(TestMeetingActivity.this);
parentView.add(view);
trtcMeeting.startCameraPreview(true, txCloudVideoView);
trtcMeeting.startMicrophone();
trtcMeeting.getBeautyManager().setBeautyStyle(1);
trtcMeeting.getBeautyManager().setBeautyLevel(6);
}
}
});
// 3.参会成员收到其他成员摄像头打开的通知,开始播放
trtcMeeting.setDelegate(new TRTCMeetingDelegate() {
@Override
public void onUserVideoAvailable(String userId, boolean available) {
if (available) {
TXCloudVideoView txCloudVideoView = new TXCloudVideoView(TestMeetingActivity.this);
parentView.add(view);
trtcMeeting.startRemoteView(userId, txCloudVideoView);
} else {
trtcMeeting.stopRemoteView(userId, null);
}
}
});
步骤7:屏幕分享
- 屏幕分享功能需向系统需要申请悬浮窗权限,需要您在 UI 中实现具体的逻辑。
- 调用
startScreenCapture
,传入编码参数和录屏过程中的悬浮窗即可实现屏幕分享功能,具体信息请参见 TRTC SDK。 - 会议中其他成员会收到
onUserVideoAvailable
的事件通知。注意:幕分享和摄像头采集是两个互斥的操作,如果需要打开屏幕分享功能,请先调用
stopCameraPreview
关闭摄像头采集。
// 1.在 AndroidManifest.xml 文件中添加 SDK 录屏功能的 activity 和权限
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW">
<application>
<activity android:name="com.tencent.rtmp.video.TXScreenCapture$TXScreenCaptureAssistantActivity" android:theme="@android:style/Theme.Translucent">
</activity></application>
// 2.在您的界面中申请悬浮窗的权限
if (Build.VERSION.SDK_INT >= 23) {
if (!Settings.canDrawOverlays(getApplicationContext())) {
Intent intent = new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION, Uri.parse("package:" + getPackageName()));
startActivityForResult(intent, 100);
} else {
startScreenCapture();
}
} else {
startScreenCapture();
}
// 3.系统回调结果
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if (requestCode == 100) {
if (Build.VERSION.SDK_INT >= 23) {
if (Settings.canDrawOverlays(this)) {
// 用户成功授权
startScreenCapture();
} else {
}
}
}
}
// 4.打开屏幕分享
private void startScreenCapture() {
TRTCCloudDef.TRTCVideoEncParam encParams = new TRTCCloudDef.TRTCVideoEncParam();
encParams.videoResolution = TRTCCloudDef.TRTC_VIDEO_RESOLUTION_1280_720;
encParams.videoResolutionMode = TRTCCloudDef.TRTC_VIDEO_RESOLUTION_MODE_PORTRAIT;
encParams.videoFps = 10;
encParams.enableAdjustRes = false;
encParams.videoBitrate = 1200;
TRTCCloudDef.TRTCScreenShareParams params = new TRTCCloudDef.TRTCScreenShareParams();
mTRTCMeeting.stopCameraPreview();
mTRTCMeeting.startScreenCapture(encParams, params);
}
步骤8:实现文字聊天和禁言消息
- 通过
sendRoomTextMsg
可以发送普通的文本消息,所有在该房间内的主播和观众均可以收到onRecvRoomTextMsg
回调。
即时通信 IM 后台有默认的敏感词过滤规则,被判定为敏感词的文本消息不会被云端转发。// 发送端:发送文本消息
trtcMeeting.sendRoomTextMsg("Hello Word!", null);
// 接收端:监听文本消息
trtcMeeting.setDelegate(new TRTCMeetingDelegate() {
@Override
public void onRecvRoomTextMsg(
String message, TRTCMeetingDef.UserInfo userInfo) {
Log.d(TAG, "收到来自" + userInfo.userName + "的消息:" + message);
}
}); - 通过
sendRoomCustomMsg
可以发送自定义(信令)的消息,所有在该房间内的主持人和与会观众均可以收到onRecvRoomCustomMsg
回调。
自定义消息常用于传输自定义信令,例如用于禁言之类的会场控制等。// 发送端:您可以通过自定义 Cmd 来区分禁言通知
// eg:"CMD_MUTE_AUDIO"表示禁言通知
trtcMeeting.sendRoomCustomMsg("CMD_MUTE_AUDIO", "1", null);
// 接收端:监听自定义消息
trtcMeeting.setDelegate(new TRTCMeetingDelegate() {
@Override
public void onRecvRoomCustomMsg(String cmd,
String message, TRTCMeetingDef.UserInfo userInfo) {
if ("CMD_MUTE_AUDIO".equals(cmd)) {
// 收到禁言通知
Log.d(TAG, "收到来自" + userInfo.userName + "的禁言通知:" + message);
trtcMeeting.muteLocalAudio("1".equals(message));
}
}
});