对接完成之后可以使用工具进行校验：点击下载
本工具用于协助对接完Wing SDK后，检查相关的配置、包引入等是否正确，具体使用方法见操作手册

一、集成SDK到项目

集成要求：Android API 15及以上版本，jdk1.7及以上版本。

1.1 Android Studio项目集成方法

1.1.1 自动集成

在项目目录下的build.gradle文件添加以下配置：

注意：以上的url为WINGSDK仓库地址：http://repo.wingsdk.cn:8081/repository/winga-group/，地址可能有变，请留意最新的对接文档。

在项目程序module下面的build.gradle文件的dependences内增加依赖配置；

// 基础模块（必选）
wa-sdk-base
// 核心模块（必选）
wa-sdk-core
// AppsFlyer模块（可选）
wa-sdk-appsflyer
// Chartboost模块（可选）
wa-sdk-chartboost
// Facebook模块（可选）
wa-sdk-facebook
// Google模块（可选）
wa-sdk-google
// VK模块（可选）
wa-sdk-vk
// 网页支付模块（可选）
wa-sdk-webpay

说明：以上的“必选”项目必须引入，“可选”项目可根据需求引入

请使用WINGSDK打包配置页面生成具体的配置脚本，地址：https://admin.wingsdk.com/developers/pack_config

1.1.2 手动集成

1.1.2.1 到WINGSDK打包配置页面下载相应的SDK包

WINGSDK打包配置页面地址https://admin.wingsdk.com/developers/pack_config

1.1.2.2 导入SDK包到项目中

打开项目，在菜单“File->New->New Model…”

打开新建Model页面，选择“Import .JAR/.AAR Package”项，下一步

选择下载好的SDK .AAR包，导入

此时项目的目录将会多了一个上面新建的Module，然后将Module关联到程序Module中，关联方法有两种：
第一种：直接在程序Module中的build.gradle的dependence下添加代码（单引号内部为要关联的Module名称，以冒号“:”开头）

第二种：选中程序Module，鼠标右键->Open Module Settings（或F12），打开程序Module设置面板

在打开的Module设置窗口中选中程序Module，定位到“Dependence”选项卡，点击“+”符号添加依赖，选择“Module Dependence”，

弹出Module选择窗口，在这个窗口中会展示出所有的未关联的Module

选中要关联的Module，OK->OK完成配置

1.1.2.3 手动集成AAR注意事项

1）wa-sdk-base AAR包（必选）
2）wa-sdk- core AAR包（必选）
需要依赖com.android.support:support-v4包，23及以上版本

3）wa-sdk- appsflyer AAR包（可选）
4）wa-sdk- chartboost AAR包（可选）
5）wa-sdk- facebook AAR包（可选）
需要依赖Facebook SDK，4.10.0版本

6）wa-sdk- google AAR包（可选）
需要依赖Google Service相关包，版本为9.6.1

7）wa-sdk- vk AAR包（可选）
需要依赖VK SDK包

8）wa-sdk- webpay AAR包（可选）
说明：以上的“必选”项目必须引入，“可选”项目可根据需求引入

1.2 Eclipse项目集成方法

1、打开Eclipse，安装gradle插件（如：BuildShip），安装成功后重启eclipse
2、导入gradle项目
3、修改程序项目中的build.gradle文件dependencies配置，添加SDK依赖，详细请参考1.1.1 自动集成
5、编译，调用接口开发。

1.3 命令行集成方法

1.3.1 配置编译环境

下载安装gradle工具，并配置执行环境。

1.3.2 集成环境构建

1.3.2.1新建构建项目目录

如果有项目目录，新建一个目录作为项目目录。

1.3.2.2将代码拷贝到目录中

将源码拷贝到新建的项目目录中，最基本包括以下目录和文件

如下图：

说明：其实以上目录不是硬性规定的，可以自定义，只需要在后续步骤中正确设置即可

1.3.2.3 在项目目录下添加gradle编译配置

1、添加local.properties文件，文件内容如下

sdk.dir=YOUR_SDK_HOME_DIR
将以上的值替换成你的Android SDK的目录

2、添加build.gradle文件，文件内容包括以下内容

1）插件声明

2）仓库地址声明

WING_SDK_REPOSITORY_URL为WingSdk的远程仓库地址

3、Android配置声明

说明：除了以上必要配置外，Android的相关配置还可以添加签名、代码混淆等配置
注意：上面的sourceSet中的内容必须跟你在项目目录下的文件类型对应起来。

4、依赖配置声明

1.3.3 编译环境初始化

打开命令行，进入项目目录，执行以下命令：
Windows:

MAC/Linux:

这里的gradle.bat是下载的gradle编译工具（如果没有配置环境变量，请使用绝对路径），初始化成功后，将会得到SUCCESS字样，如下图：

此时项目目录下会多了一些目录和文件
接下来执行clean task，清理项目
Windows:

MAC/Linux:

最后一步是执行build task，进行编译
Windows:

MAC/Linux:

编译成功后将看到BUILD SUCCESSFUL字样，如下图：

build task执行成功后，将会在项目目录下的\build\outputs\apk看到apk（如果在build.gradle中配置好签名及混淆配置，可实现一步到位的打包）

说明：最后一步的编译有多种task可以实现，比如assembleDebug，assembleRelease等等，详细请参考gradle官方说明。

1.4 WINGSDK配置

1.4.1 WINGSDK基本配置

1.4.1.1 AndroidManifest.xml配置：

在AndroidManifest.xml中application标签下添加以下设置。在不同的应用配置的参数值不相同，需要申请相应资源。

注：WINGSDK中使用到的权限
1）SDK内部自动添加的权限（普通权限）

2）CP选配权限（危险权限）

1.4.1.2 Activity结果传递配置

在所有使用到SDK接口的Activity的onActivityResult方法中增加以下代码：

1.4.2 Google相关配置

如果不需要Google渠道，请忽略此章节

1.4.2.1 Google基本配置

在values/strings.xml中添加公钥字符串资源：

获取Google public key

第一步：打开Google Play的Developer Console并进行登录。确认你登录的账号是已经或者将要发布应用的账号
第二步：在Application Details页面，点击 Services and APIs 链接
第三步：在Services and APIs 页面的Licensing and In-App Billing部分，就可以找到你的public key

Google后台配置参考（定义包名及获取SHA-1指纹）：Google后台应用配置

1.4.2.2 Google Game Service配置

如果不需要使用Google Game Service，可以忽略此章节
使用Google Game Service服务，还需要在AndroidManifest.xml中application标签下添加以下配置：

说明：字符资源的值是Google Game Service的APP ID,需要Google开发者控制台创建游戏服务获得。

1.4.3 Facebook相关配置

如果不需要Facebook渠道，请忽略此章节
在strings.xml中添加Facebook APPId声明：

在AndroidManifest.xml中添加配置

注意：
1、string的name必须为facebook_app_id，不可更改
2、将FacebookContentProvider后面的${YOUR_FACEBOOK_APP_ID}替换成你的Facebook app id。

Facebook 后台配置参考Facebook第三方后台配置

1.4.4 AppsFlyer相关配置

如果不需要AppsFlyer渠道，请忽略此章节
在AndroidManifest.xml中application标签下添加以下声明

1.4.5 Chartboost相关配置

如果不需要Chartboost渠道，请忽略此章节
在AndroidManifest.xml中application标签下添加声明

特别提醒：以上所有配置的android:name字段值都必须和文档一致，android：vlaue值由各应用申请的资源而定。

1.4.6 VK相关配置

在values/strings.xml中添加加以下字符串资源：
如果不需要使用VK渠道功能，可以忽略此章节

说明：APP_ID需要在VK的开发者管理后台创建应用后获得。

1.5 代码混淆配置

打包apk混淆代码配置中增加以下配置

二、WINGSDK使用

2.1 SDK初始化

调用下面接口对SDK进行初始化：

注意：使用SDK之前必须调用这个接口进行初始化，且必须在第一个Activity的onCreate()方法中调用

2.2 开启/关闭调试模式

WINGSDK默认是关闭调试模式的，开启调试模式可以在IDE的Logcat中查看到程序的Log信息，方便调试和测试。开启/关闭调试模式调用以下接口。

调用此接口后即可显示Log悬浮窗按钮，不用再另外调用enableLogcat接口，同时如果需要，也可以调用disableLogcat接口隐藏Log按钮。

2.3、公共参数配置

公共参数必须严格按照文档进行配置，在后续的接口中会使用到这些公共的参数，没有按照要求配置会导致部分接口调用失败。

2.3.1 设置用户id

用户在登录之后将用户id设置到SDK中，如果使用了用户模块进行登录，这个接口不需要手动调用。

用户在选择服务器并且登录之后将用户gameUserId设置到SDK中以便于跟踪。

2.3.2 设置服务器ID

用户登录选服后，调用接口设置服务器id

注意：设置服务器ID的操作在每次选服后都需要进行。

2.3.3 设置用户等级level

设置游戏玩家的角色等级，调用接口：

注意：第一次进服获取玩家等级或玩家等级变更后，需要及时调用这个接口设置玩家等级。

2.3.4 设置ClientId

设置自定义的ClientId，调用接口：

注意：
1、clientId不是必设参数
2、一旦调用这个接口进行修改ClientId，以后SDK的ClientId将会保持这个不变。
clientId的作用：clientId用于跟踪设备，通过一套算法计算，可以看成是一个设备的唯一标识。CP可能会有自己的唯一标识，通过设置clientId，来达到WINGSDK后台和游戏后台唯一标识的统一。如不设置，SDK内部会自动通过算法算出。

三、公共模块功能

3.1调试Logcat工具使用

WINGSDK提供了调试信息显示的Logcat工具，使用这个工具测试人员不需要IDE环境就可以查看调试信息，工具可以看到应用的调试Log信息（不包含系统打印）。使用前必须确保手机的安全软件没有拦截该程序的悬浮窗口权限，使用调用以下接口：

3.1.1 显示Logcat工具入口悬浮按钮

3.1.2 隐藏Logcat工具入口悬浮按钮

3.1.3 向Logcat工具中增加一条日志

通过以下接口，可以向Logcat工具中增加一条日志，日志会在Log标签中显示

3.1.4 向Lgocat工具中增加一条事件日志

通过以下接口，可以向Logcat工具中增加一条事件日志，日志会在Event标签中显示

3.2 Android6.0 权限管理

Android6.0的权限管理进行更新，敏感权限需要运行时授权，当buildVersion 在23及以上版本时，在AndroidManifest.xml中配置的敏感权限声明，当App运行在android6.0及以上的系统时，配置的授权是无效的.
SDK提供了权限的检查与授权接口，在程序运行时，调用以下接口进行权限自检：

在调用上面权限自检接口的Activity中的onRequestPermissionsResult()方法中调用已下接口，完成权限自检和授权的传递。

四、用户模块功能

4.1 登录功能使用

4.1.1设置登陆流程接口：

设置登录流接口可以设置在登录账号的时候，是否将登录的账号与该设备重新绑定，如果将该账号与设备进行了绑定，那么在当前设备可以通过匿名登录登录该账号。

登录流程有两种模式，在WAConstants类中定义，取值如下表：

说明：
1、一般来说，如果应用登录的时候有登录方式选择界面，就不需要使用此接口，此接口默认是这种方式（取值为1）。
2、这个接口是用来满足以下需求：用户第一次登录是以游客方式进行登录，进到应用里面可以切换其它方式，这个时候应该使用该接口（取值为2）

4.1.2 用户登录接口

用户登录调用以下接口：

参数说明:

登录平台取值：

4.1.3 登录对话框

SDK内置了一个包含所有支持的登录方式的一个对话框，通过调用以下接口打开对话框：

参数说明：

4.1.4 登录结果返回

登录结果通过回调返回，数据封装在WALoginResult类中。

WALoginResult字段说明

4.1.5 用户登出

退出游戏的时候，必须登出操作。用户登出调用以下接口：

4.1.6 清除登录对话框登录方式缓存

使用内置的登录窗口进行登录，如果启用了缓存，SDK会缓存当前登录方式，下一次在启用缓存的前提下调用接口，会自动使用上一次登录方式登录，不再弹出登录窗口。这个接口可以清除掉缓存，重新弹出登录窗口，清除登录缓存，调用以下接口：

4.2 账户管理的使用

4.2.1 绑定第三方平台账户

绑定第三方平台账户后，可以使用第三方平台账户登录，防止账户信息丢失，绑定第三方平台账户，调用以下接口：

参数说明:

4.2.2 查询已经绑定的第三方平台账户

通过以下接口，可以查询当前的账户已经绑定的第三方平台账户:

WAAccountResult字段说明:

4.2.3 解绑第三方平台在账户

通过以下接口，可以解绑已经绑定的第三方平台账户：

有以下情况之一者，不可解绑：
1．解绑的账户为WINGSDK平台的；
2．用户没有绑定的第三方平台账户的；
3．用户只绑定一个第三方平台账户，且用户没有与当前设备绑定的。

4.2.4 切换账户

使用以下接口可以快速切换登录的账户

参数说明：

4.2.5 新建账户

新建账户后，新的账户会跟当前设备绑定，如果之前的账户没有绑定第三方平台账户，数据将会丢失。

4.2.6 使用账户管理页面

SDK内置了账户管理页面，打开这个内置的页面之前必须先登录，通过这个页面可以对账户进行管理操作，包括账号绑定、解绑、切换账户、新建账户。
参数说明:

4.2.7 获取账户信息

SDK提供了获取指定平台的账户信息，可以通过以下接口获取:

参数说明：

附表4.1：Facebook登录权限对照表

附表4.2：登录extInfo字段说明

1、appUserId和appToken是游戏提供给SDK，SDK后台根据这两个值去游戏后台校验；
2、appToken：根据游戏验证用户登录状态的方式，把参数传到SDK后台，如果有多个参数，组成JSON放入appToken，SDK会根据这些参数到游戏后台校验，提供的验证登录的接口就是用于验证

五、支付模块功能

5.1 支付服务是否可用

通过以下接口可以获取支付服务是否可用，返回boolean类型结果，true为可用，false为不可用：

参数说明：

5.2 初始化

5.2.1 初始化接口

支付平台进行初始化，sdk内部会对所有已经选择的支付平台做初始化，初始化调用以下接口：

参数说明：

支付的初始化建议在调用Activity的onCreate中初始化。

5.2.2资源释放

释放资源，在不再使用支付时，可以清理所有支付渠道所占用的资源，在调用接口Activity的onDestroy方法内调用以下接口

示例：

5.3 查询库存商品

查寻库存商品，调用以下接口，返回WINGSDK平台的商品id（注意：这里返回的是WINGSDK平台的商品id，并非第三方平台的商品id，WINGSDK平台的商品id可以从WASkuResult中的WAsdkDetail中的sku获得：

参数说明：

WASkuDetails实体类说明：

5.4 购买支付

购买指定商品，会直接弹出google购买窗口（如果该商品有且只有google支付渠道），或者弹出支付渠道选择窗口（如果有除google之外的渠道），选择支付方式后进行支付。调用以下接口：

参数说明：

注意：如果需要横竖屏适配，请在AndroidMainifest.xml中，弹出购买窗口的activity中添加如下语句：

六、社交模块功能

6.1 分享功能

分享调用以下接口，支持分享链接、图片、视频、Facebook OpenGraph：

参数说明：

6.1.1 分享链接内容实体WAShareLinkContent

WAShareLinkContent字段说明

6.1.2 分享图片内容实体WASharePhotoContent

WASharePhotoContent字段说明

WASharePhoto字段说明

6.1.3 分享视频内容实体WAShareVideoContent

WAShareVideoContent字段说明

WAShareVideo字段说明

6.1.4 分享OpenGraph对象(Facebook)

WAShareOpenGraphContent字段说明

6.2 应用邀请功能

参数说明：

6.3 游戏邀请功能

6.3.1 查询可邀请好友列表

游戏邀请只能邀请没有玩过当前游戏的好友，称为可邀请好友，查询可邀请的好友调用以下接口：

参数说明：

6.3.2 游戏邀请

WingSDK 3.5.1版本开始，使用8.7 发送请求接口代替
发送游戏邀请请求调用以下接口：

参数说明：

6.3.3 邀请成功记录

成功邀请好友后，调用以下接口向服务器记录邀请信息：

参数说明：

6.3.4 邀请安装奖励

通过邀请安装使用的用户，安装后需要通知服务器对邀请人进行奖励，需要在游戏启动后登录并且选服后调用以下接口：

注意：这个接口必须在用户登录并且选服后调用。采用platform指定平台方式登录或者绑定platform指定的平台后，均可以调用该接口。
参数说明：

6.3.5 邀请事件奖励

通过邀请安装使用的用户，在触发定义的特定事件，需要通知服务器奖励邀请人，比如等级达成、充值等，调用以下接口：

参数说明：

6.3.6 查询好友

查询指定平台正在玩游戏的好友列表，调用以下接口：

参数说明：

6.3.7 查询Facebook Graph Object

Facebook的礼物就是在Facebook控制台创建的Graph Object，查询礼物列表的时候调用这个接口，这个接口只针对Facebook平台

Facebook后台新建礼物（Open Graph Object）参考：Facebook后台新建礼物
参数说明:

6.3.8 Facebook赠送礼物

WingSDK 3.5.1版本开始，使用8.7 发送请求接口代替
Facebook用户向正在玩游戏这个游戏的好友赠送礼物，调用以下接口：

参数说明

6.3.9 Facebook索要礼物

WingSDK 3.5.1版本开始，使用8.7 发送请求接口代替
Facebook用户向正在玩这个游戏的好友发出索要礼物的请求，调用以下接口：

参数说明：

6.3.10 Facebook查询收到的礼物

Facebook用户查询好友赠送给自己的礼物，调用以下接口：

参数说明：

6.3.11 Facebook查询向自己索要礼物的请求

Facebook用户查询好友向自己索要礼物的请求，调用以下接口：

参数说明：

6.3.12 Facebook删除请求

Facebook中用户收到的礼物，好友向自己索要礼物的请求都是一个Facebook的请求，收取礼物和拒绝赠送礼物的时候，需要删除掉对应的请求。删除请求调用以下接口：

参数说明：

七、Game Service功能

7.1 登录Game Service

登录Game Service调用接口：

参数说明：

7.2 登出Game Service

登出Game Service调用以下接口:

参数说明：

7.3 成就解锁

标准类型的成就是一次性解锁，解锁调用以下接口：

参数说明：

7.4 分步成就进度增加

分步类型成就是可以分步进行解锁的，进度增加会在原来的进度上完成递增，无需知道当前的进度，进度递增调用以下接口：

参数说明：

7.5 分步成就进度设置

分步类型成就除了可以使用7.4 分步成就进度增加实现进度递增外，也可以使用以下接口直接设置进度：

参数说明：

7.6 显示隐藏成就

隐藏状态下的成就不能解锁，需要显示后才能解锁操作，显示隐藏的成就调用以下接口：

参数说明：

7.7 展示成就列表

展示成就列表是打开自带的页面，调用以下接口：

参数说明：

有回调的展示成就接口，可以获取在成就页面进行的操作结果（如登出账户），有回调的接口调用如下。

参数说明：

7.8 加载成就列表

通过以下接口，可以加载所有成就的列表：

参数说明：

WAAchievement字段说明：

7.9 判断是否已经登录Game Service

判断当前是否已经登录了Game Service，调用以下接口，接口返回boolean类型结果，true为已登录，false为未登录

参数说明：

八、游戏社区功能

8.1 通过Group id查询Group详情

通过Group id查询Group详情，调用以下接口:

参数说明：

WAGroup字段说明：

8.2 查询当前应用关联的Group

一个应用只能关联一个Group，通过以下接口可以查询当前应用关联的Group详细信息：

参数说明：

8.3 查询当前用户已加入的Group

查询当前用户加入的Group详细信息调用以下接口：

参数说明：

8.4 查询当前用户是否为指定Group的成员

查询当前的用户是否为指定的某个Group的成员，调用以下接口：

参数说明：

8.5 加入Group

加入指定的某个Group，调用以下接口：

参数说明：

8.6 进入Group详情页

进入Group的详情页面，调用以下接口：

如果客户端已经安装platform指定平台的app客户端，将会进入到app客户端详情页面，如果没有安装，则打开网页详情页。

参数说明：

8.7 发送请求接口

该接口从SDK 3.5.1版本开始启用
发送请求接口向平台好友发送请求，请求包括普通请求、游戏邀请、赠送礼物、索要礼物等，发送请求调用以下接口：

参数说明：

WARequestSendResult字段说明：

表8.7.1 请求类型

注：vk平台测试游戏邀请功能需要申请权限，可以把请求类型设置成REQUEST_REQUEST来测试普通邀请，待申请权限通过后改成REQUEST_INVITE来测试。关于vk邀请功能的业务流程图如下：

九、数据收集模块功能

9.1 在线时长

SDK统计在线时长，在每个Activity的onResume()方法中调用以下接口：

在每个Activity的onPause()方法内部调用以下接口：

示例：

9.2事件数据的发送

第一步 构建GhwEvent对象

使用WAEvent.Builder构建一个WAEvent类对象，并设置数据收集的相关参数：

第二步 发送数据

调用第一步创建GhwEvent对象的trackEvent(Context)方法发送数据

或者调用以下接口发送:

9.3 WAEvent.Builder的接口方法介绍

9.3.1 设置默认的事件名称

设置该事件的事件名称，WINGSDK内置了应用内事件，请参考附表9.1：SDK预定义事件名

9.3.2 设置渠道自定义事件名称

如果某个渠道需要跟默认的事件名称有不一致的需求，可以在这里自定义该渠道特定的事件名称

注意：
1、AppsFlyer预定义的事件名称和WINGSDK预定义的事件名称已经做了映射（例如: ghw_login <-> af_login），用户无需再手动自定义。
2、如果不进行设置，所有的渠道将采用设置的默认值。

9.3.3 设置默认累加值

设置事件用于累加数字，比如购买的金额等

9.3.4 设置渠道自定义累加值

如果渠道有特定的值累加，可以通过这个接口设置：

注意：
1、如果不进行设置，所有的渠道将采用设置的默认值。

9.3.5 设置事件默认的参数/值

调用这个接口设置事件所需要的参数，设置的方法有两种：
第一种，将参数放入Map，设置Map为参数

第二种：逐一增加参数名-值对

9.3.6 设置事件渠道自定义的参数/值

如果某个渠道需要自定义参数，可以通过这个接口设置，设置的方法有两种
第一种，将参数放入Map，设置Map为参数

第二种：逐一增加参数名-值对

注意：
1）AppsFlyer预定义的参数名称和WINGSDK预定义的参数名称已经做了映射，用户无需再手动自定义。
2）如果不进行设置，所有的渠道将采用设置的默认值。

9.3.7 禁用渠道

如果想该事件不发送到某个渠道，可以调用以下接口禁用某个渠道

注意：
1、默认情况下是所有渠道都发送

以下是一个代码例子，仅供参考：

9.4 SDK预定义事件

建议参数属性：（参数对应的静态变量名请看附表9.2：SDK预定义参数名）

9.4.1 ghw_login登录游戏

说明:登录游戏后调用。 SDK登录已集成该事件
无参数。

9.4.2 ghw_initiated_payment点击充值

说明:点击充值时后调用。 SDK内支付已经集成该事件
无参数.

注意：Google应用内购买已经集成该事件

9.4.3 ghw_payment充值完成（真实货币）

说明:充值完成后调用（成功的情况下）。SDK内支付已经集成该事件

提示：如果累加参数value传值，请传入和currencyAmount字段值相等。

9.4.4 ghw_initiated_purchase点击购买

说明:点击购买的时候调用（用于游戏内部虚拟交易统计）。
无参数.

9.4.5 ghw_purchase购买完成（虚拟货币）

说明:点击购买的时候调用（用于游戏内部虚拟交易统计）。

9.4.6 ghw_level_achieved 等级增长事件

说明:统计玩家等级增长事件，达到等级时调用。

9.4.7 ghw_user_create 创建角色

说明:创建游戏角色，游戏角色创建时调用

9.4.8 ghw_user_info_update更新用户信息

说明:更新用户资料

9.4.9 ghw_gold_update货币状况更新

说明:玩家货币状况变更统计

9.4.10 ghw_task_update玩家任务统计

说明:玩家任务信息统计

9.4.11 ghw_user_import导入用户事件

说明:导入用户事件，玩家第一次进某个服时调用–通过用户id在后台查找

9.4.12 自定义事件名称 自定义事件

说明:支持自定义事件的统计

附表9.1：SDK预定义事件名

在WAEventType接口中定义

附表9.2：SDK预定义参数名

在WAEventParameterName接口中定义