跳到主要内容

运行示例项目（Demo）

融云音视频产品提供一个功能体验 QuickDemo 示例应用项目（Github · Gitee），集中演示了融云实时音视频产品 音视频通话、音视频会议、低延迟直播 在 iOS 端的功能，以便开发者体验产品，快速集成，实现单群聊、音视频通话、语音聊天室、娱乐直播、教学课堂、多人会议等场景需求。

QuickDemo 按场景和功能分为多个模块，对主要功能进行演示。 QuickDemo 开放源代码，您可以对感兴趣的部分进行代码改造，以便进一步了解细节。

融云开发者账户​

  1. 访问融云控制台，注册您的开发者账号。注册成功后，控制台自动在开发环境中为您创建一个应用。

  2. 在控制台的密钥管理页面，获取您的应用在开发环境的 AppKey。您可在密钥管理页面查看应用的信息，如 App Key、App Secret、所属数据中心（默认为北京）。 alt text 您也可以创建应用，并获取对应环境 App Key 和 App Secret。

    提示

    每个应用均拥有两个不同的 App Key，分别对应开发环境与生产环境，且两个环境之间数据相互隔离。在您的应用正式上线前，建议切换到生产环境的 App Key，以便完成上线前全流程测试和最终发布。

  • 如果仅为体验 QuickDemo 创建应用，建议选择国内数据中心。如果选择海外数据中心，则需要额外在 QuickDemo 中修改 SDK 连接的服务地址。配置方法可参见 数据中心。

开通音视频服务​

开发环境下的每个应用均可享有 10000 分钟免费体验时长。如果在开发环境下开通音视频服务，可直接按照以下步骤，开通音视频服务即可开始免费体验和测试。免费体验时长用完即止。

如果在生产环境下开通音视频服务，则需要先预存费用，才可开通。详情请参考 开通音视频服务。

提示
  • 服务开通、关闭等设置完成后 15 分钟后生效。
  • 客户端配置文件更新最长 2 小时，您可以在服务生效后卸载重装来立刻获取最新配置。

运行 QuickDemo​

在运行 QuickDemo 前请确保已完成上述步骤。以下是检查清单：

  • 已注册融云开发者账户
  • 已准备好 App Key 和 App Secret
  • 已开通音视频服务免费体验，且已等待 15 分钟。

步骤 1：下载并加载 QuickDemo 代码​

  1. 在终端克隆下载示例代码。

    shell
    git clone https://github.com/rongcloud/rtc-quickdemo-ios.git

  2. 进入 QuickDemo 文件夹，在终端执行以下命令，下载依赖库。

    shell
    $ pod install
    提示

    如果终端中出现类似 CocoaPods could not find compatible versions for 等找不到相关版本的报错，可先在终端中执行 pod repo update 命令，再执行 pod install 命令。

  3. 使用 XCode 加载 xcworkspace 文件，即 QuickDemo 工程。

  4. 找到 /RCRTCQuickDemo/Tool/Constant/Constant.m 里的 AppKey 和 AppSecret 并替换为从控制台获取到的具体内容，然后去掉 #error 提醒。

    Objective C
    /*!
    请填写 App Key
    获取地址: https://console.rongcloud.cn/agile/apps/km
    */
    NSString * const AppKey = @"";

    /*!
    请填写 App Secret
    获取Token 需要提供 App Key 和 App Secret
    正式环境请勿在客户端请求 Token，您的客户端代码一旦被反编译，会导致您的 AppSecret 泄露。
    请务必确保在服务端获取 Token。
    */
    NSString * const AppSecret = @"";
危险

本教程中直接在客户端代码中写入 APP_SECRET 的行为仅为演示目的。 APP_SECRET 可用来获取用户身份令牌（Token），以及实现人员禁言、房间踢人等高级能力。 存储在客户端代码里很容易被反编译导致泄漏。 APP_SECRET 一旦泄露，攻击者就可以盗取 SDK 服务流量，或进行高权限破坏性操作。

正确的方式是将 APP_SECRET 存储在您的应用服务端，并提供面向应用客户端的接口。 更多详情请参见音视频服务端开发文档。

步骤 2：修改 Bundle ID​

  1. 修改工程中 RCRTCQuickDemo 的 Bundle Identifier，例如：cn.rongcloud.rtcquickdemo。

    (height=400)

  2. 修改工程中 ScreenShare 的 Bundle Identifier，保持跟前面一致，在最后添加 screenshare，例如：cn.rongcloud.rtcquickdemo.screenshare。

    (height=400)

  3. 修改工程中 RCRTCQuickDemo 和 ScreenShare 的 App Group 配置，修改成与 screenshare 相同的 Bundle Identifier。

    (height=400)

    (height=400)

步骤 3：编译运行​

运行成功后输入用户 ID，即可进入体验。建议在真实设备上运行。

(height=500)