You need to enable JavaScript to run this app.
导航
Flutter
最近更新时间:2024.12.02 19:05:50首次发布时间:2022.08.26 14:51:08

前提条件

  • Flutter 2.0.0 或以上版本
  • Dart 2.12.0 或以上版本
  • 如果目标平台为 Android:
    • Android Studio 3.5+
    • Android API Level 19+
    • arm64-v8a 真机、armeabi-v7a 真机
  • 如果目标平台为 iOS:
    • Xcode 12.5+
    • iOS 11.0+
    • arm64 真机
  • 已获取 RTC Demo 工程文件
  • 有效的 AppleID

步骤1:获取 AppId 和临时 Token

参考 RTC 开通服务获取 AppId 和临时 Token。

临时 Token 生成时填写的房间 ID 和用户 ID 与 Demo 登录页的房间 ID 和用户 ID 一致,若输入的房间 ID 或用户 ID 不一致,将无法进入正确房间与其他用户进行音视频通话。 临时 Token 仅用于测试或跑通 Demo,你可以通过阅读密钥说明了解更多 Token 相关信息。

步骤2:配置 Demo 工程文件

将获取到的 AppID 和 Token 填写到配置文件 ./lib/constants.dart 中对应的位置

/// appId 使用SDK前需要为自己的应用申请一个AppId,详情参见: https://www.volcengine.com/docs/6348/69865
String appId = '你的AppId';

/// token 加入房间的时候需要使用token完成鉴权,详情参见: https://www.volcengine.com/docs/6348/70121
String token = '你的Token';

/// inputRegexp SDK 对房间名、用户名的限制是:非空且最大长度不超过128位的数字、大小写字母、@ . _ -
String inputRegexp = r'^[a-zA-Z0-9@._-]{1,128}$';

步骤3:安装依赖

基于 Demo 工程文件所在目录打开终端,执行以下命令安装依赖

flutter pub get

步骤4:启动 Demo

  1. 连接运行的目标设备
    若目标平台为 iOS,需先使用 Xcode 打开 ./ios 目录下的 Runner.xcodeproj 工程文件,参考配置开发者证书配置相应的签名证书。

  2. 基于 Demo 工程文件所在目录打开终端,执行以下命令启动 Demo

flutter run
  1. 启动完成,弹出应用。输入用于生成此 Token 的房间 ID 和用户 ID,进入房间开始体验实时音视频通话。

步骤 5:体验音视频通话功能

为更好地体验实时音视频互动效果,你可以邀请一位朋友使用另一台设备运行该示例项目(需确保两个设备配置示例项目时填入的 App ID 和 AppKey 一致)。当你们输入相同的房间名加入房间后,即可在同一房间中体验音视频通话。

后续步骤

在完成音视频互动后,你可以阅读以下文档进一步了解:

  • 在测试或生产环境中,你需要使用 Token 进行鉴权。为保证通信安全,推荐从服务器中获取 Token,详情请参考使用 Token 完成鉴权
  • 在实现不同的视频通话场景时,你需要配置不同的视频发布参数以达到最佳效果,详情请参考设置视频发布参数

常见问题

如果在编译 iOS 应用时,发现有找不到 RTC SDK 中的一些头文件的报错,那么,有可能是因为你使用了 ARM64 的模拟器进行编译,请换用真机。报错类似:

找不到相关头文件