注意:说明:
注意:你也可以使用 TRTC Agent Skill,让 AI 协助你完成 Demo 下载、配置和运行。安装后直接告诉 AI “帮我跑通 Flutter 音视频通话 Demo”,它会根据你的环境逐步引导,并协助排查运行问题。
一、环境准备
·Flutter:Flutter 3.24.0 及以上版本。
·Android:Android Studio 3.5 及以上版本、Android 4.1 及以上版本的 Android 设备。
·iOS:Xcode 13.0及以上版本、确保你的项目已设置有效的开发者签名。
二、开通服务
请参见 开通服务,获取 SDKAppID 和 SDKSecretKey,在后续的步骤(配置 Demo)中会用到。
三、下载 Demo
1. 从 GitHub 下载 TUICallKit Demo 源码,或者直接在命令行运行以下命令:
git clone https://github.com/Tencent-RTC/TUIKit_Flutter.git
2. 通过 Android Studio 或 VSCode 打开 TUIKit_Flutter/application 。以下流程将以 Android Studio 为例:
注意:说明:
注意:若 Android Studio 未安装 Flutter 和 Dart 插件,可参考:安装 Flutter 和 Dart 插件。
四、跑通 Demo
推荐你将 Demo 运行在两台设备上使用两个用户登录,一方作为主叫,一方作为被叫,完成一次音视频通话体验。
五、步骤1: 配置并运行 Demo
1. 填写 SDKAppID 和 SecretKey:打开 lib/debug/generate_test_user_sig.dart 文件,将 开通服务 时获取到的 sdkAppId 和 secretKey 填入其中:
2. 运行 Demo:你可以通过以下命令,运行 Demo。
flutter run
六、步骤2: 登录和注册
Demo 启动后,请你在 用户ID 处输入 ID 。如果你当前的 UserID 未曾注册过,此时会进入到注册界面,你可以在该界面为自己设置昵称。
| 登录用户:Charlie | | 登录用户:Jane | |
| | | | |
注意:提示:
注意:建议你尽量避免将你的 UserID 设置成“1”、“123”、“111”等简单字符串,在多人协作开发时,形如 “1”、“123”、“111” 这样的 UserID 很容易被你的同事占用,导致登录失败,因此我们建议你在调试的时候设置一些辨识度高的 UserID。
七、步骤3: 拨打第一个电话
1. 主叫方请点击界面上的 1V1 通话,在弹出的界面中输入被叫方的 UserID 并选择你想要的通话类型。
2. 单击发起通话。
| 点击"通话" | Charlie 呼叫 Jane | Jane 收到来电 | Jane 点击"接听"后双方开始通话 |
| | | | |
注意:提示:
注意:发起通话需确认:被呼叫用户 ID 是已登录的有效 ID。
八、运行 Demo 提示签名错误或登录失败?
请检查你在 lib/debug/generate_test_user_sig.dart 文件中填写的 sdkAppId 和 secretKey 是否正确,确保它们是你在 开通服务 时获取到的密钥。
九、拨打电话过程中出现需要购买套餐包的提示?
| 错误提示 | 解决方法 |
| 你当前未购买音视频通话能力套餐,请前往 IM 控制台开通免费体验或加购正式版。 | 你当前未购买音视频通话能力套餐,请前往 IM 控制台 开通免费体验 或 加购正式版。 |
| 你当前购买的音视频通话能力套餐不支持该功能,建议你升级套餐类型。 | 你当前购买的音视频通话能力套餐不支持该功能,建议你前往 IM 控制台 升级套餐类型。 |
十、Android Studio 如何安装 Flutter 和 Dart 插件?
可点击左上方 Android Studio -> Settings -> Plugins 下载。
十一、Flutter 环境问题如何确认?
如你需得知 Flutter 的环境是否存在问题,请运行 flutter doctor 检测 Flutter 环境是否装好。
flutter doctor
十二、交流与反馈
如果你在使用过程中,有什么建议或者意见,可以 联系我们,感谢你的反馈。