联想端游联运SDK接入指南

1. 接入流程

本文档主要介绍了 联想PC游戏SDK接入流程、联想游戏提供的功能、接入注意事项等。

1.1. 接入方式

1. 联想游戏SDK2.1版本支持“账号+防沉迷+支付”接入方式；

a. 联想提供账号注册、登录等能力

b. 联想提供防沉迷服务

c. 联想提供游戏内支付

1.2. 对接流程

1. cp的游戏接入主要流程包括：

a. 联系联想运营，提供游戏和公司信息，获取cpid、游戏id、登录key（用于登录和防沉迷校验）、支付key（仅用于支付）

b. 签订合同

c. 接入联想游戏SDK

d. 提包测试、提供物料、上线运营等；

1.3. SDK下载地址

链接： https://lecloud.lenovo.com/share/37a7r4fRuzjNta1EE

提取码：ep4b

2. 接入说明

2.1. 登陆接入

2.1.1. 登录物料准备

设计图准备

CP需提供以下物料至联想游戏运营

1. 游戏背景图，尺寸350*400

2. 游戏LOGO，尺寸106*48

3. 游戏官网地址

登录原型如下：

备案号准备

CP需要向国家新闻出版署申请备案号，并且在版署防沉迷后台与联想游戏防沉迷备案信息绑定。联想游戏防沉迷备案信息:

公司名称：北京神奇工场科技有限公司

统一社会信用代码：91110108318338204D

2.1.2. 登录流程说明

a) 集成联想网游 SDK，登录取得token

b) 将获取到的 token 传递到游戏服务器

c) 通过【获取用户信息接口】验证 token的有效性，同时获取用户的唯一 ID

2.2. 支付接入

2.2.1. 支付模式说明

联想SDK支持两种支付接入，可任选其中一种进行接入，两者的区别如下：

模式一：接入支付h5

联想游戏SDK仅提供支付H5页面，CP需要将支付相关参数拼接至支付url地址后，并自行开发页面容器展示该url。

模式二：直接调起SDK

联想游戏SDK提供支付页面，CP仅需要将相关参数上传，调用联想游戏SDK。

2.2.2. 模式一接入说明

2.2.2.1. 支付流程说明

2.2.2.2. 准备页面容器

1. 联想PC游戏SDK提供游戏内支付页面，支持用户直接在游戏内支付。使用该支付页时，游戏CP需要提供：

a. 页面容器：提供526px*398px的页面容器，在游戏内拉起web页；

b. 窗口标题栏：由游戏提供，下图为建议标准样式，接入资料zip包中附带标准素材；

2.2.2.3. 拼接参数至支付页url

接口说明

cp方拉起联想支付页URL时需要携带以下参数:（所有参数都需要进行urlEncode编码）

请求参数
url	https://hd.lenovomm.com/front-wdsdk/pay/index.html
接口协议	HTTP[S] GET
请求参数	参数名	参数类型	是否必填	说明
partner	CPID	string	*是	由联想运营提供
notifyUrl	异步通知地址	string	*是	CP方提供
outTradeNo	订单号	string	否	双方对账使用，如未传订单号，会生成唯一订单号，后续对账以联想订单号为准。
appId	游戏id	int	*是	由联想运营提供(gameId)
totalFee	指定金额	int	否	最小为1元，精确到小数点后2位。不传则用户可自定义充值金额
subject	商品名称	string	*是	商品的名称，例：月卡、元宝、钻石等（需要URL编码）
account	用户账号	string	*是	用户账号，需要脱敏
extraCommonParam	透传参数json格式	json	否	cp业务透传参数
server	区服名称	string	*是	区服名称（需要URL编码）
role	角色名称	string	*是	角色名称（需要URL编码）
bizid	游戏备案号	string	*是	游戏备案号
tgt	用户登录成功时返回的TGT	string	*是	用户唯一标识
sign	使用支付参数生成的验签字符串	string	*是	参考7.1.4签名备注
sign_type	签名类型	string	*是	签名类型固定值RSA2

2.2.3. 模式二接入说明

2.2.3.1. 支付流程说明

2.2.3.2. 传参说明

cp方拉起联想SDK时需要传递以下参数:

请求参数	参数名	参数类型	是否必填	说明
notifyUrl	异步通知地址	string	*是	CP方提供
outTradeNo	订单号	string	否	双方对账使用，如未传订单号，会生成唯一订单号，后续对账以联想订单号为准。
totalFee	指定金额	int	否	最小为1元，精确到小数点后2位。不传则用户可自定义充值金额
subject	商品名称	string	*是	商品的名称，例：月卡、元宝、钻石等
extraCommonParam	透传参数json格式	json	否	cp业务透传参数
server	区服名称	string	否	区服名称
role	角色名称	string	否	角色名称

2.3. 防沉迷

2.3.1. 防沉迷流程说明

1. 联想PC游戏SDK提供防沉迷的接入能力，其中用户登陆时的实名校验、实名认证、未成年游戏限制均已包含在登陆的流程内，无需CP接入和二次开发。用户支付时的实名校验和消费限制包含在支付的流程内，无需CP接入和二次开发。

2. 但针对游戏内未成年用户时长超出国家游戏时长规定的场景，游戏SDK不提供直接踢出游戏的能力，而是提供一个【用户防沉迷接口】，可查询用户在当前时间是否可玩游戏，CP需要通过调用接口轮询用户在当前时间是否可玩游戏，若不可玩游戏，需要将用户踢出。

3. 联想端游SDK API介绍

3.1. 登陆的调用方式

1. 端游SDK以dll形式提供，名称为PCGameSDK.dll，可使用动态或静态加载方式使用该dll。ludp.dll为PCGameSDK.dll提供功能支持，并配有相关导入库和头文件PCGameSDK.lib，PCGameSdk.h。

2. PCGameSDK.dll使用说明：

a) 接口使用说明:

i. PCGameSDK.dll，ludp.dll需放在调用该dll的exe同级目录下。

ii. 调用LGSDKInit，该接口用来设置回调，用于接收SDK返回的数据。参数为LGSDKCallBack callback，其中

typedef bool(*LGSDKCallBack)(wchar_t* in_param);

接口返回说明 :

错误码	说明
true	成功
false	失败

iii. 调用LGSDKLogin，该接口用来弹出登录窗口。传入参数为json字符串，如下：

 调起登录器参数：

参数	说明
cpid	联想游戏运营分配
appid	游戏id，联想游戏运营分配
bizid	游戏备案码，CP向国家新闻出版署申请
Key	联想游戏运营分配

登陆成功后回传参数：

参数	说明
TGT	发起支付时携带，作为用户标识
Token	用户token，结合Realm查询联想用户id作为用户唯一标识
Age	用户年龄，防沉迷时携带

 接口返回说明 :

错误码	说明
0	成功
10	初始化接口未调用
20	登录窗已存在
30	参数错误

b) 接口调用时机：

CP启动时应首先调用LGSDKInit，LGSDKLogin接口，弹出登录框，登录成功以后，再走CP 后续流程。

c) 接口调用示例代码：

std::wstring strParam = 
L"{\"appid\":\"此处替换成appid\",
\"cpid\":\"此处替换成cpid\",
\"bizid\":\"此处替换成bizid\",
\"key\":\"此处替换成key \"}";
int nSize = strParam.size();
bool bRet = LGSDKInit(SDKCallBackFunAsync);
wchar_t *pwszBuffer = new wchar_t[nSize + 1];
ZeroMemory(pwszBuffer, nSize + 1);
tcscpy_s(pwszBuffer, nSize + 1, strParam.c_str());
int statusCode = LGSDKLogin(pwszBuffer);
delete[] pwszBuffer;
pwszBuffer = nullptr;
return 0;

其中回调函数可以接收到SDK返回的数据，数据格式为json。

bool CTest::SDKCallBackFunAsync(wchar_t* in_param)
{
 if (in_param == nullptr)
  return false;
 ::MessageBox(NULL, in_param, L"提示信息", MB_OK);
 return true;
}

3.2. 支付的调用方式

1.支付接口定义：

extern "C"  PCGAME_SDK_API int LGSDKPay(wchar_t* in_param);

入参：json格式 具体key值定义结构参考 2.2.3.2

返回说明：0- 成功 ， 30-参数错误

2使用说明：用户登录成功后才能调用该接口  

3接口调用示例:

std::wstring strPayContent = L"{\"notifyUrl\":\"https://api.game.com\",  \
\"subject\" : \"1元礼包",\"totalFee\" : 1}";
int nRet = LGSDKPay((wchar_t*)strPayContent.c_str());                              

4. 服务端API介绍

4.1. 服务端获取用户信息接口

1. 请求地址https://auth.lenovomm.com/game-ms-id-auth-core/api/a ccount/identify

2. 请求类型:POST

3. Content-type: application/json

4. 参数（json字符串）

名称	字段	是否必填	说明
标识	realm	Y	固定值，传pcgame.lenovomm.com
token	lpsust	Y
当前时间戳毫秒值	timestamp	Y
随机字符串	nonce	Y
游戏id	appId	Y
签名	sign	Y	请看7.1.4签名备注
签名类型	sign_type	Y	默认值RSA2

5. 返回值格式

{

 "code": 10000,    //10000表示正常，非10000表示业务异常

 "data": {},    //返回的数据

 "message": "string"  //错误提示信息

}

6. http状态码：

200-成功

400-缺少参数

401-签名错误

500-业务异常

4.2. 服务端支付通知接口

接口说明

用于通知用户支付状态。

请求参数

url	游戏方接收支付通知URL （即下单时传递的notifyUrl参数）
接口协议	HTTP[S] （POST）
请求参数	参数名	参数类型	是否必填	说明
sign	签名	string	*是	支付通知回调签名，参加下方签名规则
outTradeNo	商户网站唯一订单号	string	*是	商户系统内部订单号，同一商户下唯一
subject	商品名称	string	*是	商品的名称，例：月卡、元宝、钻石等
body	商品描述	string	否	对一笔交易的具体描述信息
tradeNo	支付宝、微信交易号	string	否	该交易在支付宝、微信系统中的交易流水号
tradeStatus	交易状态	string	否	支付状态，TRADE_SUCCESS ——交易成功，其他值为失败状态
totalFee	交易金额	number	否	该笔订单的资金总额，单位为元，精确到小数点后两位。
extraCommonParam	公用回传参数	string	*是	用于商户回传参数，该值不能包含“=”、“&”等特殊字符。如果用户请求时传递了该参数，则支付通知接口会回传该参数。

通知接口返回

1.  HTTP状态码为200，表明调用成功。其他状态为失败。

2.  接口返回“success”，则代表交易成功，返回其他值则代表通知失败。

3.  针对通知失败的订单，会定时发起重试请求。

支付签名规则

1.  参数排序

所有请求参数剔除sign以及值为空的参数，按照参数字母升序排

2．参数拼接

将排序后的参数与其对应值，按照参数=参数值的格式，并用“&”字符将其拼接成串，在最后追加上支付key。

3. 对拼接后字符串做MD5并转小写。

4. 支付key

支付接口中所用的key与登录接口的key不同，请注意区分

支付签名示例

支付key ：2ppfQCHMWid1

明文字符串：outTradeNo=465215151893&partner=208810156864&subject=game &totalFee=102ppfQCHMWid1

加密字符串：1bbdebc58f85e8b6f83797109ce76d89

4.3. 服务端用户防沉迷接口

调用方法：

1. 请求路径https://vb.lenovomm.com/game-ms-user-identify-core/api/underagegamepreventaddiction

2. 请求类型:POST

3. Content-type: application/json

4. Header参数

名称	字段	是否必填	说明
标识	realm	Y	固定值，传pcgame.lenovomm.com（不参与签名）
lpsust	token	Y	（不参与签名）

5. body参数（json字符串）

名称	字段	是否必填	说明
当前时间戳毫秒值	timestamp	Y
随机字符串	nonce	Y
游戏id	appId	Y
签名	sign	Y	请看7.1.4备注
签名类型	sign_type	Y	默认值RSA2
年龄	age	Y

6. 返回值格式

{

 "code": 10000, //10000表示正常，非10000表示业务异常

 "data": {

   "preventAddictionMsg": "限制登录提示信息",

   "preventAddictionType": 1-不限制登录，2限制登录

 },

 "message": "Success"

}

7. http状态码：

200-成功

400-缺少参数

401-签名错误

500-业务异常

5. SDK版本更新日志

5.1. V2.1.0内容变更

变更项	接入说明
1、登录页置顶展示，且满足登录窗口拖动	游戏登录页置顶在windows页面最顶层
2、获取用户信息接口新增返回年龄	返回参数新增年龄字段
3、收银台支付封装，可直接调起联想SDK完成支付流程	V2.1.0新增内容，V2.0.0可满足支付的情况下，无需更新

6. 接入注意事项

登录key和支付key不同，请区分使用

7. 其他说明

7.1. 安装包提供

1. 安装包需要同时提供2种形式：

a. 整包：需要将所需资源全部打包到一个安装程序中，安装过程无需下载额外资源；

b. 下载器：提供游戏下载器，安装时通过下载器下载游戏资源；

7.2. 游戏的更新

1. 更新资源小于1G的版本更新在游戏内完成，无需向联想游戏提供游戏更新包；

2. 更新资源大于1G的版本更新时，除游戏内更新外，还需要重新向联想游戏提供安装包，并提供版本更新说明；

3. 下载器如有更新，需要重新提供安装包；

7.3. 游戏数据

1. 游戏方需要提供游戏数据，包含：游戏安装完成数、游戏激活数、游戏卸载数、用户游戏局数分布、用户购买道具信息分布；

2. 建议以后台形式提供；

7.4. 签名备注

开发者需要自行实现签名，签名过程如下：

1.筛选并排序

获取所有请求参数，不包括字节类型参数，如文件，字节流，不包括请求路径中占位符的值，剔除sign字段，剔除值为空的参数，并按照第一个字符的键值ASCII码递增排序（字母升序排序），如果遇到相同字符则按照第二个字符的键值ASCII码递增排序，以此类推。

2.拼接

将排序后的参数与其对应值，组合成“参数=参数值”的格式，并且把这些参数用&字符连接起来，此时生成的字符串为待签名字符串。

3.签名

使用各自语言对应的SHA256WithRSA(对应sign_type为RSA2)或SHA1WithRSA(对应sign_type为RSA)签名函数利用开发者私钥对待签名字符串进行签名，并进行Base64编码。

4.拼接参数

将生成的签名赋值给sign参数，拼接到请求参数中，再将每个参数做urlencode(utf-8编码)后发起请求即可。 注： 请求类型为:application/x-www-form-urlencoded才需要编码，application/json 不用编码

示例：

一、签名准备

1. 原始内容： 【classifyCode=PC&v=&sign_type=RSA2&appId=20201028】

2. 签名私钥： 【MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQClcxcmpvWF8l0rjHtqmqCGXnzqnADYh3yirMlOVW+F8A+BboJfrOiyddwjLnNhwa02bSLu8jKdJ5QDLTKLvgQdQsEQviO9h22nu6ouFEfBT4rbxlc83B3vT1FZaT00DAHlATKDCARbjrQ0EEr57bkWX2SSKFEEOBCA06KwituJk/fGi6oNAD+e/KMxfPgdjzM2fwul2YxV1zHCSc/Xc7EBjjY/0tk/+/TehIBoE0zEpyzUXLVKt71i8qw0ygiRFO1Q3NTKT+Ht4ouK34827QvMpTQ/I0MGbdAtjZDLY6SNi1EoHp3X9xdr1kvP8XAggTiHG5lmL3EK62vTcbsA9KjzAgMBAAECggEBAJCNNH3tw3frICILVEz4miWr6kHkWQzVmzxZ8GvDU3PXIQT5s2i6HnjFZrdKPz76w0ZZJftUmooZ6US5OX9EXj3ec+YX6gwOhezVlsM5rtOjlnOcH94phvHt/+o5e2K81u7pE+PNnlkMHj+auJcSbvKwF6NnHBmujiSwQ2UxfMv+lwaazrTu/FFPFCMGtYkxeqC9Iwe9qJAQURCgE4lgzMuM2rUZqAPhZ298+c/lbovNWtV9tGb8jdiKprpUDuvYnJ4JHkUq5+V7WCtESzBUZVrXv0wkie2RJkN/OsirtwYFk+0MjX1sH4ciJFhY9atPfD1dZYBhhZezAQQuOU4ja1kCgYEA0Ia0Zo9z1GnWQbSyrdYwj9CgSm/fiZSU1nhVqmMJp3GWb9R42nMRcNk9Op4spreENCK1r55BZzmCMs4KIj9oiJz0ckczUgWoRHFUDwd5qWoMdCWlnJuQeFabd6bPxZRmXShIhIy1NQbk2lzIq4bpWKgEQ2TKSDaQ8S2JZj3q890CgYEAyx3M0pndOrpqyKYaJIJKsb+jX4NUSmFTzlWtASGKNG2MQeWwAHKkWi2GEv2g2w/XijNUL4FCkGwCT0o4v1HXRrs5LWRXislFHMDHAIdwrSWM5bouPesXDe67tC5hTmu8UhGsUfemB086uUgkqwZv23x0m9ZvHcfogN3FQS6faw8CgYBl6qB7S/uhwsSsQoPeAMSlVaMyHnGTzaHdHN1JtLQAObz8FU2n/vt0O0j4wFw0c5dS3/AK0H9I00u2Rwue53zQ4F19CR2lJgyyvu0Fl3K4AZPqpIfH/iRjHHlJxqbf+4L4Xvrqhdb+/sqViyms4/hik2PaCIXxO3Il3kq8RODzpQKBgQDCizlqIcs+e9zZcBasD0thsm7VheFPGKd/gpog8jIAg0iKuWd5FlUKtn2rZNgT2bmVehJRKdpKn9kafrmZrdamvZ5HNsuOd7bFknNIs3EdtlCcnFW8IpbDVnzcWGwFA7WtWZYWMEAK0j0px8qvMIwkyrCZrqpg+N9dxowvIWu5ywKBgGbULkj4HIuMOhCb68R1OLf2n8VloeuTnX0mHJWqvN2pFt2K8lm2ZWX4GpC09QZXw/1C0VM1syKsNbUe/2sprF0FYzbRrdvPk2yjvJbus5XhnPL5CW9zOUyu+KIHwsOOAVoNn37j3sZnQ3unS+it4Mpno+LbblCffGO/Czg68BX2】

二、生成待签名字符串：

1. 剔除参数名(和参数值)前后的空格： (正常业务下，参数值前后不应含有空格) 【classifyCode=PC&v=&sign_type=RSA2&appId=20201028】 删除空字段【v】

2. 剔除空值参数： 【classifyCode=PC&sign_type=RSA2&appId=20201028】

3. 排序： 【appId=20201028&classifyCode=PC&sign_type=RSA2】

三、生成签名： 【DZw/dCtCgRkvszdCRKekzKDe2m+J8pZxh4eCk1DNOXE7SKq4TE6pm/z7N49LaSauEpXyX4MJR5VZSRUeu8avO3K4ma6MGcDMKg2lWD7MLwoA9O0Q7QXVlY04ytwlXw9GVya8oL+Dyka0CspTSPJUZtKf5oJRK03XMRyWJw6+ERJuMb2HptgknNPYhsm7B2SqCyDRaVUa69h9NxIxhm17ora3RNbSkThnbkaFtxAXSol7GGWHHng23uekv8MJSalwFSZS4tuPhc4EMIAigC57+pdntgGlzmHj9AfnQ1FODV9bk0cJYDaK7eYUxUZx2T/OfKtzawKoM+qLHTw27fB/1g==】

7.5. SDK兼容性说明

SDK仅支持Win10以上操作系统

原文地址：https://open.lenovomm.com/developer/doc?id=1689213143070081026

联想开放平台地址：联想开放平台

联想开发者专属QQ客服（工作日9：30-18：00）：联想开发平台首页右侧悬浮的在线客服聊天入口可直接会话，无需添加好友。也可搜索官方客服QQ号2881414004。

联想应用商店微信公众号：

​