接入准备

方案概述

本⽅案⽤于联运游戏运⾏于疯狂游乐场公众号之中，并通过预设的机制实现登录、分享、好友、⽀付等功能。

联运游戏前端页面运⾏在疯狂游乐场平台⼊⼝⻚⾯⾥的iframe中，通过window.HORTOR_AGENT全局对象内提供的API与⽗⻚⾯进⾏交互。

联运游戏后端通过接收平台服务器的回调来获知⽤户发⽣的购买事件。

上线素材

疯狂游乐场上线材料清单V1.06

说在前面

登录不需要游戏方前端接入，游戏方只需要构建出游戏的web工程文件，在web工程中接入agent_sdk.min.js实现相关功能后上传至固定的cdn地址，并告知平台组服务端郑赛同学进行微端相关配置即可。

登录的实现分为两种：微信或者抖音，目前除了咸鱼之王定制化接入过抖音登录，建议其他项目组先接入微信登录的微端版本，平台组app层会和平台组服务端进行通信，拿到登录信息并拼接在下面链接的url的query上进入游戏。

剩下的内容只需要 接入 分享、支付等功能。

接入配置

gameId: 运营人员提供 secret: 运营人员提供 游戏内容地址: 联运游戏提供 支付回调地址: 联运游戏提供

建议使用https协议，可以更好的避免网络劫持

平台游戏入口地址

https://wx.hortor.net/auth/login?gameId={运营人员提供的gameId}

SDK初始化

1. 游戏内容地址中引入SDK脚本文件

接入前先接入测试SDK在测试环境验证通过后，再接入正式SDK

测试环境SDK下载正式环境SDK下载

2. 初始化SDK全局仅可执⾏⼀次初始化操作，多次执⾏会造成绑定事件失效

var sdk = window.HORTOR_AGENT; // 缓存SDK构造函数
sdk.init(function (status) {
    if (status) {
      // status 为true,初始化成功
      // do something
    } else {
      // status 为false,初始化失败，查找原因，或者刷新页面重试
    }
})