声网在 GitHub 上提供一个开源的 MetaWorld 示例项目供你参考。
本文介绍如何快速跑通该示例项目,体验效果。
进入声网控制台的项目管理页面。
在项目管理页面,点击创建按钮。
在弹出的对话框内输入项目名称、使用场景,然后选择安全模式: APP ID + Token。
点击提交按钮。新建的项目会显示在项目管理页中。
git clone git@github.com:AgoraIO-Community/Agora-MetaWorld.git
dev_metasdk1.0
分支:git checkout dev_metasdk1.0
联系 sales@shengwang.cn 获取 Meta SDK,下载并解压。
将 SDK 包内 libs
及路径下的文件,拷贝到示例项目的 ./Agora-MetaWorld/ios/sdk/
路径下。
在 Agora-MetaWorld/ios
目录下运行 pod install
,然后等待依赖库安装完成。
运行示例项目前,你需要在 ./Agora-MetaWorld/ios/MetaChatDemo/KeyCenter.swift
文件中设置如下参数:
@objc static let CHANNEL_ID: String = "<#ChannelId#>"
@objc static let APP_ID: String = "<#AppId#>"
@objc static let certificate: String = "<#Certificate#>"
@objc static let FACE_CAPTURE_APP_ID: String = "<#Face Capture App Id#>"
@objc static let FACE_CAPTURE_CERTIFICATE: String = "<#Face Capture Certificate#>"
...
@objc static let RTC_UID: UInt = "<#UID#>"
...
@objc static let kUserKey: String = "<#kUserKey#>"
@objc static let kUserSecret: String = "<#kUserSecret#>"
在创建声网项目后,从控制台获取这些参數的值,详情如下:
参数 | 描述 | 获取方式 |
---|---|---|
AppId | 声网项目的 App ID | 获取 App ID |
Certificate | 声网项目的 App 证书 | 获取 App 证书 |
Face Capture App Id Face Capture Certificate |
声网面部捕捉插件 | 联系 sales@shengwang.cn 获取 |
kUserKey kUserSecret |
客户 ID 和密钥,声网 RESTful API 使用客户 ID 和客户密钥进行 HTTP 基本认证 | 生成客户 ID 和密钥 |
CHANNEL_ID
设置为任意字符串,RTC_UID
设置为 0 以外的任意 Int 值。点击 MetaChatDemo.xcworkspace
文件通过 Xcode 打开项目。
通过 USB 线将你的 iOS 设备接入电脑,并在 iOS Device 选项中勾选你的 iOS 设备。
在项目 TARGETS 下的 Signing & Capabilities 界面勾选 Automatically manage signing,配置你的苹果开发者账号和 Bundle Identifier。Bundle ID 用于在设备上唯一标识应用程序。在开发应用时,你需要设置 Bundle ID。
点击 开始编译。
编译成功后,你的 iOS 设备上会出现 MetaChatDemo 应用。在 iOS 系统设置中将该应用设为信任开发者后你才能打开应用。
打开应用,体验 MetaWorld 场景。在登录界面的请选择场景字段可以自行选择元语聊或元直播场景。