Skip to content

在 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 包

bash
npm install tirtc-av-react-native

配置 Android 工程

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

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

kotlin
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

properties
newArchEnabled=true

配置 iOS 工程

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

ruby
platform :ios, '15.1'
bash
cd ios && pod install

在 JavaScript / TypeScript 代码中导入 API

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

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

初始化 SDK

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

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

下一步

完成 React Native SDK 接入后,继续参考建立与设备端的连接音视频流传输与播放

TiRTC 开发文档