《Creator 接入 AnySDK 指南》

概述

AnySDK 是一套帮助研发商快速接入第三方SDK的解决方案,如果您还不太了解 AnySDK,建议您先快速阅读一下 AnySDK 文档 -> 《快速入门》。

从 Creator 1.2 版本起,构建项目的时候可以选择自动集成 AnySDK 框架,本篇将具体介绍在 Creator 中如何接入 AnySDK。

AnySDK 服务开通

我们知道,使用 AnySDK 来快速接入第三方 SDK 需要经过以下几个步骤(请参考 AnySDK 官方文档 -> 快速入门 ->《接入步骤概述》):

  1. AnySDK 服务开通
  2. 集成 AnySDK Framework
  3. 服务端接入
  4. 使用打包工具生成渠道包

Creator 实际上是将第 2 步集成 AnySDK Framework 进行了自动化,省去了开发者手工集成的烦恼。其他步骤依然是相同的,所以在开始之前请先完成第 1 步的AnySDK 服务开通,以便获取到接下来集成 AnySDK Framework 时所需的 AppKey、AppSecret、PrivateKey 等参数。

集成 AnySDK Framework

构建项目

点击菜单 项目 -> 构建发布,在该界面勾选“集成 AnySDK Framework”,Creator 即会为您自动集成好 AnySDK Framework,省去了您手工在项目中集成 AnySDK Framework 的工作。 构建发布

其中 OAUTH_LOGIN_SERVER 即默认登录验证地址(参考 http://docs.anysdk.com/rapid-experience/packing-tool/#_4), AppKey、 AppSecret、 PrivateKey 三个参数是 AnySDK Framework 初始化时需要使用到的,可在 AnySDK 打包工具 -> 配置管理 -> 游戏管理 界面中获到到。

调用初始化接口

Android 和 iOS 是在 SDKManager.cpp 的 loadAllPlugins 函数里进行初始化的,不需要在 JS 再初始化了,需要修改初始化的参数,代码如下:

std::string oauthLoginServer = "OAUTH_LOGIN_SERVER";
std::string appKey = "APP_KEY";
std::string appSecret = "APP_SERCRET";
std::string privateKey = "PRIVATE_KEY";

AgentManager* pAgent = AgentManager::getInstance();
pAgent->init(appKey,appSecret,privateKey,oauthLoginServer);

//Initialize plug-ins, including SDKs.
pAgent->loadAllPlugins();

appKeyappSecretprivateKey 填写 AnySDK 客户端创建游戏后生成的参数,oauthLoginServer 填写游戏服务端用于登陆验证的地址(如不接入用户则随便填写)。

PS:init初始化传的参数如果和打包的游戏的参数不一致,会导致渠道包运行的时候就强制退出。

调用各系统接口

根据游戏需求,参考以下文档来调用各个系统的接口。
用户系统
支付系统
统计系统
分享系统
广告系统
推送系统
崩溃分析系统
广告追踪系统

服务端接入

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

打包

请参考阅读《使用打包工具生成渠道包》 。

备注

目前 H5 只支持渠道 SDK 接入,并且必须使用 AnySDK 企业版或 H5 版。