React Native SDK 接入

CWebFlutterReact NativeAndroidiOS / macOSHarmonyOSPython

更新记录API 说明示例源码

在 React Native App 中添加 TiRTC React Native SDK，配置 Android / iOS 工程，并完成 SDK 初始化。

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

接入要求

• React Native >=0.80.0。
• New Architecture。
• 支持 Android / iOS。
• Android minSdk 23，iOS 15.1 及以上。

安装 npm 包

npm install tirtc-react-native

配置 Android 工程

React Native Android wrapper 依赖 com.tange.ai:tirtc。这个原生 AAR 需要从 TiRTC Maven 仓库下载；没有配置仓库时，Android 构建会在 Gradle 依赖解析阶段失败。

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

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

在 android/gradle.properties 中启用 New Architecture。

newArchEnabled=true

配置 iOS 工程

在 ios/Podfile 中声明 iOS 最低版本，然后安装依赖。

platform :ios, '15.1'

cd ios && pod install

在 JavaScript / TypeScript 代码中导入 API

JavaScript 和 TypeScript 项目都从 tirtc-react-native 根入口导入运行时 API。TypeScript 项目可以在需要类型标注时额外导入类型。

import {TiRtc} from 'tirtc-react-native';

初始化 SDK

import {TiRtc} from 'tirtc-react-native';

async function initializeTiRtc(): Promise<void> {
  const code = await TiRtc.init({
    appId: 'your-app-id',
  });
  if (code !== 0) {
    throw new Error(`TiRTC initialize failed: ${TiRtc.formatError(code)}`);
  }
}

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

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

下一步

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