二、快速集成

2.0.集成需知

2.1 环境配置要求

• Android API 19及以上版本

• jdk1.7及以上版本。

• compileSdkVersion 26及以上版本

2.2 集成SDK到项目

第三方SDK依赖关系如下表

2.2.1 Gradle自动集成

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

注意：
1）部分项目中可能只有一个build.gradle文件;

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

注意：
1）部分项目中可能只有一个build.gradle文件；
2）以上的“必选”项目必须引入，“可选”项目可根据需求引入。
3) 其中x.x.x为各个模块的具体版本号，随SDK版本升级会发生改变，各个版本对应的渠道包版本请参考：https://admin.wingsdk.com/developers/pack_config.do 在这个地址页面，也可以通过选择版本和所需要的渠道，一键生成依赖脚本配置。

2.3 SDK配置及初始化

2.3.1 SDK配置

2.3.1.1 AndroidManifest.xml配置：

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

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

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

3）CP接入aihelp必备权限

2.3.1.2 Activity结果传递配置

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

2.3.2 SDK初始化

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

注意：SDK初始化必须在第一个Activity的onCreate()方法中调用,强烈建议在UI线程中调用。

2.4 登录

2.4.1 使用登录窗口

2.4.1.1 调用登录窗口

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

参数说明：

注意：使用登录窗口时，点击图标登录SDK自动弹出加载框，无需再次添加加载框。

2.4.1.2 清除登录窗口的缓存

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

2.4.2 使用接口登录

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

2.4.3 处理登录结果

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

WALoginResult字段说明

2.4.4 用户登出

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

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

2.5 支付

2.5.1 初始化支付

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

参数说明：

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

2.5.2 查询库存商品列表

通过查询库存商品列表，可以获取所有可以购买的库存商品，查询库存调用接口(建议支付初始化完成后，就开始调用此接口)

注意：这里返回的库存商品信息是WINGSDK平台的商品信息，并非第三方平台的商品信息。建议在商品页出来之前调用，最好是sdk初始化完后就开始调用

参数说明：

WASkuDetails实体类说明：

2.5.3 购买商品

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

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

注意：如果需要在订单信息中记录当前玩家昵称，需要按3.1.4 设置玩家昵称设置玩家昵称。

参数说明：

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

WAPurchaseResult实体类说明：

2.5.4 查询支付服务是否可用

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

参数说明：

2.5.5 资源释放

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

示例：

2.6 数据收集

使用WINGSDK数据收集接口配合大数据平台，可以轻松统计玩家习惯以及充值等行为，为游戏的市场营销提供数据依据。

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 渠道名称
value 累加统计的数值

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

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

参数：
eventValues 参数/值Map

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

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

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

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

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

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

参数：
eventChannel 渠道名称
paramName 参数名
paramValue 参数值

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

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

参数：
eventChannel 渠道名称

注意：
1）默认情况下是所有启用的渠道都发送
2）该接口只是针对当前事件禁用发送到某个渠道
3）完全启用/关闭某个渠道数据收集，请参考四、第三方配置相关章节

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 自定义事件

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

三、高级功能

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 设置游戏玩家昵称

设置游戏玩家的昵称，调用接口：

注意：
1.当玩家登录、登出游戏，或修改昵称时，需要及时调用这个接口设置玩家昵称。
2.调用该接口设置昵称后，玩家进行购买时会自动记录昵称到订单信息中。

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.9 智能客服 AIHelp

3.9.7.设置客服系统中所展示的游戏名称

示例代码:

参数说明：

3.9.8.设置客服系统语言

示例代码:

语言支持列表图:

3.9.9. 判断是否开启AiHelp

说明：该接口返回布尔值，true表示已开启，false表示未开启。在使用其他AIHELP接口前请先判断这个接口，在返回true的情况下使用。示例如下：

3.9.10. 展示WING后台配置界面

参数说明：

说明：这个接口展示的界面由WING后台中SDK客服开关配置决定。如果后台未开启客服开关，此接口不生效。同时提供了无参数的重载方法WACscProxy.openAiHelp(),表示使用默认语言设置和设置非Vip用户。

四、第三方配置

4.9.华为HMS相关配置

4.9.1.华为HMS基本配置

1）在项目级别根build.gradle中配置华为仓库地址和依赖插件，如下：

2）在应用级别的根目录中添加agconnect-services.json文件，如下图所示：

agconnect-services.json的生成请参考《WINGSDK第三方后台配置.docx》中添加华为HMS后台配置章节。

3）在应用级别的build.gradle中，添加华为插件，如下：
apply plugin: ‘com.huawei.agconnect’

4）在应用级别的build.gradle中，添加华为多语种支持，配置如下：
android {
defaultConfig {
//华为多语种设置，由CP配置
resConfigs “en”, “zh-rCN”, “pt-rBR”
}
}
5）在AndroidManifest.xml中添加配置:

4.9.2.华为HMS混淆配置

1)proguard-rules.pro文件配置

2）AndResGuard配置方式

说明：如果应用无相关混淆可不配置。

4.9.3.华为HMS权限配置

说明：SDK已经集成权限，如果危险权限需要CP动态申请权限。

五、附录

5.1 代码说明

5.1.1 状态码说明

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

5.1.2 平台取值

5.2 事件说明

5.2.1 SDK预定义事件名

在WAEventType接口中定义

5.2.2 SDK预定义参数名

在WAEventParameterName接口中定义