在 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及以上,macOS11.5及以上,OpenHarmony SDK12及以上。
添加依赖
把 <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.gradle 或 settings.gradle.kts 的 repositories 中。
在 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());
}