帮你快速理解、总结文档立即下载

iOS

最近更新时间:2026-11-17 17:54:31
本文档已由 AI 辅助审校
我的收藏
说明:
为了帮助您更好地上手移动端直播 APP 的搭建工作,我们推出了腾讯云 MLVB-API-Example Demo,您可以根据下列操作指引快速跑通 Demo。
本文主要介绍如何快速运行腾讯云 MLVB-API-Example(iOS)。

环境要求

Xcode 9.0+。
iOS 9.0 以上的 iPhone 或者 iPad 真机。
项目已配置有效的开发者签名。

前提条件

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

操作步骤

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

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



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

步骤二:配置 License

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

2. 根据实际需求填写 App Name、Package Name 和 Bundle ID,勾选功能模块直播(直播推流 + 视频播放),单击确定。
Bundle ID:在 Xcode 中,选中项目 Target​ → General​ → Identity​ 区域,查看 Bundle Identifier​ 字段。

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

4. 打开 LiteAVSDK_Professional_iOS_版本号/MLVB-API-Example-OC/Debug/GenerateTestUserSig.h 文件。 设置 GenerateTestUserSig.h 文件中的相关参数:
LICENSEURL:默认为空,请设置为您的下载 License URL。
LICENSEURLKEY:默认为空,请设置为您的下载 License key。


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

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

5. 打开 LiteAVSDK_Professional_iOS_版本号/MLVB-API-Example-OC/Debug/GenerateTestUserSig.h 文件。 设置 GenerateTestUserSig.h 文件中的相关参数:
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_iOS_版本号/MLVB-API-Example-OC/Debug/GenerateTestUserSig.h 文件。
2. 根据上面 配置 Licence 设置 GenerateTestUserSig.h 文件中的相关参数:
SDKAppID:默认为 0 ,请设置为实际的 SDKAppID。
SDKSECRETKEY:默认为空 ,请设置为实际的密钥信息。


推流 URL 字段说明

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

步骤五:编译运行

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