在 React Native App 中添加 TiRTC React Native SDK,配置 Android / iOS 工程,并完成 SDK 初始化。
接入要求
- React Native
>=0.80.0。 - New Architecture。
- 支持 Android / iOS。
- Android
minSdk 23,iOS15.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)}`);
}
}