TUICalling 是一个开源的音视频 UI 组件,通过在项目中集成 TUICalling 组件,您只需要编写几行代码就可以为您的 App 添加“一对一音视频通话”,“多人音视频通话”等场景,并且支持离线唤起能力。TUICalling 同时支持 iOS、Web、Flutter、UniApp 等平台,基本功能如下图所示:
![]() |
![]() |
单击进入 Github ,选择克隆/下载代码,然后拷贝 Android 目录下的 tuicalling、tuicore 和 debug 目录到您的工程的 app 同一级目录,并完成如下导入动作:
在 setting.gradle
中完成导入,参考如下:
include ':tuicalling'
include ':tuicore'
include ':debug'
在 app 的 build.gradle 文件中添加对 tuicalling 的依赖:
api project(':tuicalling')
在根目录的build.gradle
文件中添加TRTC SDK
和IM SDK
的依赖:
ext {
liteavSdk = "com.tencent.liteav:LiteAVSDK_TRTC:latest.release"
imSdk = "com.tencent.imsdk:imsdk-plus:latest.release"
}
在 AndroidManifest.xml 中配置 App 的权限,SDK 需要以下权限(6.0以上的 Android 系统需要动态申请相机、麦克风、读取存储权限等):
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" /> // 使用场景:悬浮窗、应用在后台时拉起通话界面时需要此权限;
<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.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.BLUETOOTH" /> // 使用场景:使用蓝牙耳机时需要此权限;
<uses-permission android:name="android.permission.READ_PHONE_STATE" /> // 使用场景:判断是否是系统来电打断时需要此权限;
<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera"/>
<uses-feature android:name="android.hardware.camera.autofocus" />
在 proguard-rules.pro 文件,将 SDK 相关类加入不混淆名单:
-keep class com.tencent.** { *; }
// 1.组件登录,
TUILogin.init(this, "您的SDKAppID", config, new V2TIMSDKListener() {
@Override
public void onKickedOffline() { // 登录被踢下线通知(示例:账号在其他设备登录)
}
@Override
public void onUserSigExpired() { // userSig过期通知
}
});
TUILogin.login("您的userId", "您的userSig", new V2TIMCallback() {
@Override
public void onError(int code, String msg) {
Log.d(TAG, "code: " + code + " msg:" + msg);
}
@Override
public void onSuccess() {
}
});
// 2.初始化TUICalling实例
TUICalling callingImpl = TUICallingImpl.sharedInstance(context);
参数说明:
实现1对1视频通话/音频通话 TUICalling#call
// 发起1对1视频通话,假设userId为:1111;
callingImpl.call(["1111"], TUICalling.Type.VIDEO);
实现多人视频通话:
// 发起多人视频通话,假设userId分别为:1111、2222、3333;
callingImpl.call(["1111", "2222", "3333"], TUICalling.Type.VIDEO);
说明:
- 当接收方完成步骤三后,即登录成功后,再收到通话请求后,TUICalling 组件会自动启动相应的接听界面。
- 如果您想发起语音通话,更改类型为
TUICalling.Type.AUDIO
即可。
完成以上四个步骤,就可以实现音视频通话的拨打和接通,但如果您的业务场景需要在 App 的进程被杀死后
或者APP 退到后台后
,还可以正常接收到音视频通话请求,就需要为 TUICalling 组件增加离线推送功能,详情见 Android离线推送接入指引.md。
如果您的业务需要 监听通话的状态,例如通话开始、结束等,可以监听以下事件:
callingImpl.setCallingListener(new TUICalling.TUICallingListener() {
@Override
public boolean shouldShowOnCallView() {
return true;
}
@Override
public void onCallStart(String[] userIDs, TUICalling.Type type, TUICalling.Role role, View tuiCallingView) {
}
@Override
public void onCallEnd(String[] userIDs, TUICalling.Type type, TUICalling.Role role, long totalTime) {
}
@Override
public void onCallEvent(TUICalling.Event event, TUICalling.Type type, TUICalling.Role role, String message) {
Log.d(TAG, "onCallEvent: event = " + event + " ,message = " + message);
}
});
如果您的业务需要开启悬浮窗功能,您可以在TUICalling组件初始化时调用callingImpl.enableFloatWindow(true)
开启该功能;
目前组件支持以下两种情况悬浮窗:
设置要返回的上一层界面,在AndroidManifest.xml
为您需要跳转的界面配置跳转动作 com.tencent.trtc.tuicalling
,例如:
<activity
android:name="{packageName}.MainActivity"
android:launchMode="singleTop">
<intent-filter>
<action android:name="com.tencent.trtc.tuicalling" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
支持,调用 setUserNickname/setUserAvatar
即可。
支持,调用 setCallingBell 即可。
说明:如果有任何需要或者反馈,您可以联系:colleenyu@tencent.com。
本页内容是否解决了您的问题?