React Native

最近更新时间:2026-01-16 11:03:32

我的收藏
将为您介绍如何快速跑通视频直播 Demo。跟随本文档,您可以在 10 分钟内跑通 Demo,并最终体验一个包含完备 UI 界面的视频直播功能。
主播直播页
连麦管理页
观众观看页




前提条件

开通服务

请参考 开通服务 领取 TUILiveKit 体验版,并在 应用管理 页面获取以下信息:
SDKAppID:应用标识(必填),腾讯云基于 SDKAppID 完成计费统计。
SDKSecretKey:应用密钥,用于初始化配置文件的密钥信息。

环境准备

Node.js:≥ 20.0.0 (推荐使用官方 LTS 版本)。
Yarn:≥ 4.11.0。
Android Studio(Android 开发)。
Xcode 14+(iOS 开发,仅限 macOS)。
CocoaPods 环境:已安装 CocoaPods 环境。如果您尚未安装,请参见 CocoaPods 官网安装,或按以下步骤操作:
使用 gem 安装 CocoaPods:在终端中执行 sudo gem install cocoapods 命令进行安装。
提示:
sudo gem install cocoapods 安装过程中可能需要输入电脑密码,按提示输入管理员密码即可。
设备:两部摄像头、麦克风正常的手机。

操作步骤

获取 Demo

1. 从 GitHub 下载 TUILiveKit Demo 源码,或者直接在命令行运行以下命令:
git clone https://github.com/Tencent-RTC/TUIKit_ReactNative.git
2. 安装依赖。
cd TUIKit_ReactNative

yarn install
3. 安装 iOS Pod 依赖(如果仅运行 Android 平台,此步骤可以忽略)
cd application/ios

pod install

配置 Demo

1. 配置 SDKAppIDSDKSecretKey: 您需要参考本文的前提条件,在 Demo 中打开 TUIKit_ReactNative/application/src/debug/UserSigGenerator.ts文件,输入准备工作中激活服务时获得的 SDKAppIDSDKSecretKey
// Your SDKAppID
export const sdkAppID = 0;
// Your SDKSECRETKEY
const SDKSECRETKEY = "";
2. 配置苹果开发者签名(跑通安卓平台可忽略此步骤):在项目 TARGETS 下的 Signing & Capabilities 界面勾选 Automatically manage signing,配置您的苹果开发者账号和 Bundle Identifier


编译并运行 Demo

运行至 Android 平台
运行至 iOS 平台
cd TUIKit_ReactNative/application
yarn android
cd TUIKit_ReactNative/application

yarn ios

直播推流与观看

1. 登录/注册 userID(由您定义)

注意:
TUILiveKit 不支持同一个 UserID 多端登录,在多人协作开发时, “1”、“123”、“111” 这种简单的 UserID 很容易被占用,导致登录失败,因此建议在调试时设置辨识度较高的 UserID。为了使您可以体验完整的视频直播流程,请将 Demo 分别在两台设备上登录两个用户,一方作为主播,一方作为观众;
2. 主播开启直播。
单击主页底部中间的按钮,即可进入开播预览页面,再单击开始直播按钮即可开始直播了。
直播列表页
主播预览页
主播开播页



3. 观众加入直播间。
您可以在另外一台设备上,使用不同的 userID 登录作为观众进行体验,您可以单击直播列表里任意一个房间,也可以通过输入 liveID 进入特定直播间,即可观看直播,您也可以在直播间跟主播进行连麦、赠送礼物,发送互动消息等等。
直播列表页
礼物选择页
观众观看页





下一步

Demo 跑通后,您可以根据业务需求,参考以下集成指引将对应功能集成到您的项目中:
页面
文档链接
主播开播
观众观看
直播列表

联系我们

售前咨询

当您需要购买咨询时,您可以直接通过 售前咨询 进行提问,会有专属客户经理在线为您解答,为您提供专业的上云方案。同时,您也可以直接致电销售人员,咨询热线:4009100100转1(工作日9:00 - 18:00)。

售后支持

当您遇到问题需要处理时,您可以直接通过 售后支持 进行提问,腾讯云工程师7 × 24小时在线为您提供服务。同时,您也可以直接致电客服人员,寻求相应的帮助,客服咨询:4009100100(7 × 24小时)。

常见问题

运行 Demo 提示签名错误或登录失败?

请检查您在 TUIKit_ReactNative/application/src/debug/UserSigGenerator.ts 文件中填写的 SDKAppIDSDKSecretKey 是否正确,确保它们是您在 腾讯云控制台应用管理 页面获取到的密钥。

React Native 环境问题如何确认?

如您需得知 React Native 的环境是否存在问题,请运行 npx react-native doctor 检测 React Native 环境是否装好。
npx react-native doctor

pod install 安装依赖速度慢或失败怎么办?

如果您运行 pod install 命令后,遇到安装依赖速度较慢、链接失败、下载超时等情况时,可尝试移除官方源,添加国内镜像源,然后再重试:
# 移除官方源
gem sources --remove https://rubygems.org/
# 添加国内镜像源
gem sources --add https://gems.ruby-china.com/