1.简介

WingEpicExeSDK主要是为满足PC端Epic平台Windows的游戏需要，为此类游戏提供基于Epic平台的登录、支付、数据收集等通用功能。以下文档中会把WingEpicExeSDK简称为SDK。

2.集成

2.1.SDK库选择

SDK提供了多个版本的库文件，可以根据项目需求使用。

MT编译版本：已经内置VC运行库内容，不依赖于外部VC运行库。
普通(MD)编译版本：该版本会使用附带的vcruntime140.dll，msvcp140.dll，vcruntime140_1.dll这几个文件。

对应的dll版本:

2.2.项目集成

以VisualStudio项目工程为例

1.下载最新版本SDK压缩包，并解压

2.SDK头文件引入
1)复制include文件夹及其内容到项目中，主要包含wing目录下的wing_api.h头文件
2)右键项目->属性->C/C++->常规->附加包含目录，填入include文件夹路径，例如include文件夹是复制到项目根目录下，则路径可以填写：$(ProjectDir)include

3.SDK库文件引入
1)复制lib文件夹及其内容到项目中，并在项目属性页->链接器->常规->附加库目录，中填入lib文件夹路径，例如lib文件夹是复制到项目根目录下，则路径可以填写：$(ProjectDir)lib
2)在项目属性页->链接器->输入->附加依赖项中填入sdk的lib文件，如果是x86编译，则填入wingsdk.lib，如果是x64编译，则填入wingsdk64.lib，如果使用mt版本，则选择对应带mt后缀lib文件。

4.SDK的Api使用
1)在项目中引入。以前面步骤的配置路径作为示例，那么引入的路径为 #include “wing/wing_api.h”
2)在项目中使用。wing_api.h的接口为命名空间+方法的使用方式，例如：sdk的初始化方法使用，WingProxy::Init(“appId”,“appKey”,[](int code,string msg,string data){});

5.项目编译后，需要把sdk用到的dll文件复制到编译后的exe程序目录中，否则项目无法正常运行。具体版本对应的dll文件，参考前面dll版本文件对应表。例如x86的dll内容如下图：

6.运行程序

2.3.三方库版本

3.接口说明

3.1.使用方式

sdk的api采用命名空间+方法的形式定义的，WingProxy是所有sdk接口的命名空间，以初始化方法为例，使用方式：

3.2.回调函数

sdk接口的参数中，除了一些常见类型参数，在wing_api.h中还声明了WingCallback回调函数，参数说明如下：

4.SDK接口

4.1.初始化

调用下面接口对SDK进行初始化，建议在程序开始时首先调用，确保后续其他sdk接口可以正常使用,该方法需在主线程中调用.

参数说明：

代码示例：

4.2.更新SDK事件

调用以下方法通知SDK进行工作。为了使SDK提供的服务正常运行，必须经常调用该函数。对于基于时间间隔（tick-based）的应用，通常希望每个时间间隔调用一次这个函数。该方法需在主线程中调用.

代码示例：

4.3.退出程序

调用下面接口对SDK内资源进行释放，必须在程序退出前调用。

4.4.登录

使用下面接口进行登录

参数说明：

WingCallback的data内容字段说明：

代码示例：

4.5.购买商品

参数说明：

WingCallback的data内容字段说明：

代码示例：

4.6.游戏必要参数设置

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

参数设置时机除了按照说明设置，另外需要特别注意在游戏启动时的设置时机，具体参考 流程要求

4.6.1 设置服务器ID

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

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

4.6.2.设置GameUserId

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

注意：
1.必须在调用其他事件前设置。
2.游戏角色ID是游戏角色在游戏中的ID，不是WINGSDK自身的UserId。
3.若未创角前拿不到游戏角色ID，可以先设置-1，创角后再设置一次正确的角色ID

4.6.3.设置用户等级Level

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

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

4.6.4.设置玩家游戏昵称

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

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

4.7.数据收集

4.7.1.流程要求

WINGSDK数据收集使用在游戏的过程中打点的方式，如图所示:

注意：

1.以上流程图中涉及到的几个接口是有时序要求的，请参考流程图中的逻辑步骤进行设置：WingProxy::SetServerId()、WingProxy::SetGameUserId()、WingProxy::SetLevel()、WingProxy::SetNickName()、ghw_user_import事件、ghw_user_create事件。

2.其它的事件如ghw_level_achieved、ghw_self_tutorial_completed等请根据对应业务逻辑，在对应业务发生时调用接口发送。

4.7.2.发送事件

使用下面接口发送事件

参数说明：

代码示例：

4.7.3.预定义事件

4.7.3.1.ghw_user_import导入用户事件(进服)

说明:导入用户事件，玩家第一次进某个服时调用

注意：发送ghw_user_import事件前需调用设置服务器ID接口更新服务器id、设置gameUserId接口更新游戏用户id
代码示例：

4.7.3.2.ghw_user_create 创建角色

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

代码示例

4.7.3.3.ghw_user_info_update 更新用户信息

代码示例

4.7.3.4.ghw_level_achieved 等级增长事件

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

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

4.7.4.自定义事件

如果发送的事件不属于预定义事件范围，事件发送时会自动补上ghw_self_前缀，例如关键等级5的事件名称传入，lv_5，最终发送的事件名称为ghw_self_lv_5。

4.7.4.1.ghw_self_lv_x关键等级事件

代码示例：

4.7.4.2.ghw_self_tutorial_completed完成新手任务

5.调试日志

SDK的日志默认是关闭状态的，开启日志后会在程序目录下生成winglog.log日志文件，可以查看SDK的日志信息。

开启SDK调试日志：
1.SDK日志的开启需要提供设备的ClientId，在用户的隐藏目录AppData下找到SharedConf配置文件，以文本的形式查看文件可以得到ClientId值。
具体路径：C:\Users\用户名\AppData\Local\WingEpicExeSDK\SharedConf
文本内容参考：{“ClientId”:”5c56b3400000000000000e0a76c72″}
2.把ClientId的值提供给运营，运营在后台操作加入测试设备
3.重启已接入SDK的程序，进行SDK相关操作，即可在winlog.log查看SDK输出的相关日志信息。

6.状态码说明