# 游戏内嵌平台页面

# 功能概述

在游戏内置的活动页面中,玩家不仅能享受游戏的乐趣,还能便捷地参与平台的各类活动,如充值、领取奖励等。

此功能的核心在于能够获取玩家游戏角色所绑定的平台UID,为后续的个性化活动推荐和精准数据统计奠定基础。

# 活动示例

当你在游戏官网的活动页面完成登录和角色绑定后,只需点击“立即开通”,即可快速拉起平台的支付界面,轻松成为会员并有机会获得珍贵的游戏道具抽取机会。

活动示例图

# 解决方案

解决方案流程图

我们通过两个核心流程来实现上述功能:

  1. 腾讯游戏与平台联接流程A:由游戏方调用,用于生成与平台UID相关联的token。
  2. 腾讯游戏与平台联接流程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
参数 类型 说明
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

** 流程二:解析token(由平台方调用)**

注意:此次流程不校验具体账号,可以使用系统账号UID加密生成的code来调用此流程。

post参数

{
    "flowId":"1b137112",
    "token":"xxx" // 此处应填入游戏方传递的有效token,即通过流程7df23b83获得的token
}
1
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

请确保按照上述流程和注意事项准确调用接口,以保证玩家能够顺利参与游戏与平台的融合活动。

lastUpdate: 4/18/2024, 2:15:28 PM