跑通示例项目

  • iOS

更新时间

了解如何快速接入秀场直播,完成环境准备、参数配置、示例运行和核心流程验证。

本文介绍如何快速跑通 VideoLoaderAPI 示例项目,体验直播应用中视频的秒开和秒切效果。

前提条件

开始前,请确保满足以下前提条件:

  • Git
  • CocoaPods
  • Xcode 12.0 及以上
  • 有效的苹果开发者账号
  • 开通秀场直播服务
  • iOS 设备,版本 13.0 及以上

    注意

    声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。

克隆仓库

运行以下命令克隆仓库到本地:

Shell
git clone git@github.com:AgoraIO-Community/VideoLoaderAPI.git

配置示例项目

按照如下步骤进行配置:

  1. 运行秀场直播项目前,你需要在 iOS/AgoraEntScenarios/KeyCenter.swift 文件中设置如下参数:

    Swift
    static let AppId: String = <#YOUR APPID#>
    static let Certificate: String? = <#YOUR Certificate#>
    static let CloudPlayerKey: String? = <#Your CloudPlayerKey#>
    static let CloudPlayerSecret: String? = <#Your CloudPlayerSecret#>

    你可以在创建声网项目后,从控制台获取这些参数的值,详情如下:

    参数描述获取方式
    AppId声网项目的 App ID获取 App ID
    Certificate声网项目的 App 证书获取 App 证书
    CloudPlayerKey声网输入在线媒体流 RESTful 服务所需的客户 ID生成客户 ID 和密钥
    CloudPlayerSecret声网输入在线媒体流 RESTful 服务所需的客户密钥生成客户 ID 和密钥
    表格内容超出当前宽度,可横向滚动查看更多列。
  2. 在 VideoLoaderAPI/iOS/Example 目录下,运行 pod install,然后等待依赖库安装完成。安装完成后,会出现 VideoLoaderAPI.xcworkspace 文件。

编译并运行示例项目

按照如下步骤进行操作:

  1. 连接上 iOS 设备后,点击 VideoLoaderAPI.xcworkspace 文件以通过 Xcode 打开项目,并在 iOS Device 选项中勾选上你的 iOS 设备。

  2. 在项目 TARGETS 下的 Signing & Capabilities 界面勾选 Automatically manage signing,配置你的苹果开发者账号和 Bundle Identifier。Bundle ID 用于在设备上唯一标识应用程序。在开发应用时,你需要设置 Bundle ID。

  3. 点击运行按钮 运行按钮图标 开始编译。

  4. 编译成功后,你的 iOS 设备上会出现秒切秒开应用。在 iOS 系统设置中将该应用设为信任开发者后你才能打开应用。

  5. 打开应用,点击任意一个房间,即可进入房间并体验秒开。在房间内,上下滑动,即可切换房间并体验秒切。