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

一、简介

1.1 用户模块

提供 UI界面 和 接口调用 两种方式，满足用户不同需求。

1.1.1 登录弹窗

内置登录UI弹窗，内含所有已经集成的登录方式，无需编写界面，一键集成登录功能

1.1.2 匿名登录

WINGSDK匿名登录无需账户密码，根据设备信息新建用户或登录已存在的用户，可以快速登录游戏。

1.1.3 第三方平台登录

第三方平台登录接口可以通过第三方平台账户登录，返回WINGSDK账号信息，使用没有绑定任何WINGSDK账号的第三方平台账号登录，会自动新建一个WINGSDK账号，并且与该平台账号绑定。支持Facebook登录、Google登录、VK登录。

1.1.4 内置账户管理界面

内置账户管理UI界面，无需编写界面和逻辑，即可对账户进行管理，平台账户绑定情况一目了然，绑定、解绑平台账户，新建账号，切换账号，轻松搞定。

1.1.5 账号绑定与解绑

• 账号绑定接口，可以将WINGSDK账号跟第三方平台的账号绑定，绑定成功后可以使用绑定的平台账号登录，在同一应用中一个平台账号只能绑定一个WINGSDK账号。

• 账号解绑接口，可以将第三方平台账号与其绑定的WINGSDK账号解绑，解绑成功后，平台账号可以与WINGSDK账号再次绑定。

• 绑定账号查询接口，能够查询此时登录的账号（WINGSDK）已经绑定的第三方平台账号列表。

1.1.6 账号切换

一键切换账号，迅速切换WINGSDK账号或者第三方账号。

1.2 支付模块

支付模块提供支付充值接口，集成简单，无需理会复杂的支付流程，轻松完成商品的购买（充值）。

1.3 数据收集模块

数据收集模块提供了数据收集的接口，多渠道灵活调用。数据收集包含了丰富的应用内的事件类型，还支持用户自定义事件类型。

1.4 社交模块

社交模块，为游戏提供社交功能支持，一键集成，功能丰富。社交模块包含以下功能：
1、分享接口，支持分享链接、文字、图片、视频、Facebook OpenGraph；
2、应用邀请，一键邀请好友；
3、游戏邀请，邀请还没有玩过该游戏的好友跟自己一起玩这款游戏，邀请好友一起玩游戏，还有丰富的邀请奖励；
4、礼物接口，可以向正在和自己玩同一款游戏的好友赠送礼物或者索要礼物，加强玩家的互动；
5、Game Service，游戏互动更简单；
6、社区，提高玩家的积极性和互动。

二、快速集成

2.1 环境配置要求

• Android API 15及以上版本

• jdk1.7及以上版本。

2.2 集成SDK到项目

WINGSDK基于gradle提供了多种集成方式：Gradle自动集成、手动集成、Eclipse项目集成、命令行集成，可以根据需要选择其中任意一种方式。
第三方SDK依赖关系如下表

2.2.1 Gradle自动集成

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

注意：
1）部分项目中可能只有一个build.gradle文件；
2）以上的url为WingSdk仓库地址：http://repo.wingsdk.cn:8081/repository/winga-group/，地址可能有变，请留意最新的对接文档。

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

注意：
1）部分项目中可能只有一个build.gradle文件；
2）以上的“必选”项目必须引入，“可选”项目可根据需求引入。

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

2.2.2 手动集成

2.2.2.1 打包配置页面下载SDK包

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

2.2.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完成配置

2.2.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.18.0版本

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

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

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

2.2.3 Eclipse项目集成

2.2.3.1 安装Gradle插件

打开Eclipse，安装gradle插件（如：BuildShip），安装成功后重启eclipse

2.2.3.2 导入Gradle项目

将Gradle项目导入eclipse，如果不是Gradle项目，导入时转换成Gradle项目

2.2.3.3 集成配置

修改程序项目中的build.gradle文件，增加仓库地址配置和dependencies配置，添加SDK相关依赖，详细请参考2.2.1 Gradle自动集成

2.2.3.4 开始开发

集成完毕后，编译项目，使依赖生效，调用接口开发。

2.2.4 命令行集成

2.2.4.1 配置编译环境

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

2.2.4.2 新建构建项目的目录

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

2.2.4.3 拷贝源代码和资源文件到构建目录中

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

如下图：

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

2.2.4.4 配置local.properties文件

在local.properties文件增加以下配置（若没有该文件需要新建）
sdk.dir=YOUR_SDK_HOME_DIR
将以上的值替换成你的Android SDK的目录

2.2.4.5 配置build.gradle文件

配置build.gradle文件，包含以下内容：
1）插件声明

2）仓库地址声明

注意：以上的WING_SDK_REPOSITORY_URL为WINGSDK仓库地址：http://repo.wingsdk.cn:8081/repository/winga-group/，地址可能有变，请留意最新的对接文档。
3）Android编译配置声明

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

2.2.4.6 编译

打开命令行，进入项目目录，执行以下命令：
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官方说明。

2.3 SDK配置及初始化

2.3.1 SDK配置

2.3.1.1 AndroidManifest.xml配置：

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

注意：以上配置中android:name必须保持一致，android:value根据CP应用申请的资源而定。

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

2）CP选配权限（危险权限） 如果应用上Google推荐，需注意Google推荐位需知

2.3.1.2 Activity结果传递配置

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

2.3.2 SDK初始化

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

注意：SDK初始化必须在第一个Activity的onCreate()方法中调用，所有接口必须在SDK初始化完成并且成功后才能调用。

2.4 登录

2.4.1 使用登录窗口

2.4.1.1 调用登录窗口

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

参数说明：

2.4.1.2 清除登录窗口的缓存

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

2.4.2 使用接口登录

如果CP有自己的登录窗口，可以使用以下登录接口：

注意：如果使用Google登录，必须在AndroidManifest.xml重配置GET_ACCOUNTS权限，当buildVersion 在23及以上版本时，需要在调用登录接口的Activity中的onRequestPermissionsResult()方法中调用已下接口，完成权限自检和授权的传递。
WACommonProxy.onRequestPermissionsResult(@NonNull Activity activity, int requestCode, String[] permissions, int[] grantResults)

2.4.3 处理登录结果

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

WALoginResult字段说明

2.4.4 用户登出

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

注意：调用logout接口后，serverId、gameUseId、level字段值会被重置，如果需要保持相应字段的值不重置，需要重新设置相应字段的值，参考3.1 公共参数设置

2.5 支付

WINGSDK支付流程如下：

2.5.1 初始化支付

初始化支付，SDK会对所有已经支持的支付平台做初始化，初始化调用接口

参数说明：

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

2.5.2 查询库存商品列表

通过查询库存商品列表，可以获取所有可以购买的库存商品，查询库存调用接口

注意：这里返回的库存商品信息是WINGSDK平台的商品信息，并非第三方平台的商品信息。
参数说明：

WASkuDetails实体类说明：

2.5.3 购买商品

购买指定商品，调用以下接口发起支付：

调用支付接口支付将会出现两种情况：
1）直接弹出google购买窗口（如果该商品有且只有google支付渠道）；
2）弹出支付渠道选择窗口（如果有除google之外的渠道），选择支付方式后进行支付。

参数说明：

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

2.5.4 查询支付服务是否可用

通过以下接口可以获取支付服务是否可用，返回boolean类型结果，true为可用，false为不可用，只要有一个支付渠道可用即为true。

参数说明：

2.5.5 资源释放

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

示例：

2.6 数据收集

使用WINGSDK数据收集接口配合大数据平台，可以轻松统计玩家习惯以及充值等行为，为游戏的市场营销提供数据依据。WINGSDK数据收集使用在游戏的过程中打点的方式，如图所示：

以上流程图中涉及到的几个接口：setServerId、setGameUserId、setLevel、ghw_user_import事件、ghw_user_create事件是有时序要求的，其它的事件如ghw_initiated_purchase、ghw_purchase、ghw_level_achieved、ghw_user_info_update、ghw_gold_update和ghw_task_update事件则需要在事件发生的对应时机调用接口发送。

2.6.1 发送数据

2.6.1.1 构建WAEvent对象

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

2.6.1.2 发送数据

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

或者调用以下接口发送：

2.6.1.3 WAEvent.Builder方法介绍

• 设置默认的事件名称

参数：
eventName事件名称

• 设置渠道自定义事件名称，针对某个渠道需要设置特定的事件名称

参数：
eventChannel 渠道名称
eventName 事件名称

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

• 设置默认累加值

参数：
value 累加统计的数值

• 设置渠道自定义累加值，针对某个渠道需要设定特定的累加值

参数：
eventChannel 渠道名称
eventName 累加统计的数值

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

• 设置事件默认的参数/值，每次可添加多个

参数：
eventValues 参数/值Map

• 添加一个事件默认的参数/值，每次添加一个

参数：
paramName 参数名称
paramValue 参数值

• 设置事件渠道自定义的参数/值，每次可添加多个，针对某个渠道需要设定特定的参数或者值

参数：
eventChannel 渠道名称
eventValues参数/值Map

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

• 设置事件渠道自定义的参数/值,每次添加一个，针对某个渠道需要设定特定的参数或者值

参数：
eventChannel 渠道名称
eventName 参数名
eventValue参数值

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

• 禁用渠道，禁用后的渠道不会发送数据

参数：
eventChannel 渠道名称

注意：
1）默认情况下是所有启用的渠道都发送
2）启用/关闭某个渠道数据收集，请参考四、第三方配置相关章节

2.6.2 SDK预定义事件

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

2.6.2.1 ghw_user_import导入用户事件

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

注意：发送ghw_user_import事件前需调用3.1.1 设置服务器ID接口更新服务器id

2.6.2.2 ghw_initiated_purchase点击购买

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

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

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

2.6.2.4 ghw_level_achieved 等级增长事件

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

注意：发送ghw_level_achieved事件前需调用3.1.3 设置用户等级level接口更新用户等级信息。

2.6.2.5 ghw_user_create 创建角色

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

2.6.2.6 ghw_user_info_update更新用户信息

说明:更新用户资料

2.6.2.7 ghw_gold_update货币状况更新

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

2.6.2.8 ghw_task_update玩家任务统计

说明:玩家任务信息统计

2.6.3 自定义事件

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

2.7 代码混淆配置

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

三、高级功能

3.1 公共参数设置

WINGSDK包括serverId等公共参数，这些参数主要用于数据跟踪和统计。
公共参数必须严格按照文档进行设置，在后续的接口中会使用到这些公共的参数，没有按照要求配置会导致部分接口调用失败。

3.1.1 设置服务器ID

当用户的服务器ID发生改变时，需要调用设置服务器ID接口设置新的服务器ID，例如每次进入服务器

注意：设置服务器id的操作在每次选服后都需要进行，必须在调用其他接口前设置。

3.1.2 设置gameUserId

当gameUserId发生改变时，需要调用设置gameUserId接口设置新的gameUserId，例如成功登录账号后、切换账号成功后

注意：必须在调用其他接口前设置。

3.1.3 设置用户等级Level

当用户角色等级发生改变时，需要调用设置等级接口设置新的等级，例如开始进入游戏、等级提升等。

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

3.1.4 设置ClientId

ClientId主要用于数据追踪，SDK内部有自己的ClientId生成机制，如果CP需要自定义ClientId，可调用接口进行设置

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

3.2 调试模式

3.2.1 开启/关闭调试模式

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

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

3.2.2 Logcat工具

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

3.2.2.1 显示Logcat悬浮按钮

说明：如果已经开启了调试模式，不需要调用该接口就可以显示Logcat入口悬浮窗。

3.2.2.2 隐藏Logcat悬浮按钮

3.2.2.3 向Logcat增加一条日志

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

3.3 登录高级设置

3.3.1 设置登录流程

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

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

3.3.2 应用内登录

SDK平台应用内登录，是指CP本身有自己登录系统，先登录CP后台拿到用户信息后登录SDK后台，应用内登录调用接口2.4.2 使用接口登录，将CP后台返回的用户信息按照规定格式（JSON字符串）通过extInfo字段传入。

应用内登录extInfo格式（标准JSON格式字符串）

字段说明：

3.3.3 Facebook自定义权限登录

Facebook平台登录默认权限是public_profile和user_friends，如果需要自定义登录获取的权限，可以调用接口2.4.2 使用接口登录，将需要获取的权限声明按照规定格式（JSON字符串）通过extInfo字段传入。

Facebook自定义权限登录extInfo格式（标准JSON格式字符串）

字段说明：

3.4 账户管理

3.4.1 内置账户管理界面

SDK内置了账户管理界面，在这个界面可以对账户进行管理操作，包括账号绑定、解绑、切换账户、新建账户。

注意：使用内置账户管理界面之前必须先登录
参数说明：

3.4.2 绑定第三方平台账户

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

参数说明

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

查询当前的账户已经绑定的第三方平台账户列表，调用接口

WAAccountResult字段说明

WAAccount字段说明

3.4.4 解绑第三方平台账户

解绑已经绑定的第三方平台账户，调用接口

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

3.4.5 切换账户

切换账户可以一键切换登录账户，调用接口

参数说明：

3.4.6 新建账户

新建账户可以新建一个全新的玩家账户。

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

3.4.7 获取账户信息

获取账户信息接口可以获取指定平台的账户信息，调用接口

参数说明：

3.5 社交

3.5.1 分享

分享内容到社交平台，支持分享链接、图片、视频、Facebook OpenGraph（Facebook专属），调用接口

参数说明

3.5.1.1 分享链接

分享链接shareContent参数传入WAShareLinkContent类型实体类对象。

WAShareLinkContent字段说明

示例

3.5.1.2 分享图片

分享图片shareContent参数传入WASharePhotoContent类型实体类对象。

WASharePhotoContent字段说明

WASharePhoto字段说明

示例

3.5.1.3 分享视频

分享视频shareContent参数传入WAShareVideoContent类型实体类对象。

WAShareVideoContent字段说明

WAShareVideo字段说明

示例

3.5.1.4 分享OpenGraph (Facebook)

分享OpenGraph shareContent参数传入WAShareOpenGraphContent类型实体类对象。

注意：分享OpenGraph时，platform参数固定值FACEBOOK

WAShareOpenGraphContent字段说明

3.5.2 应用邀请

发送应用邀请，可以邀请社交平台用户打开应用或者下载应用。

参数说明：

3.5.3 发送请求

向平台的好友发送请求，请求类型包括普通请求、游戏邀请、赠送礼物、索要礼物等，发送请求调用接口

参数说明

WARequestSendResult字段说明：

3.5.4 游戏邀请

发送游戏邀请请求接口请参照章节3.5.3 发送请求

3.5.4.1 查询可邀请好友列表

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

参数说明

3.5.4.2 记录邀请成功信息

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

参数说明：

3.5.4.3 邀请安装奖励

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

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

参数说明：

3.5.4.4 邀请事件奖励

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

参数说明：

3.5.5 查询好友

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

参数说明：

3.5.6 礼物

赠送礼物、索要礼物接口请参照章节3.5.3 发送请求

3.5.6.1 Facebook查询Graph Object

Facebook平台的礼物就是在Facebook控制台创建的用来当做礼物的Graph Object，查询Facebook后台创建的Graph Object，调用接口

Facebook后台新建礼物（Open Graph Object）参考4.2.5 Facebook后台新建Grap Object

参数说明

3.5.6.2 Facebook查询收到的礼物

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

参数说明：

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

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

参数说明：

3.5.6.4 Facebook删除请求

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

参数说明：

3.5.7 Game Service(已停止维护更新)

3.5.7.1 登录Game Service

登录Game Service调用接口：

参数说明：

3.5.7.2 登出Game Service

登出Game Service调用以下接口：

参数说明：

3.5.7.3 成就解锁

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

参数说明：

3.5.7.4 分步成就进度增加

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

参数说明：

3.5.7.5 分步成就进度设置

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

参数说明：

3.5.7.6 显示隐藏成就

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

参数说明：

3.5.7.7 展示成就列表

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

参数说明：

3.5.7.8 加载成就列表

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

参数说明：

WAAchievement字段说明：

3.5.7.9 判断是否已经登录Game Service

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

参数说明：

3.5.8 游戏社区

3.5.8.1 通过Group id查询Group详情

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

参数说明：

WAGroup字段说明：

3.5.8.2 查询当前应用关联的Group

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

参数说明：

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

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

参数说明：

3.5.8.4 查询当前用户是否Group的成员

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

参数说明：

3.5.8.5 加入Group

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

参数说明：

3.5.8.6 进入Group详情页

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

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

参数说明：

3.6 Android6.0 权限管理

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

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

四、第三方配置

4.1 Google相关配置

如果不需要Google渠道，请忽略此章节
后台配置请参考第三方后台配置—Android版公共配置流程。

4.1.1 Google基本配置

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

获取Google public key
请参考第三方后台配置—Android版1.7 获取Google Play Public Licensing Key。

在values/strings.xml中添加服务器OAuth client ID（即Google后台Web application 类型的OAuth client ID）

4.1.2 Google Game Service配置

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

说明：字符资源的值是Google Game Service的APP ID,需要Google开发者控制台创建游戏服务获得。请参考第三方后台配置—Android版1.6 添加Google Game Service成就。

4.1.3 Google代码混淆配置

4.1.4 Google获取SHA-1指纹

具体配置请参考第三方后台配置—Android版1.1 配置应用程序证书指纹。

获取程序签名文件SHA-1命令如下：

其中<release_key_alias>是证书别名，<path-to-production-keystore>是证书的地址。

4.2 Facebook相关配置

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

4.2.1 Facebook基本配置

在strings.xml中添加Facebook APPId声明：

在AndroidManifest.xml中添加配置

注意：
1、string的name必须为facebook_app_id，不可更改，值为Facebook app id
2、将FacebookContentProvider后面的${YOUR_FACEBOOK_APP_ID}替换成你的Facebook app id。获取方式请参考第三方后台配置—Android版2.1 Facebook基础配置。

4.2.2 Facebook代码混淆配置

4.2.3 Facebook登录权限对照表

4.2.4 Facebook获取程序签名KeyHash

使用下面代码片段获取程序签名KeyHash

4.2.5 Facebook后台新建Grap Object

具体配置请参考第三方后台配置—Android版2.4 Facebook后台新建礼物。

WAFBGraphObject 中的字段与新建Object字段对照（“-”标识系统自动生成）

4.3 AppsFlyer相关配置

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

4.3.1 AppsFlyer基本配置

在AndroidManifest.xml中添加以下声明

4.3.2 AppsFlyer代码混淆配置

4.4 Chartboost相关配置

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

4.4.1 Chartboost基本配置

在AndroidManifest.xml中application标签下添加声明

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

4.4.2 Chartboost代码混淆配置

4.5 VK相关配置

如果不需要使用VK渠道功能，可以忽略此章节

4.5.1 VK基本配置

在values/strings.xml中添加加以下字符串资源：

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

4.5.2 VK代码混淆配置

五、附录

5.1 代码说明

5.1.1 状态码说明

SDK中的状态码统一以静态变量方式封装在WACallback接口里面，如果使用到状态码，强烈建议采用静态变量的方式调用，不要直接使用数值。

5.1.2 平台取值

5.1.3 请求类型说明

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

5.2 事件说明

5.2.1 SDK预定义事件名

在WAEventType接口中定义

5.2.2 SDK预定义参数名

在WAEventParameterName接口中定义