MetaWorld 虚拟世界
  • iOS : Objective-C
  • Android
  • 产品简介
  • 下载
  • 快速开始
    • 跑通示例源码
    • 集成 MetaWorld SDK
    • 设置 License 鉴权
    • 实现 MetaWorld 基本场景
  • 基础能力
  • 客户端 API
  • 常见错误码
  • 常见问题
  • 文档中心
  • MetaWorld 虚拟世界
  • 快速开始
  • 跑通示例源码

跑通示例源码

更新时间:2023-10-20 14:45

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

准备环境

  • Xcode 14.0 或以上版本。
  • iOS 11.0 或以上版本且支持音视频的 iOS 设备(真机)。
  • iOS 设备已经连接到 Internet。

前提条件

  • 已在 ZEGO 控制台 创建项目,并申请有效的 AppID 和 AppSign,详情请参考 控制台 - 项目管理 中的“项目信息”。
  • 已联系 ZEGO 商务人员,提供自己项目的 Bundle ID,开通相关权限。
  • 已联系 ZEGO 商务人员,开通 Express SDK 的 多人状态实时同步 服务的权限。
  • 已在 下载 页面,获取 SDK 和示例源码包。

示例源码目录结构

下列结构为 MetaWorld 源码文件的子目录结构,下文所涉及的文件路径均为相对于此目录的路径。

.
├── Framework-----------------------------------工程依赖相关第三方库
|    ├──ZegoExpressEngine.xcframework ----------Express 的动态库
|    ├──MetaWorld.framework --------------------MetaWorld 动态库
├── LicenseHelper ------------------------------鉴权帮助类
|     ├──ZegoConstantDefine.h -------------------填写申请的 AppID、AppSign
|
├── QuickStartDemo
     ├── QuickStartDemo-------------------------包含工程相关的源文件
            ├──VirtualKTVDemo-------------------包含在示例 demo 里的一个可运行场景
     ├── QuickStartDemo.xcodeproj---------------工程文件

运行示例源码

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

    /Pics/iOS/GoClass/appstore-xcode.png

  2. 解压下载到的示例源码文件,使用 Xcode 打开 “QuickStartDemo.xcodeproj” 文件。

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

    /Pics/iOS/GoClass/xcode-open-file.png

    b. 在解压后的示例源码文件夹中选择 “QuickStartDemo.xcodeproj”,并单击 “Open”。

    /Pics/1.png

  3. 登录 Apple 开发者账号。

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

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

    /Pics/iOS/ZegoExpressEngine/Common/xcode-account.png

    c. 输入 Apple ID 和 Password 登录。

    /Pics/iOS/GoClass/xcode-login-apple-id.png

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

    a. 打开 Xcode,单击左侧的 “QuickStartDemo” 项目。
    b. 打开 TARGETS 选项,单击 “Signing & Capabilities” 选项卡,在 Team 中选择自己的开发者证书。

    /Pics/2.png

  5. 示例源码中缺少 SDK 初始化所需的 AppID 和 AppSign,需要修改 “QuickStartDemo/LicenseHelper” 路径下的 “ZegoConstantDefine.h” 文件。请使用本文 “前提条件” 已获取的 AppID 和 AppSign 正确填写,否则示例源码无法正常运行。

    由于 Zego MetaWorld SDK 需要与 ZEGO Express SDK 搭配使用,示例源码中包含了两个 SDK,运行时需要分别进行鉴权,鉴权通过才能正常运行。

    • Zego MetaWorld SDK 采用 “在线鉴权”,ZEGO 实现了一个简单的在线 License 鉴权,您可以直接使用,但请注意 License 的有效期限。License 的有效期限与您购买的套餐相关,请联系 ZEGO 商务人员咨询。

    • ZEGO Express SDK 需要在调用 createEngineWithProfile 接口初始化时,传入 AppSign 进行鉴权。

    /Pics/ZegoMetaWorld/iOS/Xcode_AppID_AppSign.png

  6. 将 iOS 设备连接到开发电脑,单击 Xcode 上方的的 “Any iOS Device”,在弹出的选项框选择该 iOS 设备。

    /Pics/4.png

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

    /Pics/6.png

本篇目录