接入 AnySDK 服务
AnySDK 为 CP 提供了一套第三方 SDK 接入解决方案,整个接入过程,不改变任何 SDK 的功能、特性、参数等,对于最终玩家而言是完全透明无感知的。目的是让 CP 商能有更多时间专注于游戏本身的品质。第三方 SDK 包括了渠道 SDK、用户系统、支付系统、广告系统、统计系统、分享系统等等。目前支持 Android/iOS/Web 平台,注意:Web 平台只支持渠道 SDK 接入,并且必须使用 AnySDK 企业版。详情可参考 AnySDK 企业版。
本文档基于 v2.0.7 编写,若用户使用的版本在 v2.0.7 之前,请参考 旧版本文档。
创建游戏
因为 AnySDK 服务仅支持公司账户下的游戏,所以需要先进入 Cocos 账户中心,点击侧边栏的 公司 标签。然后根据需要 加入已有公司/创建新的公司,详情请参考 AnySDK 文档。可通过以下两种方式创建游戏:
通过 Cocos 账户中心创建游戏
由 Creator 的 服务 面板进入 Cocos 账户中心 创建公司游戏。详情请参考 服务面板 -> 使用方式。
通过 AnySDK 客户端创建游戏
从 AnySDK 官网 下载独立的 AnySDK 客户端来创建游戏和打包。登录 AnySDK 客户端,根据提示创建新游戏,可得到三个参数,后面会用到。详情请参考 创建游戏。
游戏创建完成后,需要 开通 AnySDK 服务。在 Cocos 账户中心 的游戏列表中点击游戏或者点击页面上方的 服务 标签,跳转到服务面板。在 服务 页面左侧选择对应的游戏,然后找到 AnySDK 服务,点击 开通服务,可以看到页面中的 AnySDK 服务显示 已开通。
服务端接入
如果游戏要接入用户和支付的话,需要游戏服务端处理登陆验证和支付验证相关逻辑。参考以下两篇文档进行接入:
客户端接入
构建项目
1、打开 Creator,点击菜单栏的 面板 -> 服务 项,打开 服务 面板。设置 Cocos AppID,注意要选择公司游戏。详情可参考 Cocos 服务面板设置。然后选择 AnySDK 项,进入 AnySDK 服务设置面板。
2、点击右上角的启用按钮以启用 AnySDK 服务。(如果在创建游戏步骤中没有开通 AnySDK 服务,那么在启用 AnySDK 服务的时候会弹出是否开通服务的提示框,根据提示进行操作即可。)
3、启用完成之后,服务面板就会显示 正在安装,安装完成后可以看到面板中新增了 参数配置 项,填入参数。
可通过以下三种方式获取参数:
- 点击 AnySDK 服务面板中的 前往控制台,进入 AnySDK 开发者管理后台 以获取参数,如上图所示。
- 在 Cocos 账户中心开通 AnySDK 服务后,直接点击 前往控制台,进入 AnySDK 开发者管理后台 以获取参数。
- 在 AnySDK 客户端的 配置管理 -> 游戏管理 中获取参数
其中 OauthLoginURL
参数是填写游戏服务端用于登录验证的地址(如不接入用户可任意填写)。
4、参数设置完成之后点击 保存。然后打开 构建发布 面板根据用户需要选择平台进行构建编译。构建出来的发布包已经自动集成了 AnySDK 服务。
调用各系统接口
根据游戏需求,参考以下文档来调用各个系统的接口。
打包
使用 AnySDK 客户端打开游戏,为游戏添加渠道以及接入所需的 SDK,配置 SDK 的参数(需要自己到 SDK 的后台申请参数),选择游戏母包即可进行打包。具体内容请参考 AnySDK 客户端使用手册。
- Android 平台 编译 生成的 APK 包将作为 AnySDK 客户端打包用的母包。
- iOS 平台 构建 生成的 Xcode 工程直接作为 AnySDK 客户端打包用的母工程。
- Web 平台无需打包,只需在 AnySDK 客户端添加渠道配置即可。