tencent cloud

文档反馈

最后更新时间:2024-11-01 14:16:18
    本文将介绍如何用最短的时间完成 TUICallKit 组件的接入,跟随本文档,您将在 10 分钟内完成如下几个关键步骤,并最终得到一个包含完备 UI 界面的音视频通话功能。

    环境准备

    Android 5.0(SDK API Level 21)及以上版本。
    Gradle 4.2.1 及以上的版本。
    Android 5.0 及以上的手机设备。

    步骤1:开通服务

    在使用腾讯云提供的音视频服务前,您需要前往控制台,为应用开通音视频服务。具体步骤请参见 开通服务。

    步骤2:下载并导入组件

    Github 中克隆/下载代码,然后拷贝 Android 目录下的tuicallkit-kt子目录到您当前工程中的 app 同级目录中,如下图:
    
    

    步骤3:完成工程配置

    1. 在工程根目录下找到 settings.gradle(或settings.gradle.kts)文件,在其中增加如下代码,它的作用是将 步骤二 中下载的组件导入到您当前的项目中:
    settings.gradle
    setting.gradle.kts
    include ':tuicallkit-kt'
    include(":tuicallkit-kt")
    2. 在 app 目录下找到 build.gradle(或build.gradle.kts)文件,增加如下代码,它的作用是声明当前 app 对新加入的组件的依赖:
    build.gradle
    build.gradle.kts
    api project(':tuicallkit-kt')
    api(project(":tuicallkit-kt"))
    说明
    TUICallKit 工程内部已经默认依赖:TRTC SDKIM SDKtuicallengine 以及公共库 tuicore,不需要开发者单独配置。如需进行版本升级,则修改tuicallkit-kt/build.gradle文件即可。
    3. 由于我们在 SDK 内部使用了Java 的反射特性,需要将 SDK 中的部分类加入不混淆名单,因此需要您在 proguard-rules.pro 文件中添加如下代码:
    -keep class com.tencent.** { *; }
    注意
    TUICallKit 会在内部帮助您动态申请相机、麦克风、读取存储权限等,如果因为您的业务问题需要删减,可以请修改tuicallkit-kt/src/main/AndroidManifest.xml

    步骤4:登录 TUI 组件

    在您的项目中添加如下代码,它的作用是通过调用 TUICore 中的相关接口完成 TUI 组件的登录。这个步骤异常关键,因为只有在登录成功后才能正常使用 TUICallKit 的各项功能,故请您耐心检查相关参数是否配置正确:
    TUILogin.login(this,
    1400000001, // 请替换为步骤一取到的 SDKAppID
    "denny", // 请替换为您的 UserID
    "xxxxxxxxxxx", // 您可以在控制台中计算一个 UserSig 并填在这个位置
    object : TUICallback() {
    override fun onSuccess() {
    }
    
    override fun onError(errorCode: Int, errorMessage: String) {
    }
    })
    }
    参数说明 这里详细介绍一下 login 函数中所需要用到的几个关键参数:
    SDKAppID:在步骤一中的最后一步中您已经获取到,这里不再赘述。
    UserID:当前用户的 ID,字符串类型,只允许包含英文字母(a-z 和 A-Z)、数字(0-9)、连词符(-)和下划线(_)。
    UserSig:使用 步骤一 的第 2 步中获取的 SecretKey 对 SDKAppID、UserID 等信息进行加密,就可以得到 UserSig,它是一个鉴权用的票据,用于腾讯云识别当前用户是否能够使用 TRTC 的服务。您可以通过控制台中的 辅助工具 生成一个临时可用的 UserSig。
    更多信息请参见 如何计算及使用 UserSig
    注意:
    这个步骤也是目前我们收到的开发者反馈最多的步骤,常见问题如下:
    SDKAppID 设置错误,国内站的 SDKAppID 一般是以140开头的10位整数。
    UserSig 被错配成了加密密钥(Secretkey),UserSig 是用 SecretKey 把 SDKAppID、UserID 以及过期时间等信息加密得来的,而不是直接把 Secretkey 配置成 UserSig。
    UserID 被设置成“1”、“123”、“111”等简单字符串,由于 TRTC 不支持同一个 UserID 多端登录,所以在多人协作开发时,形如 “1”、“123”、“111” 这样的 UserID 很容易被您的同事占用,导致登录失败,因此我们建议您在调试的时候设置一些辨识度高的 UserID。
    Github 中的示例代码使用了 genTestUserSig 函数在本地计算 UserSig 是为了更快地让您跑通当前的接入流程,但该方案会将您的 SecretKey 暴露在 App 的代码当中,这并不利于您后续升级和保护您的 SecretKey,所以我们强烈建议您将 userSig 的计算逻辑放在服务端进行,并由 App 在每次使用 TUICallKit 组件时向您的服务器请求实时计算出的 UserSig。

    步骤5:拨打您的第一通电话

    主叫方与被叫方登录成功后,主叫方通过调用 TUICallKit 的 call 方法并指定通话类型和被叫方的 userId,就可以发起语音或者视频通话,被叫方此时就可接受到来电邀请。
    Kotlin
    Java
    // 发起1对1视频通话(假设 UserID 为 mike)
    TUICallKit.createInstance(context).call("mike", TUICallDefine.MediaType.Video)
    // 发起1对1视频通话(假设 UserID 为 mike)
    TUICallKit.createInstance(context).call("mike", TUICallDefine.MediaType.Video);
    
    
    
    
    
    
    主叫方
    被叫方

    更多特性

    悬浮窗

    常见问题

    1、错误提示“The package you purchased does not support this ability”?

    如遇以上错误提示,是由于您当前应用的音视频通话能力包过期或未开通,请参见 步骤一:开通服务,领取或者开通音视频通话能力,进而继续使用 TUICallKit 组件。

    2、如何购买套餐?

    请参考购买链接 购买正式版

    3、TUICallKit 崩溃,崩溃日志:"No implementation found for xxxx"?

    堆栈信息如下:
    java.lang.UnsatisfiedLinkError: No implementation found for void com.tencent.liteav.base.Log.nativeWriteLogToNative(int, java.lang.String, java.lang.String) (tried Java_com_tencent_liteav_base_Log_nativeWriteLogToNative and Java_com_tencent_liteav_base_Log_nativeWriteLogToNative__ILjava_lang_String_2Ljava_lang_String_2)
    at com.tencent.liteav.base.Log.nativeWriteLogToNative(Native Method)
    at com.tencent.liteav.base.Log.i(SourceFile:177)
    at com.tencent.liteav.basic.log.TXCLog.i(SourceFile:36)
    at com.tencent.liteav.trtccalling.model.impl.base.TRTCLogger.i(TRTCLogger.java:15)
    at com.tencent.liteav.trtccalling.model.impl.ServiceInitializer.init(ServiceInitializer.java:36)
    at com.tencent.liteav.trtccalling.model.impl.ServiceInitializer.onCreate(ServiceInitializer.java:101)
    at android.content.ContentProvider.attachInfo(ContentProvider.java:2097)
    at android.content.ContentProvider.attachInfo(ContentProvider.java:2070)
    at android.app.ActivityThread.installProvider(ActivityThread.java:8168)
    at android.app.ActivityThread.installContentProviders(ActivityThread.java:7709)
    at android.app.ActivityThread.handleBindApplication(ActivityThread.java:7573)
    at android.app.ActivityThread.access$2600(ActivityThread.java:260)
    at android.app.ActivityThread$H.handleMessage(ActivityThread.java:2435)
    at android.os.Handler.dispatchMessage(Handler.java:110)
    at android.os.Looper.loop(Looper.java:219)
    at android.app.ActivityThread.main(ActivityThread.java:8668)
    at java.lang.reflect.Method.invoke(Native Method)
    at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:513)
    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1109)
    因为 TUICallKit 依赖的 TRTC 等 SDK 部分接口使用了 JNI 实现,Android Studio 在某些条件进行编译 APK 的时候可能并不会把 Native 的 .so 库打包进去,导致出现这类报错,重新 Clean 一下即可。

    交流与反馈

    如果有任何需要或者反馈,您可以联系:info_rtc@tencent.com。
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持