实时音视频准备工作（Android）

功能预览
TUILiveKit 是一个功能全面的直播组件，集成后可快速实现以下功能模块：
主播准备页
主播开播页
直播列表
观众观看页
﻿
﻿
﻿
﻿
﻿
﻿
﻿
﻿
﻿
﻿
﻿
﻿
准备工作
开通服务
在使用 TUILiveKit 前，您需要在 TRTC 控制台 开通相关服务，并领取体验版或者开通付费版。
开发环境要求
Android 5.0（SDK API Level 21）及以上版本。
Gradle 7.0 及以上的版本。
Android 5.0 及以上的手机设备。
代码集成
步骤 1：下载 TUILiveKit 组件
在 GitHub 中克隆/下载代码，然后将 Android/tuilivekit 子目录拷贝到您当前 Android 项目的 app 文件夹同级目录中。
﻿
步骤 2：工程配置
1. 配置 JitPack 仓库
在工程根目录下的 settings.gradle.kts 或 settings.gradle 文件中，添加 JitPack 仓库地址，用于下载播放礼物 SVG 动画的第三方库。
settings.gradle.kts
settings.gradle
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
﻿
        // 添加 JitPack 仓库地址
        maven { url = uri("https://jitpack.io") }
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
﻿
        // 添加 JitPack 仓库地址
        maven { url 'https://jitpack.io' }
    }
}
2. 导入 TUILiveKit 组件
在工程根目录下的 settings.gradle.kts 或 settings.gradle 文件中，增加以下代码以导入 tuilivekit 组件。
settings.gradle.kts
settings.gradle
include(":tuilivekit")
include ':tuilivekit'
3. 添加组件依赖
在 app 目录下找到 build.gradle.kts（或 build.gradle）文件，并在文件中增加以下代码，该步骤的作用是声明当前 App 对新加入的 tuilivekit 组件的依赖。
build.gradle.kts
build.gradle
api(project(":tuilivekit"))
api project(':tuilivekit')
说明：
TUILiveKit 内部已默认依赖 TRTC SDK、IM SDK 等公共库，您无需单独配置。
4. 配置混淆规则
由于 SDK 内部使用了 Java 反射，请在 proguard-rules.pro 文件中添加以下代码，将相关类加入不混淆名单，以确保功能正常运行。
-keep class com.tencent.** { *; }
-keep class com.trtc.uikit.livekit.livestreamcore.** { *; }
-keep class com.trtc.uikit.livekit.component.gift.store.model.** { *; }
-keep class com.squareup.wire.** { *; }
-keep class com.opensource.svgaplayer.proto.** { *; }
﻿
-keep class com.tcmediax.** { *; }
-keep class com.tencent.** { *; }
-keep class com.tencent.xmagic.** { *; }
-keep class androidx.exifinterface.** {*;}
-keep class com.google.gson.** { *;}
# Tencent Effect SDK - beauty
-keep class com.tencent.xmagic.** { *;}
-keep class org.light.** { *;}
-keep class org.libpag.** { *;}
-keep class org.extra.** { *;}
-keep class com.gyailib.**{ *;}
-keep class com.tencent.cloud.iai.lib.** { *;}
-keep class com.tencent.beacon.** { *;}
-keep class com.tencent.qimei.** { *;}
-keep class androidx.exifinterface.** { *;}
5. 修改 AndroidManifest.xml
在 app/src/main/AndroidManifest.xml 文件的 <application> 节点中，添加 tools:replace="android:allowBackup" 和 android:allowBackup="false"，用以覆盖组件内的设置。
  // app/src/main/AndroidManifest.xml
  
  <application
    ...
  
    // 添加如下配置覆盖 依赖的 sdk 中的配置
    android:allowBackup="false"
    tools:replace="android:allowBackup">
完成登录
集成完成后，您需要通过调用 TUICore 接口完成登录。这是使用 TUILiveKit 的关键步骤，因为只有在登录成功后才能正常使用 TUILiveKit 的各项功能，故请您耐心检查相关参数是否配置正确：
Kotlin
Java
// 登录
TUILogin.login(applicationContext,
    1400000001,      // 请替换为开通服务控制台的 SDKAppID
    "denny",         // 请替换为您的 UserID
    "xxxxxxxxxxx",   // 您可以在控制台中计算一个 UserSig 并填在这个位置
    object : TUICallback() {
        override fun onSuccess() {
            Log.i(TAG, "login success")
        }
﻿
        override fun onError(errorCode: Int, errorMessage: String) {
            Log.e(TAG, "login failed, errorCode: $errorCode msg:$errorMessage")
        }
    })
// 登录
TUILogin.login(context, 
    1400000001,     // 请替换为开通服务控制台的 SDKAppID
    "denny",        // 请替换为您的 UserID
    "xxxxxxxxxxx",  // 您可以在控制台中计算一个 UserSig 并填在这个位置
    new TUICallback() {
    @Override
    public void onSuccess() {
        Log.i(TAG, "login success");
    }
﻿
    @Override
    public void onError(int errorCode, String errorMessage) {
        Log.e(TAG, "login failed, errorCode: " + errorCode + " msg:" + errorMessage);
    }
});
登录接口参数说明
参数
类型
说明
SDKAppID
Int
从 TRTC 控制台 > 应用管理 获取。
UserID
String
当前用户的唯一 ID，仅包含英文字母、数字、连字符和下划线。
userSig
String
用于腾讯云鉴权的票据。请注意：
开发环境：您可以采用本地 GenerateTestUserSig.genTestSig 函数生成 UserSig 或者通过 UserSig 辅助工具 生成临时的 UserSig。
生产环境：为了防止密钥泄露，请务必采用服务端生成 UserSig 的方式。详细信息请参见 服务端生成 UserSig。
更多信息请参见 如何计算及使用 UserSig。
接入直播功能
恭喜您，现在您已经成功集成了视频直播组件并完成了登录。接下来，您可以开始接入 主播开播、观众观看 功能或实现其他直播功能。
﻿

主播准备页	主播开播页	直播列表	观众观看页

参数	类型	说明
SDKAppID	Int	从 TRTC 控制台 > 应用管理获取。
UserID	String	当前用户的唯一 ID，仅包含英文字母、数字、连字符和下划线。
userSig	String	用于腾讯云鉴权的票据。请注意：开发环境：您可以采用本地 `GenerateTestUserSig.genTestSig` 函数生成 UserSig 或者通过 UserSig 辅助工具生成临时的 UserSig。生产环境：为了防止密钥泄露，请务必采用服务端生成 UserSig 的方式。详细信息请参见服务端生成 UserSig。更多信息请参见如何计算及使用 UserSig。

准备工作（Android）

本页目录：

功能预览

准备工作

开通服务

开发环境要求

代码集成

步骤 1：下载 TUILiveKit 组件

步骤 2：工程配置

1. 配置 JitPack 仓库

2. 导入 TUILiveKit 组件

3. 添加组件依赖

4. 配置混淆规则

5. 修改 AndroidManifest.xml

完成登录

接入直播功能