本文主要是介绍联想端游联运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。
联想应用商店微信公众号：
这篇关于联想端游联运SDK接入指南的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
