• 接入 AnySDK 服务
    • 创建游戏
    • 服务端接入
    • 客户端接入
      • 构建项目
      • 调用各系统接口
    • 打包
    • 相关参考链接

    接入 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  - 图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

    相关参考链接

    • Cocos 账户中心
    • AnySDK 官方文档
    • AnySDK 开发者管理后台
    • AnySDK 客户端使用手册
    • AnySDK 服务开通
    • AnySDK 统一登录验证
    • AnySDK 订单支付通知