tencent cloud

直播 SDK

动态与公告
TUILiveKit 产品动态
云直播推拉流 SDK 产品动态
新手指引
产品简介
产品概述
产品优势
性能数据
基本概念
购买指南
TRTC Live 价格总览
Live 视频直播计费说明
开通服务(TUILiveKit)
Demo 体验
Demo 体验指引
跑通 Demo(TUILiveKit)
接入指南
视频直播
准备工作
主播开播
观众观看
直播列表
语聊房
准备工作
主播开播
观众观看
直播列表
推流助手
推流助手(Electron 桌面应用)
推流助手(Web 桌面浏览器)
直播监播
监播页面(Web 桌面浏览器 React 版)
监播页面(Web 桌面浏览器 Vue 版)
UI 自定义
直播视频组件
视频源编辑组件
观众列表组件
聊天弹幕组件
媒体源配置面板
连麦管理面板
直播送礼组件
无 UI 集成
搭建视频直播
搭建语聊房
功能指南
关注主播(TUILiveKit)
至臻画质(TUILiveKit)
输入媒体流进房(TUILiveKit)
礼物系统(TUILiveKit)
客户端 API
Android
iOS
Web
服务端 API(TUILiveKit)
账号系统
REST API
第三方回调
错误码(TUILiveKit)
常见问题
平台编译
用户鉴权
云直播推拉流 SDK
产品简介
购买指南
Demo 体验
免费测试
SDK 下载
License 管理
高级功能
客户端 API
常见问题
无 UI 集成方案
API 文档
OSS information
OSS Attribution Notice

Android

聚焦模式
字号
最后更新时间: 2026-03-11 13:01:18
本文将指导您如何在 10 分钟内快速跑通 TUILiveKitAndroid Demo,体验包含完整 UI 界面的视频直播/语音聊天室功能。

快速体验

您可以直接通过以下方式体验 Live 的各项功能。


前提条件

开通服务

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

环境准备

Android 5.0 (SDK API level 21)及以上。
Gradle 8.0 及以上。
两台 Android 5.0 以上的设备。

操作步骤

获取 Demo

1. 下载源码:从 GitHub 下载 TUIKit_Android 源码,或者直接在命令行运行以下命令:
2. 打开工程:通过 Android Studio 打开 TUILiveKit Android 项目:


配置 Demo

1. 配置 SDKAppIDSDKSecretKey打开TUIKit_Android/application/debug/src/main/java/com/tencent/qcloud/tuikit/debug/GenerateTestUserSig.java文件,将获取的 SDKAppIDSDKSecretKey 填入:


编译并运行 Demo

1. Android Studio 右上角如下图所示处选择您要将 Demo 运行的设备:



2. 选择完成后点击运行,将 TUIKit_Android 运行到目标设备上。



注意:
为了使您可以体验完整的视频直播流程,请将 Demo 分别在两台设备上登录两个用户,一方作为主播,一方作为观众。

体验基础功能

1. 登录 & 注册

请您在用户ID处输入的 ID 。如果您当前的 UserID 未曾被使用过,此时会进入到注册界面,您可以在该界面为自己设置头像及昵称。
主播端(mike)
观众端(vince)












注意:
尽量避免使您的 UserID 被设置成“1”、“123”、“111”等简单字符串,由于 TRTC 不支持同一个 UserID 多端登录,所以在多人协作开发时,形如 “1”、“123”、“111” 这样的 UserID 很容易被您的同事占用,导致登录失败,因此我们建议您在调试的时候设置一些辨识度高的 UserID。

2. 视频直播

点击直播 -> 在线直播来体验视频直播。
直播列表
主播开播前预览
主播开始视频直播
观众观看直播













3. 语音聊天室

点击直播 -> 语聊房开始语聊直播。
直播列表
主播开播前预览
主播开始语聊直播
观众观看语聊房













下一步

Demo 跑通后,您可以根据业务需求,参考以下集成指引将对应功能集成到您的项目中:

描述
集成指引
视频直播
支持超低延迟高清推流、多人连麦/PK、实时美颜、弹幕和礼物互动,轻松搭建互动视频直播场景。
语音聊天室
提供超清音质,支持多人连麦、房主麦位管理、实时文字聊天,轻松搭建 K 歌/交友/游戏开黑主题房间。

常见问题

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

请检查您在 TUIKit_Android/application/debug/src/main/java/com/tencent/qcloud/tuikit/debug/GenerateTestUserSig.java 文件中填写的 SDKAppIDSDKSecretKey 是否正确,确保它们是您在TRTC 控制台页面获取到的密钥。

Gradle 版本低于 8.0 影响 Demo 运行报错

是的, Gradle 版本过低,会导致依赖下载失败或编译错误,请您在 Android Studio 中升级 Gradle 版本至符合要求的范围。

进房后报错,错误码为“-3301”,报错信息“Services are not available in your region.”

如果您收到该错误码信息,请联系我们获取支持。

联系我们

如果您在接入或使用过程中有任何疑问或者建议,欢迎加入 Telegram 技术交流群组,或联系我们获取支持。


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈