二、开通服务
请参考 开通服务 领取 TUILiveKit 体验版,并在 应用管理 页面获取以下信息:
·SDKAppID:应用标识(必填),腾讯云基于 SDKAppID 完成计费统计。
·SDKSecretKey:应用密钥,用于初始化配置文件的密钥信息。
三、环境准备
在开始运行 Demo 之前,请确保你的开发环境满足以下要求:
| 平台 | 描述 |
| Flutter | Flutter:需使用 3.29.3 或更高版本Dart:需使用 3.7.2 或更高的版本 |
| Android | Android Studio: 需使用 Android Studio 3.5 或更高版本。Android 系统:支持 Android 5.0 或 更高版本的设备。Java 版本:需使用 JDK 17。 |
| iOS | Xcode:需使用 Xcode 15 或更高版本。iOS 系统:支持 iOS 13.0 或更高版本的设备。CocoaPods 环境:已安装 CocoaPods 环境。如果你尚未安装,请参见 CocoaPods 页面安装。 |
五、获取 Demo
1. 下载源码:从 GitHub 下载 TUIKit_Flutter 源码,或者直接在命令行运行以下命令:
git clone https://github.com/Tencent-RTC/TUIKit_Flutter.git
2. 通过 Android Studio 打开 TUIKit_Flutter/application。
注意:说明:
注意:若 Android Studio 未安装 Flutter 和 Dart 插件,可参考:安装 Flutter 和 Dart 插件。
六、配置 Demo
1. 配置 sdkAppId 和 secretKey:
在 application 工程中,将获取的 sdkAppId 和 secretKey 填入 /lib/debug/generate_test_user_sig.dart 文件:
2. 配置苹果开发者签名(仅 iOS 需要):
使用 Xcode 打开 TUIKit_Flutter/application/ios 目录下的 Runner.xcworkspace 工程。
在项目 TARGETS 下的 Signing & Capabilities 界面勾选 Automatically manage signing,配置你的苹果开发者账号和 Bundle Identifier:
七、编译并运行 Demo
直播场景通常会使用到摄像头、麦克风设备,因此建议你使用真机调试和运行 Demo。
八、安装依赖
在项目根目录执行如下命令安装依赖。
flutter pub get
九、运行
以运行 Android 设备为例:
·将 Android 设备连接至电脑,在 Android 设备上打开开发者模式,启用 USB 调试,并且在 Android 设备上选择 USB 用于传输文件(如有)。
·在 Android Studio 界面顶部的 Running devices 选项中选择你用来测试的 Android 设备。
·点击运行按钮开始编译。编译成功后,你的设备上会自动安装好 Demo App。
注意:提示:
注意:为了体验完整的直播流程,建议你将 Demo 分别在两台设备上运行并登录两个不同的用户(例如,一台设备作为主播,一台设备作为观众)。
十一、登录 & 注册
运行成功后,你需要先进行登录:在 用户 id 处输入你的 UserID,如果该 UserID 未曾被使用,你将进入注册界面,可设置头像和昵称。
注意:建议设置具有高辨识度的 UserID,避免使用“1”、“123”、“111”等简单字符串,以防被占用。
| 主播端(mike) | | 观众端(vince) | |
| | | | |
十二、视频直播
请点击首页的 直播功能区 进入直播页面:
| 直播列表 | 主播开播前预览 | 主播开始视频直播 | 观众观看直播 |
| | | | |
十三、语音聊天室
请点击首页的 直播功能区 进入直播页面:
| 直播列表 | 主播开播前预览 | 主播开始语聊直播 | 观众观看语聊房 |
| | | | |
十四、下一步
Demo 跑通后,你可以根据业务需求,参考以下集成指引将对应功能集成到你的项目中:
| 功能 | 描述 | 集成指引 |
| 视频直播 | 支持超低延迟高清推流、多人连麦/PK、实时美颜、弹幕和礼物互动,轻松搭建互动视频直播场景。 | 接入指南 |
| 语音聊天室 | 提供超清音质,支持多人连麦、房主麦位管理、实时文字聊天,轻松搭建交友/游戏开黑主题房间。 | 接入指南 |
十六、CocoaPods 安装方式?
使用 gem 安装 CocoaPods:在终端中执行 sudo gem install cocoapods 命令进行安装。
注意:提示:
注意:sudo gem install cocoapods 安装过程中可能需要输入电脑密码,按提示输入管理员密码即可。
十七、Android Studio 如何安装 Flutter 和 Dart 插件?
可点击左上方 Android Studio -> Settings -> Plugins 下载。
十八、pod install 安装依赖速度慢或失败怎么办?
如果你运行 pod install 命令后,遇到安装依赖速度较慢、链接失败、下载超时等情况时,可尝试移除源,添加国内镜像源,然后再重试:
# 移除源gem sources –remove https://rubygems.org/# 添加国内镜像源 gem sources –add https://gems.ruby-china.com/
十九、真机调试?
真机运行时需要开启开发者模式。
·iOS 开启方式:将 iOS 设备连接至电脑,在设备上选择设置 > 隐私与安全性 > 开发者模式,打开开发者模式。
·Android 开启方式:在设置中找到版本号进行多次点击来开启开发者模式。如果实在找不到,还可以去手机的网站查询或者在网上搜索具体的教程。
20、运行 Demo 提示签名错误或登录失败?
请检查你在 application/lib/debug/generate_test_user_sig.dart 文件中填写的 sdkAppId 和 secretKey 是否正确,确保它们是你在 腾讯云控制台应用管理 页面获取到的密钥。
21、运行报错 Error resolving plugin [id: 'dev.flutter.flutter-plugin-loader', version: '1.0.0']
如果运行遇到如下报错信息:
* What went wrong:Error resolving plugin [id: 'dev.flutter.flutter-plugin-loader', version: '1.0.0']> Build was configured to prefer settings repositories over project repositories but repository 'xxx' was added by settings file 'settings.gradle'
请参考 获取 Demo 的步骤 4,清理 Gradle 全局配置。
23、售前咨询
当你需要购买咨询时,你可以直接通过 售前咨询 进行提问,会有专属客户经理在线为你解答,为你提供专业的上云方案。同时,你也可以直接致电销售人员,咨询热线:4009100100转1(工作日9:00 – 18:00)。
24、售后支持
当你遇到问题需要处理时,你可以直接通过 售后支持 进行提问,腾讯云工程师7 × 24小时在线为你提供服务。同时,你也可以直接致电客服人员,寻求相应的帮助,客服咨询:4009100100(7 × 24小时)。