Android SDK 接入

CWebFlutterReact NativeAndroidiOS / macOSHarmonyOSPython

更新记录API 说明示例源码

在 Android App 中添加 TiRTC Android SDK，并完成 SDK 初始化。

完成本页后，继续连接设备。连接成功后，再实现音视频、语音对讲、命令消息或流消息。

接入要求

• Android 5.0（API Level 21）及以上。
• arm64-v8a。
• compileSdk 为 35。

添加 Maven 仓库

TiRTC Android SDK 通过 TiRTC Maven 仓库分发。新工程需要先添加这个仓库，否则 Gradle 无法解析 com.tange.ai:tirtc，Android 构建会在 Gradle 依赖解析阶段失败。

在 settings.gradle.kts 中添加 TiRTC Maven 仓库。

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("http://repo-sdk.tange-ai.com/repository/maven-public/")
      isAllowInsecureProtocol = true
      credentials {
        username = providers.gradleProperty("TIRTC_PUBLIC_MAVEN_USERNAME").orElse("tange_user").get()
        password = providers.gradleProperty("TIRTC_PUBLIC_MAVEN_PASSWORD").orElse("tange_user").get()
      }
    }
  }
}

添加 SDK 依赖

dependencies {
  implementation("com.tange.ai:tirtc:VERSION")
}

将 VERSION 替换为更新记录中需要接入的版本。

在 Kotlin 代码中导入 API

import com.tange.ai.tirtc.TiRtc
import com.tange.ai.tirtc.TiRtcInitOptions

初始化 SDK

应用启动后，先用你的 AppId 初始化 SDK。初始化成功后，再进入连接、播放、收发消息等后续流程。

class DemoApp : Application() {
  override fun onCreate() {
    super.onCreate()
    TiRtc.init(
      applicationContext,
      TiRtcInitOptions(appId = "your-app-id"),
    )
  }
}

接入客户端诊断能力（推荐）

初始化成功后，建议在开发阶段为 App 预留隐藏的日志上传入口。这样在需要平台协助诊断时，可以直接上传同一次复现的日志；入口设计、上传结果处理和可选的原始音视频诊断采集见接入客户端诊断能力。

下一步

完成 Android SDK 接入后，继续参考连接设备和播放音视频。