# 游戏内嵌平台页面
# 功能概述
在游戏内置的活动页面中,玩家不仅能享受游戏的乐趣,还能便捷地参与平台的各类活动,如充值、领取奖励等。
此功能的核心在于能够获取玩家游戏角色所绑定的平台UID,为后续的个性化活动推荐和精准数据统计奠定基础。
# 活动示例
当你在游戏官网的活动页面完成登录和角色绑定后,只需点击“立即开通”,即可快速拉起平台的支付界面,轻松成为会员并有机会获得珍贵的游戏道具抽取机会。
# 解决方案
我们通过两个核心流程来实现上述功能:
- 腾讯游戏与平台联接流程A:由游戏方调用,用于生成与平台UID相关联的token。
- 腾讯游戏与平台联接流程B:由平台方调用,通过提供的token检索到真实的平台UID。
重要提示:为确保流程的顺畅进行,用户需先完成游戏角色与平台UID的绑定。
# 请求示例
curl "https://s1.livelink.qq.com/livelink/?apiName=ApiRequest&livePlatId=egame&gameId=ty&t=1657791571&nonce=bHYyWpNb&actId=1001&v=2.0&code=0prleGC4uUiuAGdsDjgEzJa0%3D&sig=e16c73ae0018a91b25e9077f24ad3"
-d '{"flowId":"69f33ur0"}'
1
2
2
参数 | 类型 | 说明 |
---|---|---|
flowId | string | 腾讯游戏来联活动流程id |
# 注意事项
- 玩家已完成游戏角色的绑定。
- 相关活动和流程已设置且处于有效状态。
- 流程配置遵循标准化结果输出。
- 生成的token存在有效期限制,过期后将无法解析,请确保在有效期内使用。
# 流程调用示例
** 流程一:获取token(由游戏方调用)**
post参数
{"flowId":"7df23b83"}
1
返回示例
{
"iRet": 0,
"v": 2,
"apiName": "Output",
"jData": {
"v7": "eyJ0eXBlIjoiSldUIn0=.8f0f6db8711582967f05bc7ee125bab06a47feyJpc3MiOiJsaXZlbGluayIsImF1ZCI6InNodW53YGpRckZ4cURjPSJ9.250177d5ea8fbcb3f889509fe83W5nIiwiaWF0IjoxNjgwODU3UU4S2tpVUc3RXJQNW9QUjRmRC81OEJmTk8NjY1LCJuZmVra2tMT21TVVFiOWpxdYmYiOjAsImV4cCI6MTY4MD4NlJSVFlKNVNkUHEvS0MyL1Vubm1Xdg1ODI2NSwiZGF0YSI6IkdpVHhlTFVRU0tLSUFyUEFPV3BGdUpjanN1WjkxWVZhK2Ft" // token
},
"sMsg": "ok",
"tid": "169805881154737186"
}
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
** 流程二:解析token(由平台方调用)**
注意:此次流程不校验具体账号,可以使用系统账号UID加密生成的code来调用此流程。
post参数
{
"flowId":"1b137112",
"token":"xxx" // 此处应填入游戏方传递的有效token,即通过流程7df23b83获得的token
}
1
2
3
4
2
3
4
返回示例
{
"iRet": 0,
"v": 2,
"apiName": "Output",
"jData": {
"v7": "xxxyyyzzz" // 解析得到的平台UID
},
"sMsg": "ok",
"tid": "169805881154737186"
}
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
请确保按照上述流程和注意事项准确调用接口,以保证玩家能够顺利参与游戏与平台的融合活动。