581 lines
23 KiB
C++
581 lines
23 KiB
C++
/************************************************************
|
||
Copyright (C), 2008-2018, Tencent Tech. Co., Ltd.
|
||
FileName: iigw_api_client.h
|
||
Author: cooperli Version : 1.0 Date: 2008-03-25
|
||
Description: 信息网关API头文件
|
||
|
||
History:
|
||
<author> <time> <version > <desc>
|
||
cooperli 2008-03-27 1.0 build
|
||
***********************************************************/
|
||
#ifndef _ITC_CLIENT_H_
|
||
#define _ITC_CLIENT_H_
|
||
|
||
// VC动态库
|
||
#ifdef iigw_client_api_EXPORTS
|
||
#define IIGW_DLL_EXPORT __declspec(dllexport)
|
||
#else
|
||
#define IIGW_DLL_EXPORT
|
||
#endif
|
||
|
||
#ifdef __cplusplus
|
||
extern "C"
|
||
{
|
||
#endif
|
||
|
||
|
||
#define SVR_PROT 5692 // IIGW SERVER 的端口
|
||
#define INFOGW_MAX_MSG_LEN 2048 // 最大消息长度为512 BYTE
|
||
#define INFOGW_MAX_TO_GAME_SVR_STR_LEN 256 // 最大送到GAME SERVER的串长度为256 BYTE
|
||
#define INFOGW_MIN_ERR_BUF_LEN 256 // 最小消息长度为256 BYTE
|
||
#define INFOGW_OPEN_ID_LEN 64
|
||
|
||
// 消息类型定义INFOGW_MSG_TYPE
|
||
enum
|
||
{
|
||
INFOGW_MSG_TYPE_REQ = 1, // 请求消息
|
||
INFOGW_MSG_TYPE_ACK = 2, // 回应消息
|
||
INFOGW_MSG_TYPE_BOTTOM // 底部，无效值
|
||
};
|
||
|
||
// 消息错误类型定义
|
||
enum IIGW_MSG_STATUS
|
||
{
|
||
IIGW_MSG_STATUS_OK = 0, // 正确消息
|
||
IIGW_MSG_STATUS_UNKNOWN_VER_ERR = 1, // MAGIC KEY出错
|
||
IIGW_MSG_STATUS_MSG_TYPE_ERR = 2, // 消息类型错误
|
||
IIGW_MSG_STATUS_OPT_ERR = 3, // 业务类型出错
|
||
IIGW_MSG_STATUS_NO_RETURN = 4, // 没有收到对端的回应
|
||
IIGW_MSG_STATUS_CRYPT_LEN_ERR = 5, // TO GAME SVR的消息长度出错
|
||
IIGW_MSG_STATUS_MSG_LEN_ERR = 6, // 消息长度出错
|
||
IIGW_MSG_STATUS_BUF_LEN_ERR = 7, // 输入BUFFFER长度太少
|
||
IIGW_MSG_STATUS_RD_CFG_ERR = 8, // 读配置出错
|
||
IIGW_MSG_STATUS_CONNECT_ERR = 9, // 连接出错
|
||
IIGW_MSG_STATUS_SENT_MSG_ERR = 10, // 发送消息出错
|
||
IIGW_MSG_STATUS_DNS_RESOLVE_ERR = 30, // DNS解释出错，不能把域名解释成IP
|
||
IIGW_MSG_STATUS_PARSE_RSP_ERR = 11, // 解析返回包出错
|
||
IIGW_MSG_STATUS_PARA_ERR = -1, // 参数出错
|
||
|
||
// 服务端发现的错误lix
|
||
IIGW_MSG_STATUS_UNKNOWN_VER_ERR_R = 101, // MAGIC KEY出错
|
||
IIGW_MSG_STATUS_MSG_TYPE_ERR_R = 102, // 消息类型错误
|
||
IIGW_MSG_STATUS_OPT_ERR_R = 103, // 业务类型出错
|
||
IIGW_MSG_STATUS_HEARD_LEN_ERR_R = 104, // 消息协议头长度出错
|
||
IIGW_MSG_STATUS_OPT_LEN_ERR = 105, // 业务信息长度出错
|
||
IIGW_MSG_STATUS_OPT_COUNT_ERR = 106, // 业务信息长度出错
|
||
IIGW_MSG_STATUS_NET_ERR_R = 107, // 网络通讯出错
|
||
IIGW_MSG_STATUS_RES_LIMIT_R = 110, // 资源受限
|
||
|
||
IIGW_MSG_STATUS_BJ_NEW_USER = 200, // CF !!! 北京新用户，禁止登陆
|
||
|
||
IIGW_MSG_STATUS_NETBAR_PC = 256, // 是网吧机器
|
||
IIGW_MSG_STATUS_NOT_IN_NETBAR = 300, // 非网吧环境
|
||
IIGW_MSG_STATUS_NOT_A_CHINESE_OS = 301, // 非中文操作系统
|
||
|
||
IIGW_MSG_STATUS_VMP_CRC_ERROR = 400,
|
||
IIGW_MSG_STATUS_VMP_DEBUG_ERROR = 401,
|
||
IIGW_MSG_STATUS_OS_SEH_ERROR = 402,
|
||
IIGW_MSG_STATUS_CPP_SEH_ERROR = 403,
|
||
IIGW_MSG_STATUS_UNKNOW_ERROR = 404,
|
||
IIGW_MSG_STATUS_BOTTOM // 底部，无效值
|
||
};
|
||
|
||
// 业务ID定义 INFOGW_OPERATION_ID
|
||
enum
|
||
{
|
||
INFOGW_OPERATION_CF = 10, // CF查询网吧等级业务ID
|
||
INFOGW_OPERATION_DNF = 20, // DNF查询网吧等级业务ID
|
||
INFOGW_OPERATION_ID_BOTTOM // 底部，无效值
|
||
};
|
||
|
||
typedef unsigned int UINT;
|
||
typedef struct infoGWReqMsgHeader_st
|
||
{
|
||
UINT uiVersion; // 版本号，认证头
|
||
UINT uiMsgType; // 消息类型，可以表示客户端消息，服务后台消息等
|
||
UINT uiSeqNo; //
|
||
UINT uiTime; // 本地时间戳
|
||
UINT uiOperationId; // 查询的业务类型 .参看 enum INFOGW_OPERATION_ID
|
||
UINT uiStatus; // 当为接收的信息时有效
|
||
UINT uiMsgBodyLen; // 业务消息长度
|
||
} INFOGW_INTF_CLIENT_MSG_HEADER;
|
||
|
||
typedef struct infoGWReqMsg_st
|
||
{
|
||
INFOGW_INTF_CLIENT_MSG_HEADER stMsgHd;
|
||
char szMsgBody[INFOGW_MAX_MSG_LEN]; // 业务相关消息体
|
||
} INFOGW_INTF_CLIENT_MSG;
|
||
|
||
typedef struct infoGWReqNetbarLv_st
|
||
{
|
||
unsigned int uiUni;
|
||
unsigned int ulNetbarIP;
|
||
} INFOGW_REQ_NETBAR_LV;
|
||
|
||
|
||
typedef struct infoGWReqNetbarLvOpenid_st
|
||
{
|
||
unsigned int uiType;
|
||
char open_id[INFOGW_OPEN_ID_LEN];
|
||
unsigned int ulNetbarIP;
|
||
} INFOGW_REQ_NETBAR_LV_OPENID;
|
||
|
||
// TO GAME SERVER 的的加密串的明文结构
|
||
typedef struct IIGWNetbar_st
|
||
{
|
||
unsigned int ulInfoGWTimeStamp; // 时间截
|
||
unsigned int uiUni; // QQ号码
|
||
unsigned int ulNetbarIP; // 网吧ip
|
||
unsigned char ucNetbarLv; // 网吧等级
|
||
//unsigned int ulNetbarLv; // 网吧等级v2
|
||
unsigned char ucCreditRank; // 荣誉等级
|
||
unsigned char ucTeamRank; // 战队等级
|
||
unsigned char ucVIP; // 会员VIP
|
||
unsigned char ucCampaign; // 活动
|
||
unsigned char ucReserve[15]; // 备用
|
||
} INFOGW_NETBAR;
|
||
|
||
//==============================================================
|
||
#define IIGE_MAX_OP_COUNT 15 // 批量查询每次查询的最大业务数量
|
||
#define IIGW_CRYPT_BUF_LEN 128 // 批量查询返回加密串缓存区长度
|
||
|
||
typedef struct IIGW_OPERATIONS
|
||
{
|
||
int count;
|
||
unsigned int uiOperationId[IIGE_MAX_OP_COUNT];
|
||
} INFOGW_OPIDS;
|
||
|
||
typedef struct IIGW_NETBAR_INFO_
|
||
{
|
||
unsigned int uiOperationId;
|
||
int iStatus; // 返回状态:1-正常,0-非正常
|
||
unsigned int ucCryptBufLen;
|
||
unsigned char szCryptBuf[IIGW_CRYPT_BUF_LEN];
|
||
} IIGW_NETBAR_INFO;
|
||
|
||
typedef struct IIGW_NETBAR_INFO_BATCH_ {
|
||
int count;
|
||
IIGW_NETBAR_INFO stNetbarInfo[IIGE_MAX_OP_COUNT];
|
||
} IIGW_NETBAR_INFO_BATCH;
|
||
//==============================================================
|
||
|
||
/*************************************************
|
||
Function: INFOGW_api_req_netbar_lv
|
||
Description: 请求查询网吧等级，并等待回应的加密包
|
||
|
||
Calls: INFOGW_api_set_server
|
||
INFOGW_send_recv
|
||
Called By: API 外部调用
|
||
Table Accessed: NONE
|
||
Table Updated: NONE
|
||
Input:
|
||
const int uiOperationId, -- 业务代码(不同的游戏有不同的业务代码)
|
||
unsigned long uiUni, -- QQ号码
|
||
const char *cIP, -- 网吧IP
|
||
const unsigned char *ticketBuf, -- TGP票据,若不需要填空
|
||
const int ticketLen, -- TGP票据长度,若不需要填0
|
||
unsigned long errBufLen -- error 的BUFFER大小:不应少于256
|
||
|
||
INOUT
|
||
int *bufLen, -- 输入是ack_buf的最大长度，不应少于256，输出是响应数据长度
|
||
|
||
Output:
|
||
void *cryptInfoBuf, -- 响应数据的BUFFER地址
|
||
void *error -- 错误描述的BUFFER地址，输入时BUFFER必需清空,不应少于256
|
||
|
||
Return: 返回0成功，其它为错误码，在iigw_api_client.h enum IIGW_MSG_STATUS中定义
|
||
History:
|
||
<author> <time> <version > <desc>
|
||
anselyang 2008-03-25 1.0 build
|
||
*************************************************/
|
||
int IIGW_DLL_EXPORT INFOGW_api_req_netbar_lv
|
||
(
|
||
const int uiOperationId, // 业务代码
|
||
unsigned long uiUni, // QQ No.
|
||
const char *cIP, // netbar ip addr. eg: 192.168.1.1
|
||
const unsigned char *ticketBuf, // TGP票据,若不需要填空
|
||
const int ticketLen, // TGP票据长度,若不需要填0
|
||
unsigned char *cryptInfoBuf, // output crypt info. . include: netbar level, netbar ip , infoGW's timestamp
|
||
int *bufLen, // crypt info. len
|
||
char *error, // error print char
|
||
unsigned long errBufLen // error buffer size
|
||
);
|
||
|
||
/*************************************************
|
||
Function: INFOGW_api_req_netbar_lv_ext
|
||
Description: 请求查询网吧等级，并等待回应的加密包 CF活动是否弹出
|
||
|
||
Calls: INFOGW_api_set_server
|
||
INFOGW_send_recv
|
||
Called By: API 外部调用
|
||
Table Accessed: NONE
|
||
Table Updated: NONE
|
||
Input:
|
||
const int uiOperationId, -- 业务代码(不同的游戏有不同的业务代码)
|
||
unsigned long uiUni, -- QQ号码
|
||
const char *cIP, -- 网吧IP
|
||
const unsigned char *ticketBuf, -- TGP票据,若不需要填空
|
||
const int ticketLen, -- TGP票据长度,若不需要填0
|
||
unsigned long errBufLen -- error 的BUFFER大小:不应少于256
|
||
|
||
INOUT
|
||
int *bufLen, -- 输入是ack_buf的最大长度，不应少于256，输出是响应数据长度
|
||
|
||
Output:
|
||
void *cryptInfoBuf, -- 响应数据的BUFFER地址
|
||
void *error -- 错误描述的BUFFER地址，输入时BUFFER必需清空,不应少于256
|
||
char *op_buf, -- 其他可选BUF 只给CF 活动用 stMsgHd.uiSeqNo
|
||
int *op_buf_len -- 其他可选BUF 长度 只给CF 活动用 stMsgHd.uiSeqNo
|
||
|
||
Return: 返回0成功，其它为错误码，在iigw_api_client.h enum IIGW_MSG_STATUS中定义
|
||
History:
|
||
<author> <time> <version > <desc>
|
||
anselyang 2009-07-14 1.0 build
|
||
*************************************************/
|
||
int IIGW_DLL_EXPORT INFOGW_api_req_netbar_lv_ext
|
||
(
|
||
const int uiOperationId, // 业务代码
|
||
unsigned long uiUni, // QQ No.
|
||
const char *cIP, // netbar ip addr. eg: 192.168.1.1
|
||
const unsigned char *ticketBuf, // TGP票据,若不需要填空
|
||
const int ticketLen, // TGP票据长度,若不需要填0
|
||
unsigned char *cryptInfoBuf, // output crypt info. . include: netbar level, netbar ip , infoGW's timestamp
|
||
int *bufLen, // crypt info. len
|
||
char *error, // error print char
|
||
unsigned long errBufLen, // error buffer size
|
||
char *op_buf, // 其他可选BUF 只给CF 活动用 stMsgHd.uiSeqNo
|
||
int *op_buf_len // 其他可选BUF 长度 只给CF 活动用 stMsgHd.uiSeqNo
|
||
);
|
||
|
||
|
||
/*************************************************
|
||
Function: INFOGW_api_req_platinum_netbar_lv
|
||
Description: 请求查询铂金网吧等级
|
||
Input:
|
||
const int uiOperationId, -- 业务代码(不同的游戏有不同的业务代码)
|
||
unsigned long uiUni, -- QQ号码，没有可填0
|
||
Output:
|
||
int &level, -- 铂金网吧等级
|
||
|
||
Return: 返回0成功，其它为错误码，在iigw_api_client.h enum IIGW_MSG_STATUS中定义
|
||
History:
|
||
<author> <time> <version > <desc>
|
||
cooperli 2016-11-29 1.0 build
|
||
*************************************************/
|
||
int IIGW_DLL_EXPORT INFOGW_api_req_platinum_netbar_lv
|
||
(
|
||
const int uiOperationId, // 业务代码
|
||
unsigned long uiUni, // QQ No.
|
||
int &level // 铂金网吧等级
|
||
);
|
||
|
||
/*************************************************
|
||
Function: INFOGW_api_req_platinum_netbar_lv_ext
|
||
Description: 请求查询铂金网吧等级
|
||
Input:
|
||
const int uiOperationId, -- 业务代码(不同的游戏有不同的业务代码)
|
||
unsigned long uiUni, -- QQ号码，没有可填0
|
||
unsigned int zone_id, -- 游戏大区，没有可填0
|
||
Output:
|
||
int &level, -- 铂金网吧等级
|
||
|
||
Return: 返回0成功，其它为错误码，在iigw_api_client.h enum IIGW_MSG_STATUS中定义
|
||
History:
|
||
<author> <time> <version > <desc>
|
||
cooperli 2016-11-29 1.0 build
|
||
*************************************************/
|
||
int IIGW_DLL_EXPORT INFOGW_api_req_platinum_netbar_lv_ext
|
||
(
|
||
const int uiOperationId, // 业务代码
|
||
unsigned long uiUni, // QQ No.
|
||
unsigned int zone_id, //游戏大区
|
||
int &level // 铂金网吧等级
|
||
);
|
||
|
||
/*************************************************
|
||
Function: INFOGW_api_req_netbar_lv_ext_with_zone_id
|
||
Description: 请求查询网吧等级，并等待回应的加密包 CF活动是否弹出
|
||
|
||
Calls: INFOGW_api_set_server
|
||
INFOGW_send_recv
|
||
Called By: API 外部调用
|
||
Table Accessed: NONE
|
||
Table Updated: NONE
|
||
Input:
|
||
const int uiOperationId, -- 业务代码(不同的游戏有不同的业务代码)
|
||
unsigned long uiUni, -- QQ号码
|
||
unsigned long zone_id, -- 大区ID
|
||
const char *cIP, -- 网吧IP
|
||
const unsigned char *ticketBuf, -- TGP票据,若不需要填空
|
||
const int ticketLen, -- TGP票据长度,若不需要填0
|
||
unsigned long errBufLen -- error 的BUFFER大小:不应少于256
|
||
|
||
INOUT
|
||
int *bufLen, -- 输入是ack_buf的最大长度，不应少于256，输出是响应数据长度
|
||
|
||
Output:
|
||
void *cryptInfoBuf, -- 响应数据的BUFFER地址
|
||
void *error -- 错误描述的BUFFER地址，输入时BUFFER必需清空,不应少于256
|
||
char *op_buf, -- 其他可选BUF 只给CF 活动用 stMsgHd.uiSeqNo
|
||
int *op_buf_len -- 其他可选BUF 长度 只给CF 活动用 stMsgHd.uiSeqNo
|
||
|
||
Return: 返回0成功，其它为错误码，在iigw_api_client.h enum IIGW_MSG_STATUS中定义
|
||
History:
|
||
<author> <time> <version > <desc>
|
||
cooperli 2017-01-19 1.0 build
|
||
*************************************************/
|
||
int IIGW_DLL_EXPORT INFOGW_api_req_netbar_lv_ext_with_zone_id
|
||
(
|
||
const int uiOperationId, // 业务代码
|
||
unsigned long uiUni, // QQ No.
|
||
unsigned int zone_id, // 游戏大区.
|
||
const char *cIP, // netbar ip addr. eg: 192.168.1.1
|
||
const unsigned char *ticketBuf, // TGP票据,若不需要填空
|
||
const int ticketLen, // TGP票据长度,若不需要填0
|
||
unsigned char *cryptInfoBuf, // output crypt info. . include: netbar level, netbar ip , infoGW's timestamp
|
||
int *bufLen, // crypt info. len
|
||
char *error, // error print char
|
||
unsigned long errBufLen, // error buffer size
|
||
char *op_buf, // 其他可选BUF 只给CF 活动用 stMsgHd.uiSeqNo
|
||
int *op_buf_len, // 其他可选BUF 长度 只给CF 活动用 stMsgHd.uiSeqNo
|
||
const int time_out=5000 // 阻塞时间，单位->毫秒，范围1~10000，默认值为5000
|
||
);
|
||
|
||
//////////////////////////////////////////////////////////////////////////
|
||
/** QQ网吧插件接口*/
|
||
namespace iepm_qqwb{
|
||
|
||
enum account_type{
|
||
at_qq, //0
|
||
at_wechart, // 1
|
||
at_facebook, //2
|
||
at_email, // 3
|
||
at_steam, //4
|
||
at_gopenid,//5
|
||
at_topenid, // 6 手机号对应的openid
|
||
};
|
||
|
||
/**
|
||
* @brief NetbarLv QQ网吧签名结构体
|
||
* @param tokenBuf 用来存放QQ网吧签名的buff
|
||
* @param tokenLen QQ网吧签名的长度
|
||
* @param ip PC的ip地址
|
||
* @param macs PC的mac地址列表
|
||
* @param macSize PC的mac地址个数
|
||
*/
|
||
struct NetbarLv {
|
||
unsigned char tokenBuff[1024];
|
||
int tokenLen;
|
||
char ip[32];
|
||
char macs[128];
|
||
int macSize;
|
||
};
|
||
|
||
/**
|
||
* @brief notify_req_netbarlv_result 回调函数，返回获取签名的结果和内容
|
||
* @param game_id 游戏ID
|
||
* @param zone_id 登录游戏的大区号
|
||
* @param open_id 用户登录游戏的open_id
|
||
* @param ret_code 获取签名的结果，返回0成功，其他为错误码，参考enum IIGW_MSG_STATUS中定义
|
||
* @param netbarlv NetbarLv信息，当ret_code=0时返回
|
||
*/
|
||
typedef void(*notify_req_netbarlv_result)(
|
||
unsigned int game_id,
|
||
unsigned int zone_id,
|
||
const char open_id[INFOGW_OPEN_ID_LEN],
|
||
int ret_code,
|
||
NetbarLv *netbarlv
|
||
);
|
||
|
||
struct IQQNetbarIIGWPlugin{
|
||
/**
|
||
* @brief 获取网吧机器信息
|
||
* @param game_id 游戏ID，由网吧项目组这边分配
|
||
* @param uin 用户登录游戏的QQ号
|
||
* @param zone_id 登录游戏的大区号
|
||
* @param cryptInfoBuf 用来存放网吧机器信息的加密串
|
||
* @param bufLen 加密串长度
|
||
* @param time_out 阻塞时间，单位->毫秒，范围1~10000 ，默认值为5000
|
||
* @return int 返回0成功，其他为错误码，参考enum IIGW_MSG_STATUS中定义
|
||
*/
|
||
virtual int GetNetbarMachineContent(
|
||
unsigned int game_id,
|
||
unsigned int uin,
|
||
unsigned int zone_id,
|
||
unsigned char *cryptInfoBuf,
|
||
int *bufLen,
|
||
const int time_out=5000
|
||
) = 0;
|
||
|
||
/**
|
||
* @brief 获取机器是否在网吧
|
||
* @param open_id 用户登录游戏的open_id，最大长度64
|
||
* @param type open_id帐号类型，参考account_type，0是QQ号，1是微信，2是facebook，3是邮箱账号，4是steam账号
|
||
* @return int 返回IIGW_MSG_STATUS_NETBAR_PC表示是网吧机器, IIGW_MSG_STATUS_NOT_IN_NETBAR表示非网吧机器，其他为错误码
|
||
*/
|
||
virtual int IsNetbarMachine(unsigned int game_id,
|
||
const char open_id[INFOGW_OPEN_ID_LEN],
|
||
account_type type) = 0;
|
||
|
||
/**
|
||
* @brief 获取机器是否在网吧，该接口仅为pubg使用
|
||
* @return bool 返回true表示在网吧
|
||
*/
|
||
virtual int IsNetbarMachine() = 0;
|
||
|
||
/**
|
||
* @brief ReqNetbarLv 获取网吧等级
|
||
* @param game_id 游戏ID，由网吧项目组这边分配(对应老接口的uiOperationId)
|
||
* @param zone_id 登录游戏的大区号
|
||
* @param open_id 用户登录游戏的open_id，最大长度64
|
||
* @param ticketBuf, TGP票据,若不需要填空
|
||
* @param ticketLen, TGP票据长度,若不需要填0
|
||
* @param cryptInfoBuf 用来存放网吧机器信息的加密串
|
||
* @param bufLen 加密串长度
|
||
* @param error, 错误的msg
|
||
* @param errBufLen, error buffer size
|
||
* @param op_buf, 其他可选BUF 只给CF 活动用 stMsgHd.uiSeqNo
|
||
* @param op_buf_len, 其他可选BUF 长度 只给CF 活动用 stMsgHd.uiSeqNo
|
||
* @param time_out 阻塞时间，单位->毫秒，范围1~10000，默认值为5000
|
||
* @param type 保留字段，open_id帐号类型，0是QQ号，1是微信，【2是facebook，3是邮箱账号，这2个都是wegame自己的opend_id】
|
||
* @return int 返回0成功，其他为错误码，参考enum IIGW_MSG_STATUS中定义
|
||
*/
|
||
virtual int ReqNetbarLv(
|
||
unsigned int game_id,
|
||
unsigned int zone_id,
|
||
const char open_id[INFOGW_OPEN_ID_LEN],
|
||
const unsigned char *ticketBuf,
|
||
const int ticketLen,
|
||
unsigned char *cryptInfoBuf,
|
||
int *bufLen,
|
||
char *error,
|
||
unsigned long errBufLen,
|
||
char *op_buf,
|
||
int *op_buf_len,
|
||
const int time_out=5000,
|
||
unsigned int type = 1
|
||
) = 0;
|
||
|
||
/**
|
||
* @brief ReqNetbarLv2 获取网吧等级
|
||
* @param game_id 游戏ID，由网吧项目组这边分配(对应老接口的uiOperationId)
|
||
* @param zone_id 登录游戏的大区号
|
||
* @param open_id 用户登录游戏的open_id，最大长度64
|
||
* @param type open_id帐号类型，0是QQ号，1是微信，2是facebook，3是邮箱账号，4是msdk的gopen_id
|
||
* @param ticketBuff, 用户登录游戏时的token,用于登录校验
|
||
* @param ticketLen, 用户登录游戏时的token长度
|
||
* @param netbarlv 输出参数，参考NetbarLv的声明
|
||
* @param time_out 阻塞时间，单位->毫秒，范围1~10000，默认值为5000
|
||
* @return int 返回0成功，其他为错误码，参考enum IIGW_MSG_STATUS中定义
|
||
*/
|
||
virtual int ReqNetbarLv2(
|
||
unsigned int game_id,
|
||
unsigned int zone_id,
|
||
const char open_id[INFOGW_OPEN_ID_LEN],
|
||
unsigned int type,
|
||
const char *ticketBuff,
|
||
const int ticketLen,
|
||
NetbarLv *netbarlv,
|
||
const int time_out = 5000
|
||
) = 0;
|
||
|
||
/**
|
||
* @brief 获取机器是否在网吧，给PUBG用的接口，其他业务请调用IsNetbarMachine
|
||
* @param open_id 用户登录游戏的open_id，最大长度64
|
||
* @param type open_id帐号类型，参考account_type，0是QQ号，1是微信，2是facebook，3是邮箱账号，4是steam账号
|
||
* @return bool 返回true表示在网吧
|
||
*/
|
||
virtual int IsNetbar_ForPubg(const char open_id[INFOGW_OPEN_ID_LEN], account_type type) = 0;
|
||
|
||
/**
|
||
* @brief 获取网吧签名token，给PUBG用的接口
|
||
* @param open_id 用户登录游戏的open_id，最大长度64
|
||
* @param type open_id帐号类型，参考account_type，0是QQ号，1是微信，2是facebook，3是邮箱账号，4是steam账号
|
||
* @param opt_token 存储token用的buff，建议长度512
|
||
* @param opt_token_len 返回的token 长度
|
||
* @return int 返回0成功，返回IIGW_MSG_STATUS_NOT_IN_NETBAR（300）表示非网吧环境，并且opt_token会为空，
|
||
其他为错误码，参考enum IIGW_MSG_STATUS中定义
|
||
*/
|
||
virtual int ReqNetbarToken_ForPubg(const char open_id[INFOGW_OPEN_ID_LEN], account_type type,
|
||
char *opt_token, int *opt_token_len) = 0;
|
||
|
||
/*************************************************
|
||
Function: SetProxy
|
||
Description: 设置代理，在所有获取等级接口之前调用
|
||
History:
|
||
<author> <time> <version > <desc>
|
||
cooperli 2019-6-11 1.0 build
|
||
*************************************************/
|
||
virtual void SetProxy(
|
||
const char url[INFOGW_OPEN_ID_LEN], // 代理URL
|
||
const char user[INFOGW_OPEN_ID_LEN], // 代理账号
|
||
const char pwd[INFOGW_OPEN_ID_LEN] // 代理密码
|
||
) = 0;
|
||
|
||
|
||
/**
|
||
* @brief RegNetbarLvCallback 注册异步获取网吧等级的回调函数，只需调用一次
|
||
* @param handle_result 回调函数
|
||
* @return int 返回0成功，其他为错误码，参考enum IIGW_MSG_STATUS中定义
|
||
*/
|
||
virtual int RegNetbarLvCallback(notify_req_netbarlv_result handle_result) = 0;
|
||
|
||
/**
|
||
* @brief ReqNetbarLv2_Asyn 异步获取网吧等级，调用该函数之前需调用RegNetbarLvCallback注册回调
|
||
* @param game_id 游戏ID，由网吧项目组这边分配(对应老接口的uiOperationId)
|
||
* @param zone_id 登录游戏的大区号
|
||
* @param open_id 用户登录游戏的open_id，最大长度64
|
||
* @param type open_id帐号类型，0是QQ号，1是微信，2是facebook，3是邮箱账号，4是msdk的gopen_id
|
||
* @param ticketBuff, 用户登录游戏时的token,用于登录校验
|
||
* @param ticketLen, 用户登录游戏时的token长度
|
||
* @param time_out 阻塞时间，单位->毫秒，范围1~10000，默认值为5000
|
||
* @return int 返回0成功，其他为错误码，参考enum IIGW_MSG_STATUS中定义
|
||
*/
|
||
virtual int ReqNetbarLv2_Asyn(
|
||
unsigned int game_id,
|
||
unsigned int zone_id,
|
||
const char open_id[INFOGW_OPEN_ID_LEN],
|
||
unsigned int type,
|
||
const char *ticketBuff,
|
||
const int ticketLen,
|
||
const int time_out = 5000
|
||
) = 0;
|
||
};
|
||
|
||
/**
|
||
* @brief 创建QQ网吧插件接口
|
||
* @param hDll LoadLibrary返回的HMODULE
|
||
* @return IQQNetbarIIGWPlugin 失败返回nullptr。该接口内存由插件管理，无需外部释放
|
||
*/
|
||
inline IQQNetbarIIGWPlugin *CreateQQNetbarIIGWPlugin(HMODULE hDll){
|
||
if (!hDll) {
|
||
return nullptr;
|
||
}
|
||
|
||
typedef HRESULT (WINAPI *QUERYPLUGININTERFACE)(const char*, void**);
|
||
#ifdef _WIN64
|
||
QUERYPLUGININTERFACE qpi = (QUERYPLUGININTERFACE)GetProcAddress(hDll,
|
||
"QueryPluginInterface");
|
||
#else
|
||
QUERYPLUGININTERFACE qpi = (QUERYPLUGININTERFACE)GetProcAddress(hDll,
|
||
"_QueryPluginInterface@8");
|
||
#endif
|
||
|
||
if (qpi) {
|
||
IQQNetbarIIGWPlugin* plugin = nullptr;
|
||
HRESULT hresult = qpi("IQQNetbarIIGWPlugin", reinterpret_cast<void**>(&plugin));
|
||
if (SUCCEEDED(hresult)) {
|
||
return plugin;
|
||
}
|
||
}
|
||
|
||
return nullptr;
|
||
}
|
||
|
||
}
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif // _ITC_CLIENT_H_
|