游戏数据-1.0.0-确认版本
<table>
<thead>
<tr>
<th>日期</th>
<th>修改内容</th>
<th>姓名</th>
</tr>
</thead>
<tbody>
<tr>
<td>2019.08.29</td>
<td>更新文档</td>
<td>秦露</td>
</tr>
</tbody>
</table>
<p>[TOC]</p>
<h2>1 需要提供的参数</h2>
<h3>1.1 URL上需要携带参数</h3>
<p><em>这里需要由游戏方在URL上拼接对应的参数</em></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数</th>
<th style="text-align: left;">说明</th>
<th>类型</th>
<th>是否可为空</th>
<th>提供者</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">UserID</td>
<td style="text-align: left;">用户id，具体见特殊说明</td>
<td>number</td>
<td>否</td>
<td>游戏方-彭士勇</td>
</tr>
<tr>
<td style="text-align: left;">LoginName</td>
<td style="text-align: left;">登录名</td>
<td>string</td>
<td>否</td>
<td>游戏方-彭士勇</td>
</tr>
<tr>
<td style="text-align: left;">UserName</td>
<td style="text-align: left;">用户昵称</td>
<td>string</td>
<td>否</td>
<td>游戏方-彭士勇</td>
</tr>
<tr>
<td style="text-align: left;">IsVip</td>
<td style="text-align: left;">是否为VIP会员或高级用户</td>
<td>boolean</td>
<td>否</td>
<td>游戏方-彭士勇</td>
</tr>
<tr>
<td style="text-align: left;">IsExtreme</td>
<td style="text-align: left;">是否为至尊用户</td>
<td>boolean</td>
<td>否</td>
<td>游戏方-彭士勇</td>
</tr>
<tr>
<td style="text-align: left;">AK</td>
<td style="text-align: left;">accesstoken，具体见特殊说明</td>
<td>string</td>
<td>是</td>
<td>游戏方-彭士勇</td>
</tr>
<tr>
<td style="text-align: left;">OS</td>
<td style="text-align: left;">操作系统：1 安卓，2 苹果</td>
<td>number</td>
<td>否</td>
<td>游戏方-彭士勇</td>
</tr>
<tr>
<td style="text-align: left;">PkgID</td>
<td style="text-align: left;">包ID<br/> 1：平台包游戏；<br/> 2：合集包游戏；<br/> 3：单包游戏；</td>
<td>number</td>
<td>否</td>
<td>游戏方-彭士勇</td>
</tr>
<tr>
<td style="text-align: left;">SourceChannelID</td>
<td style="text-align: left;">来源渠道ID <br/>对应到产品文档就是渠道号，全都上报平台/合集的渠道id</td>
<td>number</td>
<td>否</td>
<td>引擎方-廖前福（config文件）</td>
</tr>
<tr>
<td style="text-align: left;">SourceAppID</td>
<td style="text-align: left;">来源应用ID<br/>全都上报游戏本身的应用ID</td>
<td>number</td>
<td>否</td>
<td>游戏方-彭士勇</td>
</tr>
<tr>
<td style="text-align: left;">SourceAppVersion</td>
<td style="text-align: left;">来源应用版本</td>
<td>string</td>
<td>否</td>
<td>游戏方-彭士勇</td>
</tr>
<tr>
<td style="text-align: left;">IsCanUploadImg</td>
<td style="text-align: left;">是否支持上传图片</td>
<td>boolean</td>
<td>否</td>
<td>游戏方-彭士勇</td>
</tr>
<tr>
<td style="text-align: left;">AppName</td>
<td style="text-align: left;">应用名称</td>
<td>string</td>
<td>否</td>
<td>游戏方-彭士勇</td>
</tr>
<tr>
<td style="text-align: left;">AppCode</td>
<td style="text-align: left;">应用缩写</td>
<td>string</td>
<td>否</td>
<td>游戏方-彭士勇</td>
</tr>
<tr>
<td style="text-align: left;">HardInfo</td>
<td style="text-align: left;">硬件信息，具体见特殊说明</td>
<td>string</td>
<td>否</td>
<td>游戏方-彭士勇</td>
</tr>
<tr>
<td style="text-align: left;">QQNumber</td>
<td style="text-align: left;">qq号</td>
<td>string</td>
<td>否</td>
<td>游戏方-彭士勇</td>
</tr>
<tr>
<td style="text-align: left;">MobilePhone</td>
<td style="text-align: left;">手机号</td>
<td>string</td>
<td>否</td>
<td>游戏方-彭士勇</td>
</tr>
<tr>
<td style="text-align: left;">MobileBrand</td>
<td style="text-align: left;">手机品牌，如vivo</td>
<td>string</td>
<td>否</td>
<td>客户端-陈德辉</td>
</tr>
<tr>
<td style="text-align: left;">MobileModel</td>
<td style="text-align: left;">手机型号，如vivo NEX A</td>
<td>string</td>
<td>否</td>
<td>客户端-陈德辉</td>
</tr>
<tr>
<td style="text-align: left;">MobileOS</td>
<td style="text-align: left;">手机系统，如Android</td>
<td>string</td>
<td>否</td>
<td>客户端-陈德辉</td>
</tr>
<tr>
<td style="text-align: left;">OSVersion</td>
<td style="text-align: left;">手机系统版本</td>
<td>string</td>
<td>否</td>
<td>客户端-陈德辉</td>
</tr>
<tr>
<td style="text-align: left;">ext</td>
<td style="text-align: left;">&ext=（以ext这个参数为结尾符</td>
<td></td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<p><strong>特别说明：</strong>
（1）如果用户未登录，则UserID=0和AK为空。
（3）如果含有中文或者特殊字符，需要进行编码。
（4）HardInfo 硬件信息：</p>
<pre><code class="language-js">HardInfo = '{"WifiID":"929eb13560c5a243","SystemID":"929eb13560c5a243","ImeiID":"866013035683354","ImsiID":"460017036623469","SimSerialNo":"89860117836057518258"}'</code></pre>
<p><strong>参考示例：</strong>
<a href="http://mboard.tcy365.org:1507/m/index.html?UserID=1&LoginName=%e4%bd%a0%e7%8c%9c&UserName=luuck&IsVip=true&IsExtreme=true&AK=ajdjsh&OS=1&PkgID=1&SourceChannelID=1&SourceAppID=1&SourceAppVersion=2019092&IsCanUploadImg=true&AppName=%e5%90%8c%e5%9f%8e%e6%b8%b8&AppCode=tcy&HardInfo='{"WifiID":"929eb13560c5a243","SystemID":"929eb13560c5a243","ImeiID":"866013035683354","ImsiID":"460017036623469","SimSerialNo":"89860117836057518258"}'&QQNumber=1&MobilePhone=1&MobileBrand=vivo&MobileModel=vivonex&MobileOS=&OSVersion=&ext">http://mboard.tcy365.org:1507/m/index.html?UserID=1&LoginName=%e4%bd%a0%e7%8c%9c&UserName=luuck&IsVip=true&IsExtreme=true&AK=ajdjsh&OS=1&PkgID=1&SourceChannelID=1&SourceAppID=1&SourceAppVersion=2019092&IsCanUploadImg=true&AppName=%e5%90%8c%e5%9f%8e%e6%b8%b8&AppCode=tcy&HardInfo='{"WifiID":"929eb13560c5a243","SystemID":"929eb13560c5a243","ImeiID":"866013035683354","ImsiID":"460017036623469","SimSerialNo":"89860117836057518258"}'&QQNumber=1&MobilePhone=1&MobileBrand=vivo&MobileModel=vivonex&MobileOS=&OSVersion=&ext</a></p>
<p><br/><br/></p>
<h2>2 与游戏方对接的内容</h2>
<h3>2.1 JS可以调用的接口</h3>
<p>接口：exit
描述：H5游戏退出
用法：lua://exit
<br/></p>
<p>接口：refresh
描述：H5游戏刷新
用法：lua://refresh
<br/></p>
<p>接口：uploadImg
描述：打开相册上传图片
用法：lua://uploadImg
<br/></p>
<h3>2.2 JS需要实现的接口</h3>
<p>接口：onPauseCallback()
描述：通知JS切到后台
<br/></p>
<p>接口：onResumeCallback()
描述：通知JS切到前台
<br/></p>
<p>接口：onLuaShowImg (r)
描述：上传图片后得到图片的路径，r为一个JSON字符串对象</p>
<pre><code>function onLuaShowImg (r){
var res = JSON.parse(r); // !!!需要解析为JSON对象
console.log(res);
}</code></pre>
<pre><code> res对应的参数的说明：Code=1上传成功、Code=2上传失败</code></pre>
<pre><code>// Code: 1上传成功；
var res = {
Code: 1,
Data: {
ImgUrl: '''' // ImgUrl为图片地址
},
Msg: ''''
};</code></pre>
<pre><code>// Code: 2上传失败；
var res = {
Code: 2,
Data: null,
Msg: ''''
};</code></pre>
<p><br/><br/></p>