h5sdk对接文档
<p>[toc]</p>
<h2>1. 接入准备</h2>
<h3>1.1 我方提供</h3>
<p>游戏唯一标识 game_id,登录秘钥,支付密钥(用于支付回调验证)
> 接口文件:<a href="https://files.ddtxgame.com/h5sdk/sgh5sdk-v1.1.js">https://files.ddtxgame.com/h5sdk/sgh5sdk-v1.1.js</a></p>
<h3>1.2 研发提供</h3>
<p>游戏地址,支付回调地址</p>
<h2>2. h5sdk接口</h2>
<h3>2.1 登录</h3>
<ul>
<li>调用时机:登录账号后</li>
<li>调用方法:</li>
</ul>
<pre><code class="language-js">obj = {
'game_id' : 1,//我方提供的游戏唯一标识game_id
'callFunc' : function(data){},//登录后回调方法
};
SgGameH5SDK.getLoginInfo(obj);</code></pre>
<ul>
<li>登录后回调方法数据</li>
</ul>
<pre><code class="language-js">data = {
'uid':1,//我方用户id
'user_name':'',//我方用户账号
'token':'',//登录认证token
'third_uid':'',//第三方渠道用户id
};</code></pre>
<h3>2.2 充值下单</h3>
<ul>
<li>调用时机:玩家触发购买物品</li>
<li>调用方法:</li>
</ul>
<pre><code class="language-js">obj = {
'game_id' : 1, //我方游戏ID
'uid' : 1, //我方用户ID
'server_id' : 1, //游戏服ID
'server_name' : '', //游戏服名
'role_id' : 1, //游戏角色ID
'role_name' : '', //游戏角色名
'money' : 1.00, //充值金额(元)
'product_id' : '', //商品ID
'product_name' : '', //商品名称
'product_desc' : '', //商品描述
'vip' : 0, //vip等级
'role_level' : 1, //游戏角色等级
'ext': '', //其他信息
};
SgGameH5SDK.pay(obj);</code></pre>
<h3>2.3 角色信息上报</h3>
<ul>
<li>调用时机:1选择服务器2创建角色3进入游戏4等级提升5退出游戏6扩展事件</li>
<li>调用方法:</li>
</ul>
<pre><code class="language-js">obj = {
'data_type' : 1, //1选择服务器2创建角色3进入游戏4等级提升5退出游戏6扩展事件
'uid' : 1, //我方用户ID
'server_id' : 1, //游戏服ID
'server_name' : '', //游戏服名
'role_id' : 1, //游戏角色ID
'role_name' : '', //游戏角色名
'money_num' : 1, //角色背包金币
'vip' : 0, //vip等级
'role_level' : 1, //游戏角色等级
'role_power' : 0, //游戏角色战力值
'role_create' : 0, //角色创角时间(秒)
'red_extension' : {}, //扩展事件参数
'sign' : '', //签名(非必须),加密方法如下
};
SgGameH5SDK.roleinfo(obj);
//签名加密方法,建议服务端进行加密再由客户端进行上报,其中+为连接符,login_key为登录密钥
sign = md5(data_type+uid+server_id+role_id+vip+role_level+role_power+login_key);</code></pre>
<p>> 注意:data_type=6的扩展事件和扩展参数一般用于运营红包活动功能,如需使用则由我方进行定义再对接</p>
<h3>2.4 登出</h3>
<ul>
<li>调用时机: 退出游戏</li>
<li>调用方法:</li>
</ul>
<pre><code class="language-js">SgGameH5SDK.out_login();</code></pre>
<h3>2.5 红包活动开关(非必接)</h3>
<ul>
<li>调用时机: 进入游戏时,对角色条件进行判断,具体判断条件由我方定义,研发传值</li>
<li>调用方法:</li>
</ul>
<pre><code class="language-js">obj = {
'red_switch' : 1,//我方红包活动开关,1开0关
};
SgGameH5SDK.red_switch(obj);</code></pre>
<h3>2.6 监听自定义事件(非必接)</h3>
<ul>
<li>调用时机: 引入sdk时调用</li>
<li>调用方法:</li>
</ul>
<pre><code class="language-js">//event 双方协商事件字符串
//data 双方协商事件数据
var callback = function(event, data) {
};
SgGameH5SDK.listen_event(callback);</code></pre>
<h3>2.7 发送自定义事件(非必接)</h3>
<ul>
<li>调用时机: 发送自定义事件时调用</li>
<li>调用方法:</li>
</ul>
<pre><code class="language-js">var event = '';//双方协商事件字符串
var data = {};//双方协商事件数据
SgGameH5SDK.send_event(event, data);</code></pre>