Skip to content

在 Flutter App 中添加 TiRTC Flutter SDK,配置目标平台工程,并完成 SDK 初始化。

接入要求

  • Flutter >=3.13.0
  • Dart >=3.1.0 <4.0.0
  • 支持 Android / iOS / macOS / OpenHarmony / HarmonyOS NEXT。
  • Android 5.0(API Level 21)及以上,iOS 13.0 及以上,macOS 11.5 及以上,OpenHarmony SDK 12 及以上。

添加依赖

<latest-version> 替换为 Flutter SDK 更新记录里的最新版本。

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

如果需要构建 Android 目标,还需要让 Android 工程能够解析 TiRTC Android AAR。tirtc_av_kit 的 Android 实现依赖 com.tange.ai:tirtc-av,这个依赖需要从 TiRTC Maven 仓库下载;没有配置仓库时,Android 构建会在 Gradle 依赖解析阶段失败。

在默认 Flutter Android 工程中,可以在 android/build.gradle.kts 中添加 TiRTC Maven 仓库。

kotlin
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"
      }
    }
  }
}

如果你的 Android 工程使用 dependencyResolutionManagement 集中管理仓库,把同一个 maven { ... } 配置放到 settings.gradlesettings.gradle.ktsrepositories 中。

在 Dart 代码中导入 API

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

初始化 SDK

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

dart
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.errorToString(code)} ($code)');
  }

  runApp(const YourApp());
}

下一步

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

TiRTC 开发文档