接入 AnySDK 服务

AnySDK 为 CP 提供了一套第三方 SDK 接入解决方案,整个接入过程,不改变任何 SDK 的功能、特性、参数等,对于最终玩家而言是完全透明无感知的。目的是让 CP 商能有更多时间专注于游戏本身的品质。第三方 SDK 包括了渠道 SDK、用户系统、支付系统、广告系统、统计系统、分享系统等等。目前支持 Android/iOS/Web 平台,注意:Web 平台只支持渠道 SDK 接入,并且必须使用 AnySDK 企业版。详情可参考 AnySDK 企业版

本文档基于 v2.0.7 编写,若用户使用的版本在 v2.0.7 之前,请参考 旧版本文档

创建游戏

因为 AnySDK 服务仅支持公司账户下的游戏,所以需要先进入 Cocos 账户中心,点击侧边栏的 公司 标签。然后根据需要 加入已有公司创建新的公司,详情请参考 AnySDK 文档。可通过以下两种方式创建游戏:

 AnySDK  - 图1

  • 通过 AnySDK 客户端创建游戏

    AnySDK 官网 下载独立的 AnySDK 客户端来创建游戏和打包。登录 AnySDK 客户端,根据提示创建新游戏,可得到三个参数,后面会用到。详情请参考 创建游戏

 AnySDK  - 图2

游戏创建完成后,需要 开通 AnySDK 服务。在 Cocos 账户中心 的游戏列表中点击游戏或者点击页面上方的 服务 标签,跳转到服务面板。在 服务 页面左侧选择对应的游戏,然后找到 AnySDK 服务,点击 开通服务,可以看到页面中的 AnySDK 服务显示 已开通

 AnySDK  - 图3

服务端接入

如果游戏要接入用户和支付的话,需要游戏服务端处理登陆验证和支付验证相关逻辑。参考以下两篇文档进行接入:

客户端接入

构建项目

1、打开 Creator,点击菜单栏的 面板 -> 服务 项,打开 服务 面板。设置 Cocos AppID,注意要选择公司游戏。详情可参考 Cocos 服务面板设置。然后选择 AnySDK 项,进入 AnySDK 服务设置面板。

2、点击右上角的启用按钮以启用 AnySDK 服务。(如果在创建游戏步骤中没有开通 AnySDK 服务,那么在启用 AnySDK 服务的时候会弹出是否开通服务的提示框,根据提示进行操作即可。)

 AnySDK  - 图4

3、启用完成之后,服务面板就会显示 正在安装,安装完成后可以看到面板中新增了 参数配置 项,填入参数。

 AnySDK  - 图5

可通过以下三种方式获取参数:

  • 点击 AnySDK 服务面板中的 前往控制台,进入 AnySDK 开发者管理后台 以获取参数,如上图所示。
  • 在 Cocos 账户中心开通 AnySDK 服务后,直接点击 前往控制台,进入 AnySDK 开发者管理后台 以获取参数。
  • 在 AnySDK 客户端的 配置管理 -> 游戏管理 中获取参数
    其中 OauthLoginURL 参数是填写游戏服务端用于登录验证的地址(如不接入用户可任意填写)。

4、参数设置完成之后点击 保存。然后打开 构建发布 面板根据用户需要选择平台进行构建编译。构建出来的发布包已经自动集成了 AnySDK 服务。

调用各系统接口

根据游戏需求,参考以下文档来调用各个系统的接口。

打包

使用 AnySDK 客户端打开游戏,为游戏添加渠道以及接入所需的 SDK,配置 SDK 的参数(需要自己到 SDK 的后台申请参数),选择游戏母包即可进行打包。具体内容请参考 AnySDK 客户端使用手册

  • Android 平台 编译 生成的 APK 包将作为 AnySDK 客户端打包用的母包。
  • iOS 平台 构建 生成的 Xcode 工程直接作为 AnySDK 客户端打包用的母工程。
  • Web 平台无需打包,只需在 AnySDK 客户端添加渠道配置即可。
     AnySDK  - 图6

相关参考链接