平台内嵌游戏页面

说明

本指南阐述了平台侧与腾讯游戏之间的内嵌式合作机制，详细说明了如何将平台UID等相关数据有效传递给游戏内的活动页面。

活动形式

游戏活动页面将通过内嵌（iframe）的形式，无缝集成到平台侧的活动页面中。内嵌方式的示意图如下所示：

活动说明

用户通过平台侧的活动入口参与游戏，此时平台将负责唤起游戏的活动页面。

活动开发步骤

1. 游戏侧提供对应的页面链接给到平台侧
2. 平台计算用户信息、签名等参数，并携带参数拉起游戏页面
3. 游戏侧解析参数，调用来联的相关接口，完成后续活动逻辑

平台生成拉起页面链接

以下是平台生成的活动页面链接示例，此链接需要被嵌入到平台侧的活动页面中：

# https://cf.qq.com/xxx/index.html 为游戏侧提供的活动页面，游戏侧开发完成需保证页面已上线
# 页面参数部分需要平台生成 actId=xxx&gameId=cf&livePlatId=xx&code=xxxxx&t=xxx&v=2.0&sig=xxxxx
# 最终生成链接如下：

https://cf.qq.com/xxx/index.html?actId=xxx&gameId=cf&livePlatId=xx&code=xxxxx&t=xxx&v=2.0&sig=xxxxx

参数说明

参数名称	类型	说明
code	string	登录态加密串，见文档《平台code加密》。
gameId	string	参考《已支持业务》
t	int32	Unix时间戳，精度：秒。10分钟内有效。
livePlatId	string	平台侧ID，由腾讯游戏来联统一分配。
v	string	方案迭代，这里设置为2.0。
sig	string	签名计算，可参考《流程调用sig签名生成》中的“sig签名生成步骤”部分签名完成。
actId	uint32	活动ID，腾讯游戏来联上申请活动活动自动分配。见《活动立项说明》

除了上述字段外，也支持平台和游戏约定自定义参数传入，只要按照腾讯游戏来联的签名计算即可

游戏侧调用来联接口

游戏侧拿到平台的链接参数后,可以携带该参数调用来联的相关接口完成后续活动逻辑，涉及到的主要接口如下：

PS: 请求域名为s1.livelink.qq.com; 内网地址可以咨询对应开发

查询游戏角色昵称

可以调用来联的查询接口，获取游戏角色昵称等信息用于展示，调用方式如下：

POST http://{ip:port}/livelink?a=GetBindInfo&{从平台拿到的code、sig等参数}

调用活动流程

可以调用来联的活动流程接口，完成后续的活动功能，诸如查询用户等级、发放游戏道具等。

POST http://{ip:port}/livelink?a=ApiRequest&{从平台拿到的code、sig等参数}