Android SDK 接入

CFlutterReact NativeAndroidiOS / macOSHarmonyOSGoJavaPython

下载更新记录API 说明示例源码

确认运行环境

Android 5.0（API 21）及以上，arm64-v8a，compileSdk 35。

添加 Maven 仓库与依赖

在 settings.gradle.kts 的 dependencyResolutionManagement.repositories 中添加：

maven {
  url = uri("http://repo-sdk.tange-ai.com/repository/maven-public/")
  isAllowInsecureProtocol = true
  credentials {
    username = "tange_user"
    password = "tange_user"
  }
}

在 App module 中添加：

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

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

初始化并查询录像

appId 来自申请开通。appAccessToken 由自己的业务服务端签发，见云端签发 Token。查询时间使用 UTC Unix 毫秒。

import com.tange.ai.tirtc.*
import kotlinx.coroutines.launch

val initCode = TiCloudStorage.init(applicationContext, appId)
if (initCode != TiCloudStorageErrorCode.OK) {
    error(TiCloudStorage.errorToString(initCode))
}
val cloudStorage = TiCloudStorage(appAccessToken)
lifecycleScope.launch {
    val result = cloudStorage.listRecordings(startTimeMs, endTimeMs)
    if (result.code != TiCloudStorageErrorCode.OK) {
        error(TiCloudStorage.errorToString(result.code))
    }
    val recordings = result.recordings
}

页面销毁时，先停止 Replay，并调用 videoOutput.detachView()。然后依次 detach 和 dispose 两个 Output，最后 dispose Replay 与 TiCloudStorage 实例。

应用不再使用 Ti 云存且所有相关实例和任务均已释放后，调用 TiCloudStorage.shutdown() 释放进程级资源。

配置回放速度

Replay 支持 X0_125、X0_25、X0_5、X1、X2、X4、X8 七档速度，分别对应 1/8、1/4、1/2、1、2、4、8 倍速。三档慢速采用持帧显示；非 1 倍速时 Audio Output 自动静音。

replay.setSpeed(TiCloudStorageReplaySpeed.X0_5)

确认可以查询录像

查询成功且 recordings 非空，说明初始化和 Token 鉴权均已通过，查询范围内也存在录像。列表为空时，确认查询范围覆盖设备已经完成上传的 UTC 时间。

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

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