低延迟直播
  • iOS : Objective-C
  • Android
  • macOS
  • Windows
  • Web
  • 产品介绍
    • 概述
    • 发布日志
    • 计费说明
  • 下载
  • 快速开始
    • 跑通示例源码
    • 集成 SDK
    • 实现流程
  • 基础功能
    • 常用视频配置
    • 视频画面旋转
    • 通话质量监测
    • 混流
    • 使用 CDN 直播
    • 通过 URL 拉流
    • 媒体播放器
    • 房间实时消息
    • 美颜/水印/截图
  • 进阶功能
  • 最佳实践
  • 常见错误码
  • 服务端 API
  • 客户端 API
  • 常见问题
示例源码
本地下载

示例源码运行指引

ZEGO已统一环境概念,不再有正式/测试之分,2021-11-16 及之前在 ZEGO 控制台 创建项目的用户,请参考 测试环境废弃说明 进行 SDK 升级和调整相关代码。

本文介绍如何快速跑通示例源码,体验基础的音视频通话服务。

1 准备环境

在运行示例源码前,请确保开发环境满足以下要求:

  • Xcode 7.0 或以上版本。
  • iOS 9.0 或以上版本且支持音视频的 iOS 设备或模拟器(推荐使用真机)。
  • iOS 设备已经连接到 Internet。

2 前提条件

已在 ZEGO 控制台 创建项目,并申请有效的 AppID 和 AppSign,详情请参考 控制台 - 项目管理

3 运行示例源码

  1. 打开 “AppStore”,搜索 “Xcode” 并下载安装。

  2. 使用 Xcode 打开 “ZegoExpressExample.xcodeproj” 文件。

    1. 打开 Xcode,选择左上角的菜单 “File > Open...”。

    2. 在解压后的示例源码文件夹中,找到 “ZegoExpressExample.xcodeproj” 文件打开。

  3. 登录 Apple 开发者账号。

    1. 打开 Xcode,选择左上角的菜单 “Xcode > Preferences...”。

      /Pics/iOS/ZegoExpressEngine/Common/xcode_preferences.png

    2. 单击 “Accounts” 选项卡,单击左下角的 “+”,选择添加 “Apple ID”,单击 “Continue”。

    3. 输入 Apple ID 和 Password 登录。

  4. 修改 Bundle Identifier 和开发者证书。

    1. 打开 Xcode,单击左侧的 “ZegoExpressExample” 项目。

    2. 打开 TARGETS 选项,开发者可以根据需求,单击 “General” 选项卡,修改项目的 Bundle Identifier;单击 “Signing & Capabilities” 选项卡,选择自己的开发者证书。

      /Pics/iOS/ZegoExpressEngine/Common/bundle_id.png
      /Pics/iOS/ZegoExpressEngine/Common/team_signing_new.png

  5. 下载的示例源码中缺少 SDK 初始化所需的 AppID 和 AppSign,需要修改 “ZegoExpressExample” 文件夹下的 “KeyCenter.m” 文件,请使用本文 2 前提条件 已获取的 AppID 和 AppSign 正确填写,否则示例源码无法正常运行。

    + (unsigned int)appID {
        return 1333333333; // Please enter your AppID
    }
    
    + (NSString *)appSign {
        return @"abcdefghijklmnopqrstuvwzyv123456789abcdefghijklmnopqrstuvwzyz123";  // Please enter your AppSign
    }
  6. 将 iOS 设备连接到开发电脑,单击 Xcode 上方的的 “Any iOS Device”,在弹出的选项框选择该 iOS 设备(或者模拟器)。

    /Pics/iOS/ZegoExpressEngine/Common/xcode_select_device_new.png
    /Pics/iOS/ZegoExpressEngine/Common/xcode_select_real_device_new.png

  7. 单击 Xcode 左上角的 “Build” 按钮编译和运行示例源码。

    /Pics/iOS/ZegoExpressEngine/Common/build_and_run_new.png

4 体验实时音视频功能

在真机中运行项目,运行成功后,可以看到本端视频画面。

为方便体验,ZEGO 提供了一个 Web 端调试示例 ,在该页面下,输入相同的 AppID、RoomID、Server 地址和 Token,即可加入同一房间与真机设备互通。当成功开始音视频通话时,可以听到远端的音频,看到远端的视频画面。