跳到主要内容

leiting.sdk

简介​

组件接口​

类​

LtAntiAddictionLoginRequest​

继承自 LtRequest

登录上报请求

成员变量​

变量名类型初始值须初始化描述
gamestringnil可选游戏标识 - Y
idCardstringnil可选身份唯一标识（SDK服务端登录验证接口返回）- Y
ageintnil可选年龄（SDK服务端登录验证接口返回）- Y
roleIdstringnil可选游戏角色Id(暂不支持角色ID包含“~”字符，如包含此字符需反馈给平台)，如果游戏没有角色则传userId，否则通知下线时游戏不知道要踢哪个账号下线 - Y
notifyUrlstringnil可选通知下线地址 - Y
serverIdstringnil可选区组(暂不支持区组包含“~”字符，如包含此字符需反馈给平台) - N
companystringnil可选运营公司主体 - N
leiting：雷霆（默认）
jys：吉游社
demo：DEMO SDK
m66：M66 必传

成员方法​

函数原型函数作用
string get_url(string host)获取请求地址
string gen_sign_text(string key)生成待签名文本
LtResult new_result()生成请求结果的实例

LtAntiAddictionLoginResult​

继承自 LtResult

登录上报结果

成员变量​

变量名类型初始值须初始化描述

成员方法​

函数原型函数作用
bool is_holiday()是不是节假日

LtAntiAddictionLogoutRequest​

继承自 LtRequest

登出上报请求

成员变量​

变量名类型初始值须初始化描述
gamestringnil可选游戏标识 - Y
idCardstringnil可选身份唯一标识（SDK服务端登录验证接口返回）- Y
roleIdstringnil可选角色ID(必填，否则不知道登出哪个角色) - Y
serverIdstringnil可选区组(登录上报有传，登出必须传，否则不会踢下线) - N
companystringnil可选运营公司主体 - N
leiting：雷霆（默认）
jys：吉游社
demo：DEMO SDK
m66：M66 必传

成员方法​

函数原型函数作用
string get_url(string host)获取请求地址
string gen_sign_text(string key)生成待签名文本

LtAntiAddictionLogoutNotify​

继承自 LtNotify

防沉迷登出通知

成员变量​

变量名类型初始值须初始化描述
gamestringnil可选游戏标识 - Y
roleIdstringnil可选角色Id(登录上报时传入)- Y
ageintnil可选年龄 - Y
onlineTimeintnil可选在线时长（单位：秒）- Y
timeStampintnil可选当前时间戳（单位：秒）- Y
isHolidayintnil可选是否节假日 - Y
1：节假日
2：非节假日
typeintnil可选踢下线类型 - Y
1：达到在线时长上限
2：限制时间段不允许体验游戏
3：客服踢下线
serverIdstringnil可选区组（是否有值取决于登录上报是否有传值） - N

成员方法​

函数原型函数作用
string gen_sign_text(string key)生成待签名文本
bool is_holiday()是不是节假日
bool is_kicked_off_by_online_time()是不是达到在线时长上限被踢下线
bool is_kicked_off_by_game_time()是不是限制时间段不允许体验游戏被踢下线
bool is_kicked_off_by_gm()是不是被客服踢下线
LtResult new_result()生成处理下线通知的结果实例

LtAntiAddictionLogoutNotifyResult​

继承自 LtResult

处理下线通知的结果

成员变量​

变量名类型初始值须初始化描述

成员方法​

函数原型函数作用
void succeed()设置处理下线通知的结果为成功
void fail()设置处理下线通知的结果为失败
void fail_by_server_busy()设置处理下线通知的结果为服务器繁忙导致失败
void fail_by_missing_param()设置处理下线通知的结果为缺少参数导致失败
void fail_by_bad_param()设置处理下线通知的结果为参数错误导致失败
void fail_by_sign()设置处理下线通知的结果为签名错误导致失败
void fail_by_config_error()设置处理下线通知的结果为配置错误导致失败

LtLoginAuthRequest​

继承自 LtRequest

登录验证请求

成员变量​

变量名类型初始值须初始化描述
userIdstringnil可选手游账号ID - Y
gamestringnil可选游戏标识 - Y
channelNostringnil可选渠道编号 - Y
tokenstringnil可选登录凭证 - Y

成员方法​

函数原型函数作用
string get_url(string host)获取请求地址
LtResult new_result()创建请求结果的实例

LtLoginAuthResult​

继承自 LtResult

登录验证结果

成员变量​

变量名类型初始值须初始化描述

成员方法​

函数原型函数作用
string get_id_card()获取身份证
int get_age()获取年龄
string get_birthday()获取生日
bool is_adult()是不是成年人
bool is_minor()是不是未成年人
bool is_unreal_name()是不是未实名认证

LtPayOrderNotify​

继承自 LtNotify

由雷霆充值平台推送给游戏服务器的充值通知

成员变量​

变量名类型初始值须初始化描述
gameOrderNostringnil可选游戏订单号，游戏需要将此字段与游戏订单中的订单号做校验，否则会被盗刷！！！ - Y
thirdNostringnil可选第三方订单号（iOS渠道为雷霆订单号） - Y
moneyintnil可选第三方返回金额（分），游戏需要将此字段与游戏订单中的金额做校验，否则会被盗刷！！！ - Y
currencystringnil可选币种 - Y
productIdstringnil可选游戏拉起充值时传入的商品id，游戏需要将此字段与游戏订单中的商品id做校验，否则会被盗刷！！！！！ - Y
channelNostringnil可选渠道编号，游戏需要将此字段与游戏订单中的渠道编号做校验，否则会被盗刷！！！
userIdstringnil可选手游账号ID，游戏需要将此字段与游戏订单中的userId做校验，否则会被盗刷！！！！！ - Y

成员方法​

函数原型函数作用
string gen_sign_text(string key)生成待签名文本
LtResult gen_sign_mismatch_result()生成签名不匹配的结果实例

LtPayReportOrderExceptionRequest​

继承自 LtRequest

订单异常上报请求

成员变量​

变量名类型初始值须初始化描述
gamestringnil可选游戏标识 - Y
channelNostringnil可选渠道编号 - Y
gameOrderNostringnil可选游戏订单号 - Y
statusintnil可选状态码 - Y
9：订单金额不一致
12：productId校验失败
14：userId不一致
97：channelNo不一致
98：白名单异常
99：其他情况
ipstringnil可选ip白名单校验失败（status=98）时，需要把异常ip传过来 - N

成员方法​

函数原型函数作用
string get_url(string host)获取请求地址
bool check_integrity()检查请求的完整性
string gen_sign_text(string key)生成待签名文本

LtPayAppleRefundNotify​

继承自 LtNotify

苹果ios退款通知

成员变量​

变量名类型初始值须初始化描述
gameOrderNostringnil可选游戏订单号 - Y
leitingNostringnil可选雷霆订单号
moneyintnil可选金额（分） - Y
channelNostringnil可选渠道编号 - Y
userIdstringnil可选手游账号ID - Y
serverIdstringnil可选游戏区组,游戏下单时传递 - Y
roleIdstringnil可选角色id - Y
productIdstringnil可选游戏拉起充值时传入的商品id
thirdNostringnil可选苹果订单号 - Y
purchaseDatestringnil可选购买时间(yyyy-MM-dd HH:mm:ss) - Y
refundDatestringnil可选退款时间(yyyy-MM-dd HH:mm:ss)

成员方法​

函数原型函数作用
string gen_sign_text(string key)生成待签名文本

样例​

public void pkg_sample()
{
    // 将一个通知推送转为class map实例
    map m = {
        "money": 23,
        "channelNo": "210009",
        "gameOrderNo": "489486494+9712",
        "leitingNo": "2020022323204070939969348",
        "productId": "com.leiting.p1",
        "purchaseDate": "2020-07-06 10:49:23",
        "refundDate": "2020-08-27 14:44:03",
        "sign": "fb0e96157b80687845b97308a2e0a176",
        "status": 1,
        "tid": "280000636623106",
        "userId": "yz8r03ga",
        "serverName":"12"
    };
    LtPayAppleRefundNotify msg = LtPayAppleRefundNotify.new_by_map(m);
    printf("[%s]-> msg(%M) is ok: %M\n", __FUN__, msg, msg.check_sign_by_key("96f9f062bdf106b3"));

    // 构造并发送一个防沉迷登出请求
    LtAntiAddictionLogoutRequest req = LtAntiAddictionLogoutRequest.new();
    req.game = "game";
    req.idCard = "idCard";
    req.roleId = "roleId";
    req.serverId = "serverId";
    req.company = "leiting";
    req.sign_by_key("key");
    LtResult result = req.request("https://testgameproxy.leiting.com");
    printf("[%s]-> req=%O,result=%O\n", __FUN__, req, result);
}