查看“Sdk-h5-desc”的源代码

== 简介==

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

== 第一步：商户提供应用基础信息 == 
# 要使您的应用接入陌陌平台，我们需要您提供下表物料来创建您的应用
# 我们会创建2个应用，一个测试应用和一个正式应用；
<table border="1" cellpadding="1" cellspacing="0">
<tr> <td> 名称 </td><td>描述</td></tr>
<tr>
<td> 游戏icon</td>
<td> 190x190   120x120  74x74三个尺寸 ，大小在50kb以内，jpg/png图片 </td>
</tr>
<tr><td> 游戏入口地址</td>  <td> 最好是一个测试地址，一个正式地址 </td>
</tr>
<tr><td>支付回调地址</td>  <td>用于接收 [[Sdk-h5-server#.E6.94.AF.E4.BB.98.E9.80.9A.E7.9F.A5|支付通知]] </td></tr>
<tr><td> 游戏可购买道具列表</td><td>（ 陌陌方配置后提供对应道具id)</td></tr>
<tr><td> 测试陌陌号</td> <td>用于接收 <strong>游戏入口</strong> 消息推送 </td></tr>
</table>

* 注意事项
# 测试应用主要用于技术联调；二者的APPID，应用密钥，用户ID不通用，请开发者注意
# <font color="red">游戏入口地址提供给陌陌运营和技术同学用于添加域名白名单（在白名单内的域名才能调用sdk的功能），如果商户内部有 HTTP 302 跳转，请务必告知，并提供最终地址</font>

----

== 第二步：创建测试应用并配置 ==
# 我们会根据您提供的物料创建应该并配置相关功能权限
# 并且提供下表内容来进行接入
<table border="1" cellpadding="1" cellspacing="0">
<tr>
 <td>APPID</td> <td>应用标识，sdk初始化使用</td>
</tr><tr>
<td> 应用密钥  </td><td> 为保证数据安全，商户服务端调用momo接口需要进行数据签名，参考  [[Sdk-h5-server|服务器API]] </td>
</tr><tr>
<td> 道具id </td><td>  商户客户端发起支付时使用</td>
</tr><tr>
<td>支付RSA公钥</td> <td> 为保证支付数据安全，陌陌对支付回调数据进行了RSA加密，参考  [[Sdk-h5-server#.E6.94.AF.E4.BB.98.E9.80.9A.E7.9F.A5|支付通知]] </td>
</tr>
</table>
* 注意事项
** 服务端接口调用，构造请求数据并签名必须在商户服务端完成，商户的应用密钥绝对不能保存在商户 APP 客户端中，也不能从服务端下发
----

== 第三步: 集成和开发(todo) ==
* 引入陌陌js文件

     https://game.immomo.com/fep/momo/game-bj-mk/h5-sdk-v2/v-/1.x/main.js

* 按 [[Sdk-h5-client|SDK接口]] 说明进行接口调用开发

* 陌陌方通过陌陌消息推送游戏测试入口
** 位于  陌陌-> 消息 -> 订阅内容 ->  陌陌游戏室 
** 点击入口,陌陌会http 302 跳转到 游戏入口地址，并通过get参数传递相关参数
<table border="1" cellpadding="1" cellspacing="0">
<tr>
 <td>token </td> <td>用户授权token, 必传</td>
</tr><tr>
<td> sourceid  </td><td> 来源，标识用户是从陌陌的哪个地方点击进入的游戏, 用于数据统计 </td>
</tr><tr>
<td> _ui </td><td>  128  如需全屏要带上这个参数</td>
</tr><tr>
<td>extra</td> <td> 扩展信息字段 </td>
</tr>
</table>

*注意事项
** js 文件不要下载到本地使用
** 如需全屏，需要申请相关权限，测试入口里加上_ui=128 （陌陌方配置)

== 第四步：验收与上线(todo) ==
#  CP开发自测完成后，陌陌会安排qa验收
# 验收后，陌陌方会创建正式应用和配置相关权限
# 按正式应用再qa验收一遍
# 游戏上线

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