Skip to content

Latest commit

 

History

History
108 lines (65 loc) · 4.8 KB

README_zh.md

File metadata and controls

108 lines (65 loc) · 4.8 KB
Raw

Zego Express Video Example Topics iOS (Objective-C)

English | 中文

Zego Express Video iOS (Objective-C) 示例专题 Demo

准备环境

请确保开发环境满足以下技术要求：

  • Xcode 6.0 或以上版本
  • iOS 8.0 或以上版本且支持音视频的 iOS 设备或模拟器（推荐使用真机）
  • iOS 设备已经连接到 Internet

下载 SDK

如果仓库中缺少运行 Demo 工程所需的 SDK ZegoExpressEngine.xcframework，需要下载并放入 Demo 工程的 Libs 文件夹中

使用终端 (Terminal) 运行此目录下的 DownloadSDK.sh 脚本，脚本会自动下载最新版本的 SDK 并放入相应的目录下。

或者也可以手动通过下面的 URL 下载 SDK，解压后将 ZegoExpressEngine.xcframework 放在 Libs 目录下。

https://storage.zego.im/express/video/apple/zego-express-video-apple.zip

.
├── Libs
│   └── ZegoExpressEngine.xcframework
├── README_zh.md
├── README.md
├── ZegoExpressExample
└── ZegoExpressExample.xcodeproj

运行示例代码

  1. 安装 Xcode: 打开 AppStore 搜索 Xcode 并下载安装。

  2. 使用 Xcode 打开 ZegoExpressExample.xcodeproj。

    打开 Xcode，点击左上角 File -> Open...

    找到第一步下载解压得到的示例代码文件夹中的 ZegoExpressExample.xcodeproj，并点击 Open。

  3. 登录 Apple ID 账号。

    打开 Xcode, 点击左上角 Xcode -> Preference，选择 Account 选项卡，点击左下角的 + 号，选择添加 Apple ID。

    输入 Apple ID 和密码以登录。

  4. 修改开发者证书。

    打开 Xcode，点击左侧的项目 ZegoExpressExample

    点击 Signing & Capabilities 选项卡，在 Team 中选择自己的开发者证书

  5. 下载的示例代码中缺少 SDK 初始化必须的 AppID、UserID 和 Token，到 ZEGO 管理控制台 申请 AppID、UserID 与 Token。如果没有填写正确的 AppID、UserID 和 Token，源码无法正常跑起来，所以需要修改 ZegoExpressExample/ 目录下的 KeyCenter.m，填写正确的 AppID、UserID 和 Token。

    // Developers can get appID from admin console.
// https://console.zego.im/dashboard
// for example: 123456789;
static unsigned int _appID = <#Enter your appID#>;

// Developers should customize a user ID.
// for example: @"zego_benjamin";
static NSString *_userID = @"<#Enter your userID#>";

// Developers can get token from admin console.
// https://console.zego.im/dashboard
// Note: The user ID used to generate the token needs to be the same as the userID filled in above!
// for example: @"04AAAAAxxxxxxxxxxxxxx";
static NSString *_token = @"<#Enter your token#>";

  6. 将 iOS 设备连接到电脑，点击 Xcode 左上角的 🔨 Generic iOS Device 选择该 iOS 设备（或者模拟器）

  7. 点击 Xcode 左上角的 Build 按钮进行编译和运行。

常见问题

  1. The app ID "im.zego.ZegoExpressExample" cannot be registered to your development team. Change your bundle identifier to a unique string to try again.

    参考上面的 修改开发者证书和 Bundle Identifier，在 Targets -> Signing & Capabilities 中切换为自己的开发证书并修改 Bundle Identifier 后再运行。

  2. dyld: Library not loaded

    此为 iOS 13.3.1 的 bug，请升级至 iOS 13.4 或以上版本即可解决。