集成到客户端

这页带你把 TiRTC 客户端 SDK 集成到自己的 App，并完成 SDK 初始化。

前置条件

开始写客户端代码前，先准备好这几项：

你需要准备	从哪里来
AppId	你的 TiRTC 应用配置，Android、iOS 和 Flutter 都会用到
SDK 版本号	从对应平台发布说明获取

环境要求

平台	要求
Flutter	Flutter >=3.13.0；Dart >=3.1.0 <4.0.0；支持 Android / iOS / macOS
Android	Android 5.0（API Level 21）及以上；arm64-v8a；compileSdk 为 35
iOS	iOS 13.0 及以上；arm64

1. 引用 SDK

Flutter

dependencies:
  flutter:
    sdk: flutter
  tirtc_av_kit: <latest-version>

Android

// settings.gradle.kts
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()
      }
    }
  }
}

// app/build.gradle.kts
dependencies {
  implementation("com.tange.ai:tirtc-av:<latest-version>")
}

iOS

target 'YourApp' do
  pod 'TiRTC_AV', '<latest-version>'
end

Flutter App 工程总，还需要在 android/build.gradle.kts 加入 TiRTC 的私有 Maven 仓库：

// android/build.gradle.kts
allprojects {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("http://repo-sdk.tange-ai.com/repository/maven-public/")
      isAllowInsecureProtocol = true
      credentials {
        username = "tange_user"
        password = "tange_user"
      }
    }
  }
}

最新版本号看对应 SDK 的发布说明：

• Flutter SDK 发布说明
• Android SDK 发布说明
• iOS SDK 发布说明

2. 初始化 SDK

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

Flutter

import 'package:flutter/material.dart';
import 'package:tirtc_av_kit/tirtc_av_kit.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  final int code = await TiRtc.initialize(
    const TiRtcInitOptions(
      appId: 'your-app-id'
    ),
  );
  if (code != 0) {
    throw StateError('TiRTC initialize failed: ${TiRtc.formatError(code)}');
  }

  runApp(const YourApp());
}

Android

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

iOS

import OSLog
import TiRTC_AV
import UIKit

@main
final class AppDelegate: UIResponder, UIApplicationDelegate {
  var window: UIWindow?

  func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
  ) -> Bool {
    let config = TiRtcInitOptions(appId: "your-app-id")
    TiRtc.initialize(config)
    return true
  }
}

预期结果

初始化返回 0 后，客户端 SDK 已经可以创建连接对象。下一步再根据你的业务场景发起连接。