Sdk-h5-desc

来自陌陌游戏WIKI
Zhang.li讨论 | 贡献2020年6月30日 (二) 06:47的版本 简介

(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳转至: 导航搜索

简介

  • H5SDK是外部域名的H5游戏接入陌陌账号体系、使用陌陌客户端浏览器相关功能的开发包。
  • 提供 登录,支付,分享,消息盒子, 广告视频, 日志打点, 附近玩家/附近人,好友列表等功能

第一步:商户提供应用基础信息

  1. 要使您的应用接入陌陌平台,我们需要您提供下表物料来创建您的应用
  2. 我们会创建2个应用,一个测试应用和一个正式应用;
名称 描述
游戏icon 190x190 120x120 74x74三个尺寸 ,大小在50kb以内,jpg/png图片
游戏入口地址 最好是一个测试地址,一个正式地址
支付回调地址 用于接收 支付通知
游戏可购买道具列表( 陌陌方配置后提供对应道具id)
测试陌陌号 用于接收 游戏入口 消息推送
  • 注意事项
  1. 测试应用主要用于技术联调;二者的APPID,应用密钥,用户ID不通用,请开发者注意
  2. 游戏入口地址提供给陌陌运营和技术同学用于添加域名白名单(在白名单内的域名才能调用sdk的功能),如果商户内部有 HTTP 302 跳转,请务必告知,并提供最终地址

第二步:创建测试应用并配置

  1. 我们会根据您提供的物料创建应该并配置相关功能权限
  2. 并且提供下表内容来进行接入
APPID 应用标识,sdk初始化使用
应用密钥 为保证数据安全,商户服务端调用momo接口需要进行数据签名,参考 服务器API
道具id 商户客户端发起支付时使用
支付RSA公钥 为保证支付数据安全,陌陌对支付回调数据进行了RSA加密,参考 支付通知
  • 注意事项
    • 服务端接口调用,构造请求数据并签名必须在商户服务端完成,商户的应用密钥绝对不能保存在商户 APP 客户端中,也不能从服务端下发

第三步: 集成和开发(todo)

  • 引入陌陌js文件
    https://game.immomo.com/fep/momo/game-bj-mk/h5-sdk-v2/v-/1.x/main.js
  • SDK接口 说明进行接口调用开发
  • 陌陌方通过陌陌消息推送游戏测试入口
    • 位于 陌陌-> 消息 -> 订阅内容 -> 陌陌游戏室
    • 点击入口,陌陌会http 302 跳转到 游戏入口地址,并通过get参数传递相关参数
token 用户授权token, 必传
sourceid 来源,标识用户是从陌陌的哪个地方点击进入的游戏, 用于数据统计
_ui 128 如需全屏要带上这个参数
extra 扩展信息字段
  • 注意事项
    • js 文件不要下载到本地使用
    • 如需全屏,需要申请相关权限,测试入口里加上_ui=128 (陌陌方配置)

第四步:验收与上线(todo)

  1. CP开发自测完成后,陌陌会安排qa验收
  2. 验收后,陌陌方会创建正式应用和配置相关权限
  3. 按正式应用再qa验收一遍
  4. 游戏上线

验收项

 1.游戏切后台后声音停止、webgl停止绘制、请求停止发送
 2.游戏切前台后生硬播放、webgl绘制、请求发送