修订记录日期修订 CR 修改修改描述作者版本号章节初始版本张鸣增加 CP 测试验证方法张鸣增加 JS 调用描述和修改测试方法张鸣增加 demo 张鸣 201

Size: px

Start display at page:

Download "修订记录日期修订 CR 修改修改描述作者版本号章节初始版本张鸣增加 CP 测试验证方法张鸣增加 JS 调用描述和修改测试方法张鸣增加 demo 张鸣 201"

壁翁
5 years ago
Views:

2 修订记录日期修订 CR 修改修改描述作者版本号章节初始版本张鸣增加 CP 测试验证方法张鸣增加 JS 调用描述和修改测试方法张鸣增加 demo 张鸣增加 php 的登录 demo 张鸣增加 signtype 张鸣增加游戏协议要求, 必须采用 HTTPS 协议张鸣华为机密, 未经许可不得扩散第 2 页, 共 21 页

3 1 方案概述华为游戏中心提供 H5 游戏服务, 为玩家提供 H5 游戏服务本文档提供 H5 游戏接入方案, 请游戏 CP 按照文档描述接入和验证游戏 2 前期准备 1. 开发者需要在华为开发者联盟上传任意一个 apk, 草稿状态即可 ; 2. 申请支付权益, 审核通过后, 即可获取文档中所需的游戏支付密钥和应用对应的 appid 华为机密, 未经许可不得扩散第 3 页, 共 21 页

4 3 方案与接口描述 3.1 方案与接口描述华为游戏中心 H5 游戏 H5 游戏服务端华为支付服务器访问 H5 游戏地址调用 getplayerid() 登录 js:setplayerid(playerid) 根据 playerid 加载游戏调用 showbuoy() 浮标 js:logout(playerid) 通知 playerid 退出调用快捷支付完成支付返回支付结果通知支付完成通知支付校验后发放道具说明 : 1. H5 游戏部署的网站, 必须采用 HTTPS 协议, 且必须使用权威 CA 颁发的证书华为机密, 未经许可不得扩散第 4 页, 共 21 页

5 2. 华为游戏中心集成 H5 游戏,H5 游戏启动时, 需要调用华为游戏中心客户端的 void getplayerid() 函数进行登陆 (JS 调用示例 :window.hispaceobject.getplayerid();), 登陆完成后, 游戏中心会调用 H5 游戏的 js:boolean setplayerid(string playerid,string appid,string ts,string sign) 方法, 将 playerid 传给 H5 游戏,H5 游戏在服务端根据该 playerid 加载游戏数据, 设置成功返回 true; js:boolean setplayerid(string playerid,string appid,string ts,string sign) 方法说明 : 参数名参数类型是否必选参数说明 playerid String 是返回的用户 playerid appid String 是返回游戏的 appid ts String 是 Java 时间戳 ( 自 1970 年 1 月 1 日 0 时起的毫秒数 ) sign String 是参数签名值 sha256withrsa(appid+playerid+ts) 签名公钥 : 十六进制 : D06092A864886F70D F A B598B20D 8D7F5410A068AD6C90D04FC772D4C1ACCB AB DDBB544D129425E81 ACFB03AE99A DA624371DA8736BDD29EDD92A9F52CF7BE8DA738097D7A38157 E08A70ADA539DB26DE38248A2CA41F2569C22A80FE31E736CC6A3F AB3125 CA664662CF33D971AC7FFE2CF3DBB7EF6A4FBD3ABA8552A569751B8C32D200285D17E 3CBA59E77BEAA162E513E41C9D25A85F4E1E90F3905A6F3A817A84BE92D0ED05C15E0 D4715FEF812D7D0E1CF43ADAE30B606A35C772D CB DEBB5490D8 8DED52CEAC3C3B78C3D97D DAB6FC831B7486D606B5BE9C2B8F6982E2214F4E8 F3DC66757B Base64: MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAm1mLINjX9UEKBorWyQ0E/ HctTBrMuFBFhimrEWUAGN27VE0SlCXoGs+wOumahWJ4TaYkNx2oc2vdKe3ZKp9Sz3vo2n OAl9ejgVfginCtpTnbJt44JIospB8lacIqgP4x5zbMaj9UgQlJkKsxJcpmRmLPM9lxrH/+LPPbt+9q 华为机密, 未经许可不得扩散第 5 页, 共 21 页

6 T706uoVSpWl1G4wy0gAoXRfjy6Wed76qFi5RPkHJ0lqF9OHpDzkFpvOoF6hL6S0O0FwV4NR xx++blx0ohpq62umlygo1x3lsn4rjtld4abjxkk3rtuknin7vlordw7empzfwkwyf2 rb8gxt0htygtb6ck49pguiht06ppcznv7blqqidaqab 3. H5 游戏实现用户退出方法, 提供游戏退出方法 js:boolean logout(), 设置成功返回 true; 4. H5 游戏登录成功后调用华为游戏中心客户端的 void showbuoy() 函数展示浮标 ; 5. 华为游戏中心提供 boolean isgamebox() 函数, 返回 true 表示当前页是在华为游戏中心内打开 ; 6. 需要支付时, 调用华为游戏中心 void startpay(string payjson),payjson 如下 : 参数名参数类型是否必选参数说明 username String(50) 是支付 sdk 的商户名称, 即 CP 公司名称 * 必填且不能为空, 不参与签名 userid String 是支付 ID 在开发者联盟上获取的支付 ID * 必填且不能为空 applicationid String 是应用 ID 在开发者联盟上获取的 APP ID * 必填且不能为空 amount String 是商品所要支付金额格式为 : 元. 角分, 最小金额为分, 保留到小数点后两位例如 : 华为机密, 未经许可不得扩散第 6 页, 共 21 页

7 20.00, 此金额将会在支付时显示给用户确认 ) * 必填且不能为空 productname String(50) 是商品名称此名称将会在支付时显示给用户确认注意 : 该字段中不能包含特殊字符, 包括 # " & /? $ ^ *:) \ < >, = 回车换行 * 必填且不能为空 requestid String(30) 是开发者支付订单号, 注 : 最长 30 字节其值由游戏 CP 生成, 用于标识一次支付请求, 每次请求需唯一, 不可重复支付平台在服务器回调接口中会原样返回 requestid 的值注意 : 该字段中不能包含特殊字符, 包括 # " & /? $ ^ *:) \ < >, = 回车华为机密, 未经许可不得扩散第 7 页, 共 21 页

8 换行 * 必填且不能为空 productdesc String(100) 是商户对商品的自定义描述注意 : 该字段中不能包含特殊字符, 包括 # " & /? $ ^ *:) \ < >, = 回车换行 * 必填且不能为空 extreserved String(100) 否商户侧保留信息, 输入的话在回调接口中原样返回注 : 最长 100 字节选填, 不参与签名 * 选填, 不参与签名 sign String 是 RSA 签名 ( 除了 sign 和声明不参与签名的字段都要签名, 用私钥签名 ) * 必填且不能为空, 不参与签名 signtype String 否当采用 SHA256WithRSA 签名时, 该值为 RSA256( 不传时缺省为华为机密, 未经许可不得扩散第 8 页, 共 21 页

9 SHA1WithRSA) * 选填, 不参与签名 screentorient int 否支付屏幕方向, 对于横屏游戏必须将此参数设为 2, 否则在支付时支付页面会强制竖屏导致游戏页面布局发生错乱 1: 竖屏 ( 默认值 ) 2: 横屏 * 选填, 不参与签名 7. 支付完成后设置支付结果 setpayresult(string returncode, String username, String orderid, String requestid, String amount,string errmsg, String time, String sign) 参数说明 : 参数名参数类型是否可为空值参数说明 returncode String 可为空值 0 表示成功, 详见下面支付结果返回码说明 username String(50) 可为空值开发者支付请求的商户昵称, 原样返回 orderid String 可为空值支付平台订单号 requestid String(30) 可为空值开发者支付订单号原样返回支付请求中 requestid 的值 amount String 可为空值商品支付金额 ( 格式为 : 元. 角分 ) 保留到小数点后两位华为机密, 未经许可不得扩散第 9 页, 共 21 页

10 errmsg String(50) 可为空值支付返回描述信息 time String(15) 可为空值 Java 时间戳 ( 自 1970 年 1 月 1 日 0 时起的毫秒数 ) sign String 可为空值开发者签名, 开发者需要拿公钥进行验签支付结果返回码说明 : 错误代码含义 0 成功 -1 失败用户中途取消了支付参数或参数类型错误支付结果查询超时 ( 建议此时客户端去服务器查询订单是否支付成功 ) 非法请求网络连接异常系统升级订单过期 ( 在支付页面停留时间超时有效期而未发起支付 ) 登陆账号失败系统错误 8. 支付签名规则 a. 生成待签名字符串例子 : 出售商品 (productname): MF 唱片价格 (amount):0.01( 元 ) 订单号 (requestid): 商品描述 (productdesc): 正版 MF 唱片 HIFI 毒药 4 毒药涅磐再造海洛因新 4 号华为机密, 未经许可不得扩散第 10 页, 共 21 页

11 HD 天碟 1CD 支付 ID(userID): 应用 ID(applicationID): 对参数的 key 按 ASCII 码的增序排序, 若遇到相同首字母, 则看第二个字母, 以此类推排序完成之后, 再把所有数组值以 & 字符连接起来, 则生成如下待签名字符串 : amount=0.01&applicationid= &productdesc= 正版 MF 唱片 HIFI 毒药 4 毒药涅磐再造海洛因新 4 号 HD 天碟 1CD&productName=MF 唱片 &requestid= &userID= 注 : 不要将空值 ( 包括 null 和情况 ) 的参数包含到待签名数据中 b. 对商品信息进行 rsa 签名 9. 支付服务端回调, 参看华为游戏服务 SDK 支付服务端回调接口.pdf 4 JS 调用方法示例 <script type="text/javascript"> window.onload=function() // 页面初始化完成, 调用华为游戏中心登录接口 alert(" 开始华为游戏中心登录 "); window.hispaceobject.getplayerid(); function login() window.hispaceobject.getplayerid(); function gameinnerlogin() alert(" 游戏内部登录成功 "); document.getelementbyid("t").style.visibility = "hidden"; // 进入游戏华为机密, 未经许可不得扩散第 11 页, 共 21 页

12 // 调用显示华为游戏中心浮标 window.hispaceobject.showbuoy(); alert(" 开始调起华为快捷支付 "); window.hispaceobject.startpay(""); function setplayerid( playerid, appid, ts, sign) // 游戏登录成功 alert(" 华为游戏中心登录成功 \n setplayerid"); // sign 验签... // login inner... gameinnerlogin(); function logout() alert(" 用户账号退出 "); // 返回到登录界面 document.getelementbyid("t").style.visibility = "visible"; // 支付结果 function setpayresult(returncode, username, orderid, requestid,amount, errmsg, time, sign) alert(" 支付结果 \n setpayresult(returncode, username, orderid, requestid,amount, errmsg, time, sign)"); // 校验 </script> </head> <body> <div class="d1"><img src="xxx.jpg" width="100%" height="100%"/></div> 华为机密, 未经许可不得扩散第 12 页, 共 21 页

13 <div id="t"><button onclick="login()" id="btn" > 登录 </button></div> </body> 5 测试方法 CP 在接口接入完毕后, 使用以下方法进行游戏测试 : 1. 用华为手机, 进入应用市场, 下载华为游戏中心客户端 2. 将以下代码保存为 h5game_start.html, 并拷贝到手机的 sd 卡中, 并用手机浏览器打开 <!DOCTYPE> <html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width,target-densitydpi=high-dpi,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no"/> <title> 启动华为游戏中心 H5 游戏 </title> <style> body.allwkg width:480px; margin:0 auto;overflow:hidden; #startbtn position: relative; display: inline-block; background: #A0EEFF; border: 1px solid #99D3F5; border-radius: 4px; padding: 4px 12px; overflow: hidden; color: #1E88C7; text-decoration: none; 华为机密, 未经许可不得扩散第 13 页, 共 21 页

14 text-indent: 0; line-height: 20px; #gameid height:30px; background: #A0EEFF; border: 1px solid #99D3F5; color: #1E88C7; #direction height:30px; background: #A0EEFF; border: 1px solid #99D3F5; color: #1E88C7; padding-top:0px #prepare text-align:left; color: #1E88C7; margin-top:20px.tiptitle font-size: 110% 华为机密, 未经许可不得扩散第 14 页, 共 21 页

15 .tipcontent font-size: 90%.item margin-left:5px </style> <script> function starth5() var gameid = document.getelementbyid("gameid").value; if(gameid.length == 0) alert(" 请 H5 游戏的 appid"); return ; if(gameid.indexof("h")!= 0) if(gameid.indexof("h") == 0) gameid = "H" + gameid.substring(1); else gameid="h" + gameid; 华为机密, 未经许可不得扩散第 15 页, 共 21 页

16 var direction = document.getelementbyid("direction").value; window.location.href='higame://openapp?openstr="openid":"38","params":["name":"url","type":"string","value":"http %3A%2F%2Fhispaceclt.hicloud.com%3A8080%2Fhwmarket%2Fh5%2Fapp%3Fappid%3D'+gameId+'%26direction%3 D'+direction+'"]&thirdId= '; </script> </head> <body > <div class="allwkg"> <div style="color: #1E88C7;"> <div style="float:left;margin-right:10px"> <input type="text" id="gameid" placeholder=" 请 H5 游戏的 appid"> </div> <div style="float:left;margin-right:10px"> <select id="direction"> <option value ="1"> 竖屏 </option> <option value ="0"> 横屏 </option> </select> </div> <div style="float:left"> <button type="button" onclick="starth5()" id="startbtn"> 启动 </button> </div> </div> 华为机密, 未经许可不得扩散第 16 页, 共 21 页

17 <br/> <div id="prepare"> <div class="tiptitle"> 启动前准备 : </div> <div class="tipcontent"> 1. 用华为手机, 进入应用市场, 下载华为游戏中心客户端 <br/> 2. 将此 html 拷贝到手机的 sd 卡中, 并用手机浏览器打开 <br/> 3. 在此 html 中输入 H5 游戏的 appid, 选择游戏横竖屏设置, 并点击启动按钮, 即可打开 H5 游戏 <br/> 4. 请 CP 根据测试文档, 对接入的游戏进行验证 </div> </div> <div id="prepare"> <div class="tiptitle"> 常见问题 : </div> <div class="tipcontent"> 1. 启动后出现提示该游戏已下架 :<br/> <span class="item">1) 检查 appid 是否正确 <br/></span> <span class="item">2) 请联系游戏中心运营确认 H5 游戏是否在应用市场后台配置完成 <br/></span> 2. 出现提示网络未连接, 请点击重试, 请检查网络是否可用 </div> </div> </body> </html> 3. 在此 html 中输入 H5 游戏的 appid, 选择游戏横竖屏设置, 并点击启动按钮, 即可打开 H5 游戏 4. 请 CP 根据测试文档, 对接入的游戏进行验证华为机密, 未经许可不得扩散第 17 页, 共 21 页

18 6 附录 1. php 的登录验签公钥 publickey.pem 文件生成方法 ( 只涉及需要 php 开发的 CP, 代码中的公钥直接使用无需替换 ): <?php header("content-type: text/html; charset=utf-8"); $filename = dirname( FILE $devpubkey = "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAm1mLINjX9UEKBorWyQ0E/ HctTBrMuFBFhimrEWUAGN27VE0SlCXoGs+wOumahWJ4TaYkNx2oc2vdKe3ZKp9Sz3vo2n OAl9ejgVfginCtpTnbJt44JIospB8lacIqgP4x5zbMaj9UgQlJkKsxJcpmRmLPM9lxrH/+LPPbt+9q T706uoVSpWl1G4wy0gAoXRfjy6Wed76qFi5RPkHJ0lqF9OHpDzkFpvOoF6hL6S0O0FwV4NR xx++blx0ohpq62umlygo1x3lsn4rjtld4abjxkk3rtuknin7vlordw7empzfwkwyf2 rb8gxt0htygtb6ck49pguiht06ppcznv7blqqidaqab"; $begin_public_key = "-----BEGIN PUBLIC KEY-----\r\n"; $end_public_key = "-----END PUBLIC KEY-----\r\n"; $fp = fopen($filename,'ab'); fwrite($fp,$begin_public_key,strlen($begin_public_key)); $raw = strlen($devpubkey)/64; $index = 0; while($index <= $raw ) $line = substr($devpubkey,$index*64,64)."\r\n"; if(strlen(trim($line)) > 0) fwrite($fp,$line,strlen($line)); $index++; 华为机密, 未经许可不得扩散第 18 页, 共 21 页

19 fwrite($fp,$end_public_key,strlen($end_public_key)); fclose($fp);?> 2. 登录的 php 验证 Demo 代码 ( 只涉及需要 php 开发的 CP): <?php header("content-type: application/json; charset=utf-8"); $appid='h '; $ts=' '; $playerid=' '; $content = $appid.$playerid.$ts; $sign = '91D79408F E2377DE8FA9CFB738D75A91C13DA6AFE70080B7EA0092B42F AFBA421C51FA741D942FE8D485926D7D60AC561EF D054B D4 A2E14D36A10CEEB3BCE4FC714011BABA05312D259D624DD31782DD40095AA32E2F0 1E7EAE1C615E6CEEB4A319B8D6CAFF9E8069E663972A181BFC5F1BCAD13BCB5D8E 74687AFB37B33993CCC19AF BCDF419D2781BA398ADD55C89C58D 89A6DE1DF09714B62BF1595C CACD50AB4987D88B7BF1A0E C79 D8718F3BE5EFD104C0C621AF7E17A9FE3426B14ED457E93DB7A6BCE1CC08F96223B A507ABA4C6672C51A D1EA90F0277F39'; $filename = dirname( FILE )."/publickey.pem"; if(!file_exists($filename)) echo "\"result\" : 1 "; return; $pubkey $openssl_public_key $ok $openssl_public_key,'sha256withrsaencryption'); 华为机密, 未经许可不得扩散第 19 页, 共 21 页

20 @openssl_free_key($openssl_public_key); $result = ""; if($ok) $result = "0";// 成功 else $result = "1"; $res = " \"result\": $result "; echo $res;?> 3. 拉起支付的 php 签名算法 ( 只涉及需要 php 开发的 CP, 其中 payprivatekey.pem 可以参考登录验签公钥生成方法 ): <?php header("content-type: application/json; charset=utf-8"); $content="amount=8.00&applicationid= &productdesc= 充值 8 元 &productname=8 元 &requestid=123456&userid= "; $filename = dirname( FILE )."/payprivatekey.pem"; if(!file_exists($filename)) echo "\"result\" : 1 "; return; $prikey $signature, $openssl_private_key, 'sha256withrsaencryption'); $sign=@base64_encode($signature); 华为机密, 未经许可不得扩散第 20 页, 共 21 页

21 echo $sign;?> 华为机密, 未经许可不得扩散第 21 页, 共 21 页

5-1 nav css 5-2

5 HTML CSS HTML CSS Ê Ê Ê Ê 5-1 nav css 5-2 5-1 5 5-1-1 5-01 css images 01 index.html 02 5-3 style.css css 03 CH5/5-01/images 04 images index.html style.css 05

修订记录 日期 修订 CR 修改 修改描述 作者 版本 号 章节 初始版本 张鸣 增加 CP 测试验证方法 张鸣 增加 JS 调用描述和修改测试方法 张鸣 增加 demo 张鸣 201

修订记录日期修订 CR 修改修改描述作者版本号章节初始版本张鸣增加 CP 测试验证方法张鸣增加 JS 调用描述和修改测试方法张鸣增加 demo 张鸣 201