本文介绍如何集成互动游戏 aPaaS 解决方案。
集成互动游戏 aPaaS 解决方案前,请确保已经具备以下条件:
有效的声网开发者账号。如果你还没有创建过声网开发者账号,参考注册与登录。
有效的声网项目,如果你还没有创建过项目,参考创建声网项目 。在本示例中,你需要注册两个项目:
提交工单并在工单中填写项目二的 App ID,我们会帮你的项目开通相关权限。
一个有效的 Apple 开发者账号。
一台 iPhone。模拟机可能出现功能缺失或者性能问题,所以推荐使用真机。此外,互动游戏 iOS 端要求运行在 iOS 13 或以上版本。
在你的设备上运行互动游戏依赖于 Xcode 和 CocoaPods。
你可参考以下步骤准备开发环境:
互动游戏 iOS 端的源码位于 GitHub Meta-iGame 仓库,你可参考以下步骤获取源码:
运行以下命令克隆仓库到本地:
git clone ssh://git@github.com:AgoraIO/Meta-iGame.git
运行以下命令切换分支至指定版本,将 {VERSION} 替换为最新的版本号:
git checkout release/{VERSION}
在项目根目录运行 pod install
安装依赖项。
使用 Xcode 打开 AgoraGameEngine.xcworkspace
文件。
打开 AgoraGameEngine/Common/KeyCenter.swift
文件,按如下规则替换字段:
struct KeyCenter {
// 用项目一的 App ID 替换下面的 <## rtc_app_id ##> 字段
static let rtc_app_id: String = <#rtc_app_id#>
// 用项目二的 App ID 和 Token 替换下面的 <## rtc_app_id ##>和 <## rtc_token ##> 字段
static let game_app_id = <#rtc_app_id#>
static let game_app_certificate = <#rtc_token#>
}
在 Signing&Capabilities 界面的 Signing 部分,填入你的 Team 和 Bundle Identifier 信息。
编译并在设备上运行项目。你会看到以下界面。