Android

最近更新时间:2024-10-09 10:24:41

我的收藏
说明:
为了帮助您更好地上手移动端直播 APP 的搭建工作,我们推出了腾讯云 MLVB-API-Example Demo,您可以根据下列操作指引快速跑通 Demo。
本文主要介绍如何快速运行腾讯云 MLVB-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 及以上设备。

前提条件

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

操作步骤

步骤一:下载 SDK 和 MLVB-API-Example 源码

1. 根据实际业务需求 下载 相应的压缩包,这里以 Professional 为例。
2. 下载完成后,解压。



注意:
源码也可以从 Github 获得。

步骤二:配置 License

1. 登录 云直播控制台,在左侧菜单中选择直播 SDK >License 管理,单击新建测试 License


2. 根据实际需求填写 App NamePackage NameBundle ID,勾选功能模块 直播(直播推流 + 视频播放),单击确定
Package Name:请在 App 目录下的 build.gradle 文件查看 applicationId
Bundle ID:请在 xcode 中查看项目的 Bundle Identifier



3. 测试版 License 成功创建后,页面会显示生成的 License 信息。在 SDK 初始化配置时需要传入 Key 和 License URL 两个参数,请妥善保存以下信息。



4. 打开 LiteAVSDK_Professional_Android版本号/MLVB-API-Example/Debug/src/main/java/com/tencent/mlvb/debug/GenerateTestUserSig.java 文件,设置 GenerateTestUserSig.java 文件中的相关参数:
LICENSEURL:默认为 PLACEHOLDER,请设置为您的下载 Licence url。
LICENSEURLKEY:默认为 PLACEHOLDER,请设置为您的下载 Licence key。




步骤三:配置推流/播放能力

1. 域名注册 申请域名,并备案成功。
2. 云直播控制台 > 域名管理 中添加推流/播放域名,具体操作请参见 添加自有域名
3. 成功 配置域名 CNAME
4. 配置好推流/播放域名后,在推流/播放域名的 基本信息 页面可以获得 CNAME 信息。



5. 打开 LiteAVSDK_Professional_Android版本号/MLVB-API-Example/Debug/src/main/java/com/tencent/mlvb/debug/GenerateTestUserSig.java 文件。设置 GenerateTestUserSig.java 文件中的相关参数:
PUSH_DOMAIN:请设置为您的 推流域名
PLAY_DOMAIN:请设置为您的 播放域名
LIVE_URL_KEY:非必需,用于生成 txSecret 等鉴权信息,具体计算请参见 推拉流 URL,查询步骤参见 域名页面 > 管理 > 推流配置 > 鉴权配置




步骤四:配置连麦或 PK 能力/服务开通

注意:
直播连麦现已全面升级,新版连麦方案 基于实时音视频 TRTC 能力实现,跑通 Demo 时会统计所有参与连麦/PK 的用户产生的视频时长和语音时长用量,收取实时音视频 TRTC 音视频时长费用。计费说明请参见 新版连麦方案计费
测试连麦及直播 CDN 观看功能时请注意测试时长,避免因为长时间测试消耗引起账号欠费。若您是实时音视频 TRTC 新账号,首次可前往 试用中心 免费领取10000分钟音视频时长用于体验测试连麦功能。
1. 登录云直播控制台,选择连麦管理 > 连麦应用
2. 单击新建连麦应用 ,输入应用名称,例如 V2Demo ,单击 确定
3. 创建成功后,单击应用列表中 应用名称V2Demo 这行右侧的 管理 ,查看应用对应的 SDKAppID 和密钥信息。


4. 若您的播放端需要进行 CDN 播放,则需要在连麦管理 > 连麦应用 中选择 V2Demo 行右侧的管理,选择 CDN 观看配置 页,开启旁路推流功能。


说明
旁路推流的方式默认选择 指定流旁路 即可,对于 V2TXLivePusher 两种方式没有区别。

配置推流参数

1. 找到并打开 LiteAVSDK_Professional_Android版本号/MLVB-API-Example/Debug/src/main/java/com/tencent/mlvb/debug/GenerateTestUserSig.java 文件。
2. 根据上面 服务开通 设置 GenerateTestUserSig.java 文件中的相关参数:
SDKAPPID:默认为 PLACEHOLDER,请设置为实际的 SDKAppID。
SECRETKEY:默认为 PLACEHOLDER,请设置为实际的密钥信息。




推流 URL 字段说明

具体的推拉流 URL 字符串,需要开发者按照对应的协议自行拼接,拼装方案请参见 推拉流 URL。Demo 中已经拼接好,运行后即可播放。

步骤五:编译运行

使用 Android Studio(3.5及以上的版本)打开源码工程 MLVB-API-Example,单击 运行 即可。