Android

最近更新时间:2026-02-06 19:55:59

我的收藏
本文介绍了如何快速运行腾讯云 TRTC(实时音视频) Android SDK Demo。



前提条件

开通服务

1. 登录 实时音视频控制台,单击创建应用 。如果您已经完成创建,可以跳过该操作。
2. 在创建应用成功后,您可以在应用管理中获取到您的 SDKAppID SDK 密钥


环境准备

在开始之前,请确保您已满足下列要求:
最低兼容 Android 4.4(SDK API Level 19),建议使用 Android 5.0 (SDK API Level 21)及以上版本。
Android Studio 4.0 及以上版本。
两部 Android 4.4 及以上设备。
版本兼容性说明:
为确保构建环境稳定,请严格遵循官方兼容性要求进行配置:
Gradle、Android Gradle Plugin、JDK 与 Android Studio 的兼容性,请参阅 Android 官方文档:版本说明
Kotlin、Android Gradle Plugin 与 Gradle 的版本映射关系,请参阅 Kotlin 官方文档:Kotlin-Gradle 插件兼容性
我们建议您根据上述指南,选择与项目要求完全匹配的版本组合。

操作步骤

获取 Demo

您可以在 GitHub 下载 Android 平台的示例代码,或者在终端运行以下命令:

配置 Demo

1. 您需要将TRTC-API-Example/Debug/src/main/java/com.tencent.trtc.debug目录下GenerateTestUserSig中的 SDKAPPID SDKSECRETKEY 替换为您在步骤2中获取到的值。



注意:
本文使用的生成 UserSig 的方案是在本地配置 SDKSecretKey,该方法中 SDKSecretKey 很容易被反编译逆向破解,一旦您的密钥泄露,攻击者就可以盗用您的腾讯云流量,因此该方法仅适合本地跑通 Demo 和功能调试。正确的 UserSig 签发方式是在您的服务端集成 服务端生成 UserSig,当用户进房时:
发起 HTTP 请求到您的服务端
服务端生成一个 UserSig
将其返回给用户供进房使用
若要将 Demo 部署到公网体验,需要通过 HTTPS 协议,即https://域名/xxx访问,原因可参见文档 页面访问协议限制说明

编译 Demo

启动 Android Studio ,打开 TRTC_Android/TRTC-API-Example 目录。
说明:
初次导入 Demo 工程会下载较多依赖项,请耐心等待下载和同步完成后再运行。
以运行 Android 设备为例:
1. 将 Android 设备连接至电脑,在 Android 设备上打开开发者模式,启用 USB 调试,并且在 Android 设备上选择 USB 用于传输文件(如有)。
2. 在 Android Studio 界面顶部的 Running devices 选项中选择您用来测试的 Android 设备。

3. 点击运行按钮开始编译。编译成功后,您的设备上会自动安装好腾讯云 TRTC-API-Example App。
说明:
本 Demo 默认集成了音视频通话功能,由于该功能依赖的音视频 SDK 暂不支持模拟器,因此建议使用真机调试、运行 Demo。

运行 Demo

视频互动直播

1. 进入应用后,点击视频互动直播,设备 A 和设备 B 输入相同的房间号和不同的用户名,并点击进入房间,如下图示:
设备A
设备A

设备B
设备B

2. 进入房间后,可以切换摄像头、开启/关闭摄像头、开启/关闭麦克风,如下图所示:


常见问题

如果您的接入和使用中遇到问题,请参见 常见问题

联系我们

如果您在接入或使用过程中有任何疑问或者建议,欢迎 联系我们 提交反馈。