有奖捉虫:办公协同&微信生态&物联网文档专题 HOT
本文主要介绍如何快速运行腾讯云 TRTC-API-Example(Android)。

环境要求

最低兼容 Android 4.1(SDK API Level 16),建议使用 Android 5.0 (SDK API Level 21)及以上版本。
Android Studio 3.5 及以上版本。
App 要求 Android 4.1 及以上设备。

前提条件

您已 注册腾讯云 账号,并完成 实名认证

操作步骤

步骤1:创建新的应用

1. 登录实时音视频控制台,选择开发辅助 > 快速跑通Demo
2. 单击新建应用输入应用名称,例如 TestTRTC;若您已创建应用可单击选择已有应用
3. 根据实际业务需求添加或编辑标签,单击创建


说明
应用名称只能包含数字、中英文字符和下划线,长度不能超过15个字符。
标签用于标识和组织您在腾讯云的各种资源。例如:企业可能有多个业务部门,每个部门有1个或多个 TRTC 应用,这时,企业可以通过给 TRTC 应用添加标签来标记部门信息。标签并非必选项,您可根据实际业务需求添加或编辑。

步骤2:下载 SDK 和 TRTC-API-Example 源码

1. 根据实际业务需求下载 SDK 及 TRTC-API-Example 源码,以 Android 平台为例,这里我们推荐您通过 Github 进行克隆或者下载。
2. 下载完成后,单击已下载,下一步




步骤3:配置 TRTC-API-Example 工程文件

1. 进入修改配置页后,根据您下载的源码包,选择相应的开发环境。
2. 找到并打开 /TRTC-API-Example/Debug/src/main/java/com/tencent/trtc/debug/GenerateTestUserSig.java 文件。
3. 设置 GenerateTestUserSig.java 文件中的关键参数:
SDKAPPID:默认为 PLACEHOLDER ,请设置上一步中记录下的 SDKAppID。
SDKSECRETKEY:默认为 PLACEHOLDER ,请设置为上一步中记录下的密钥信息。



注意
本文提到的生成 UserSig 的方案是在客户端代码中配置 SDKSECRETKEY,该方法中 SDKSECRETKEY 很容易被反编译逆向破解,一旦您的密钥泄露,攻击者就可以盗用您的腾讯云流量,因此该方法仅适合本地跑通 TRTC-API-Example 和功能调试
正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端,并提供面向 App 的接口,在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig

步骤4:编译运行

在上述步骤完成后,您就可以使用 Android Studio(3.5及以上的版本)打开源码工程 TRTC-API-Example, 等待工程同步完成后,连接 Android 设备单击Android Studio 的运行即可。

常见问题

1. 两台手机同时运行 App,为什么看不到彼此的画面?

请确保两台手机在运行 App 时使用的是不同的 UserID,TRTC 不支持同一个 UserID (除非 SDKAppID 不同)在两个终端同时使用。

2. 防火墙有什么限制?

由于 SDK 使用 UDP 协议进行音视频传输,所以在对 UDP 有拦截的办公网络下无法使用。如遇到类似问题,请参见 应对公司防火墙限制 排查并解决。