文档中心 | 一键联接，全心服务

更新日期：2025年 01月 16日海外版PC游戏Web接入文档

<h3 style="white-space:normal;font-family:微软雅黑, "margin:0px;padding:0px;color:#323232;background-color:#FFFFFF;"> 一、前言 </h3>     本文档用于引导技术人员进行PC游戏接入，阅读者需具备一定web基础。     通信时SDK均采用UTF8编码，若游戏使用其他编码，在处理中文时需转为UTF8。     调用接口的凭证为openId和openKey，由SDK后台分配，需自行前往创建，功能位于”平台管理/开放平台“     对于PC游戏，SDK提供了多种集成方式，具体可见文档：<a href="https://www.quicksdk.com/doc-1109.html?cid=48" target="_blank">PC游戏接入方式说明</a>     本文档讲解上述第1种接入方式，即使用SDK提供的web界面基于OAuth协议进行授权认证 <h3 style="white-space:normal;font-family:微软雅黑, "margin:0px;padding:0px;color:#323232;background-color:#FFFFFF;"> 二、流程说明 </h3> <h4 style="white-space:normal;font-size:14px;font-family:微软雅黑, "margin:0px;padding:0px;color:#323232;background-color:#FFFFFF;"> 1. 登录流程 </h4>     1.获取openId及openKey，获取方式可联系运营人员或自行通过SDK后台添加。     2.按第三章第1点“构造登录链接”接口所需要的参数构造登录URL，并传入成功后的回调URL successUrl参数。     3.游戏以webview打开构造好的登录界面，并监听UrlChange事件（这个步骤各个开发语言略有不同，Demo是基于QT的可以参考）     4.当监听到webview的URL跳转至successUrl时，游戏应关闭webview界面，从URL中解析GET参数，获取uid、authToken、username参数     5.游戏客户端获取到uid和username后，不能直接使用，需传回游戏服务器，通过游戏服务器调用SDK验证接口验证authToken有效性，验证uid是否匹配     6.游戏服务器调用authToken验证接口通过后，方可使用该uid匹配游戏角色并进入游戏。 <h4 style="white-space:normal;font-size:14px;font-family:微软雅黑, "margin:0px;padding:0px;color:#323232;background-color:#FFFFFF;"> 2. 支付流程 </h4>     1.玩家在游戏内点击道具购买后，游戏应调用第三章“支付下单接口”传入商品信息等参数，此接口会返回支付链接。     2.以webview或使用默认浏览器打开该支付链接。     3.玩家支付成功后，SDK将向游戏服务器发送成功通知（支付回调地址callbackUrl）。 <h3 style="white-space:normal;font-family:微软雅黑, "margin:0px;padding:0px;color:#323232;text-wrap:wrap;background-color:#FFFFFF;"> 三、接口列表 </h3> <h4 style="white-space:normal;font-size:14px;margin:0px;padding:0px;color:#323232;"> 1. 构造登录链接 </h4> 1.1  接口目的     构造登录链接，以便在PC平台中使用webview加载登录界面。     若游戏使用专属登陆器，可尝试从进程启动参数中获取authToken，若取到authToken，可略过此步骤，直接前往本章2接口验证authToken并免登录进入游戏。 1.2 接口地址 http://xxx.com/openapi/oauth (xxx.com为域名，请联系贵方运营获取,获取之后替换即可) 1.3 请求方式    GET 1.4 参数列表   <table cellpadding="2" cellspacing="0" border="1" bordercolor="#000000" style="width:900px;position:relative;left:15px;font-family:微软雅黑, "margin:0px;padding:0px;border-spacing:0px;color:#323232;font-size:14px;background-color:#FFFFFF;"> <tbody style="margin:0px;padding:0px;"> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;">  参数 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 类型 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 必要性 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 说明 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  openId </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;"> 必传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  开放平台开发者身份id，由SDK分配，可通过后台获取 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  productCode </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;"> 必传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  产品标识，由SDK分配，可通过后台获取 </td> </tr> <tr> <td>  channelCode </td> <td>  string </td> <td>  选传 </td> <td>  分包标识，可选。用于识别玩家来源 </td> </tr> <tr> <td>  successUrl </td> <td>  string </td> <td>  必传 </td> <td>  完成登录后的回调地址（此地址由研发自行提供） </td> </tr> <tr> <td>  cancelUrl </td> <td>  string </td> <td>  可选 </td> <td>  点击关闭按钮时，将跳转至此URL，游戏可捕捉该UrlChange事件 </td> </tr> <tr> <td>  noQrLogin </td> <td>  string </td> <td>  可选 </td> <td>  传1时关闭扫码登录 </td> </tr> <tr> <td>  stopClose </td> <td>  string </td> <td>  可选 </td> <td>  传1时禁用关闭按钮 </td> </tr> <tr> <td>  lang </td> <td>  string </td> <td>  可选 </td> <td>  多语言，支持zh、zh-TW、en </td> </tr> <tr> <td>  theme </td> <td>  string </td> <td>  可选 </td> <td>  窗口风格参数,共有模板可选web,gameLauncher,android,dark </td> </tr> </tbody> </table>        注：登录页通常会100%铺满webview的尺寸，故游戏的webview多大，授权网页将等同其大小。    游戏可自定义webview尺寸。    作为建议，我们建议不同theme的尺寸如下：    默认模板：440x540 (theme不传值则使用默认模板)    web风格：470x475    androrid风格：470x535    gameLaucher风格：510x460    dark风格：470x510 （注意，若使用dark风格，建议将webview设为透明状态以提高显示效果） <div> </div> 1.5 返回字段    当玩家登录完成，SDK会跳转时传入的successUrl链接。同时附带uid、username、authToken参数。    游戏客户端应监听URLChange并关闭webview同时解析GET参数，获取这几项参数。 <table cellpadding="2" cellspacing="0" border="1" bordercolor="#000000" style="width:900px;position:relative;left:15px;font-family:微软雅黑, "margin:0px;padding:0px;border-spacing:0px;color:#323232;font-size:14px;background-color:#FFFFFF;"> <tbody style="margin:0px;padding:0px;"> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 参数 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 类型 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 必要性 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 说明 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  uid </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  必有 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  玩家身份唯一标识，游戏应以此匹配玩家角色 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  username </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  必有 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  玩家用户名，游戏可以记录，但需以uid作为唯一标识 </td> </tr> <tr> <td>  authToken </td> <td>  string </td> <td>  必有 </td> <td>  授权令牌，游戏服务器应调用授权验证接口，验证authToken和uid是否匹配 </td> </tr> </tbody> </table> <h4 style="white-space:normal;font-size:14px;margin:0px;padding:0px;color:#323232;"> 2. 验证uid及authToken </h4> 2.1 接口目的    验证客户端获取的uid和authToken是否匹配，防止篡改。 2.2 接口地址    http://xxx.com/webOpen/checkToken 2.3 请求方式    POST 2.4 参数列表 <table cellpadding="2" cellspacing="0" border="1" bordercolor="#000000" style="width:900px;position:relative;left:15px;font-family:微软雅黑, "margin:0px;padding:0px;border-spacing:0px;color:#323232;font-size:14px;background-color:#FFFFFF;"> <tbody style="margin:0px;padding:0px;"> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;">  参数 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 类型 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 必要性 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 说明 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  openId </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  必传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  开放平台开发者身份id，由Quick官方SDK分配 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  productCode </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  必传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  产品CODE，在Quick官方SDK后台获取 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  channelCode </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  选传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  cps分包标识，选传，不传系统默认website，如果是用登录器登录的，可以通过启动参数获取 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  authToken </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  必传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  登录成功回传的authToken </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  sign </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  必传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  签名串，算法详见第4章签名方法描述 </td> </tr> </tbody> </table> 2.5 返回字段     接口会返回JSON格式字符串，如：     例1 {"status":false,"message":"tokenUidError",”data”:[]}     例2 {"status":true,"message":"","data":[]} <div style="white-space:normal;font-size:14px;font-family:微软雅黑, "margin:0px;padding:0px;color:#323232;text-wrap:wrap;background-color:#FFFFFF;"> <table cellpadding="2" cellspacing="0" border="1" bordercolor="#000000" style="width:900px;position:relative;left:15px;margin:0px;padding:0px;border-spacing:0px;"> <tbody style="margin:0px;padding:0px;"> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;">  参数 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;">  类型 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 必要性 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;">  说明 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  status </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  bool </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;"> 必有 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  接口验证状态，若通过验证为true，否则为false </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  message </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;"> 必有 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  Status为false时，message有值，为错误提示语 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  data </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  array </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;"> 可为空 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  如果status为true时，data数组包含了用户账号信息 </td> </tr> </tbody> </table> </div>     注：以下参数只有当status为true且data不为空才有 <table cellpadding="2" cellspacing="0" border="1" bordercolor="#000000" style="width:900px;position:relative;left:15px;font-family:微软雅黑, "margin:0px;padding:0px;border-spacing:0px;color:#323232;font-size:14px;background-color:#FFFFFF;"> <tbody style="margin:0px;padding:0px;"> <tr style="margin:0px;padding:0px;"> <td background-color:#cccccc;"="" style="line-height: 30px; font-family: 微软雅黑, "Microsoft YaHei", Arial, "Apple LiGothic Medium", SimHei, "ST Heiti"; height: 30px; padding: 0px; margin: 0px;"> 参数 </td> <td background-color:#cccccc;"="" style="line-height: 30px; font-family: 微软雅黑, "Microsoft YaHei", Arial, "Apple LiGothic Medium", SimHei, "ST Heiti"; height: 30px; padding: 0px; margin: 0px;"> 类型 </td> <td background-color:#cccccc;"="" style="line-height: 30px; font-family: 微软雅黑, "Microsoft YaHei", Arial, "Apple LiGothic Medium", SimHei, "ST Heiti"; height: 30px; padding: 0px; margin: 0px;"> 必要性 </td> <td background-color:#cccccc;"="" style="line-height: 30px; font-family: 微软雅黑, "Microsoft YaHei", Arial, "Apple LiGothic Medium", SimHei, "ST Heiti"; height: 30px; padding: 0px; margin: 0px;"> 说明 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  uid </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  int </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  必有 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  SDK用户uid </td> </tr> <tr> <td>  deviceId </td> <td>  string </td> <td>  必有 </td> <td>  设备信息设备号 </td> </tr> <tr> <td>  productId </td> <td>  string </td> <td>  必有 </td> <td>  产品id </td> </tr> <tr> <td>  tokenIp </td> <td>  string </td> <td>  必有 </td> <td>  ip </td> </tr> <tr> <td>  token </td> <td>  string </td> <td>  必有 </td> <td>  token </td> </tr> </tbody> </table> <h4 style="white-space:normal;font-size:14px;margin:0px;padding:0px;color:#323232;"> 3. 创建订单并构造支付链接 </h4> 3.1 接口目的    通过此接口传入下单数据，下单成功后可返回进入支付的连接。 3.2 接口地址    http://xxx.com/webOpen/getPayUrl 3.3 请求方式    POST 3.4 参数列表 <table cellpadding="2" cellspacing="0" border="1" bordercolor="#000000" style="width:900px;position:relative;left:15px;font-family:微软雅黑, "margin:0px;padding:0px;border-spacing:0px;color:#323232;font-size:14px;background-color:#FFFFFF;height:25%;"> <tbody style="margin:0px;padding:0px;"> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;">  参数 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 类型 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 必要性 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 说明 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  openId </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  必传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  开放平台开发者身份id，由Quick官方SDK分配 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  productCode </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  必传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  产品CODE，在Quick官方SDK后台获取 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  channelCode </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  选传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  cps分包标识，选传，不传系统默认website，如果是用登录器登录的，可以通过启动参数获取 </td> </tr> <tr> <td>  amount </td> <td>  float </td> <td>  必传 </td> <td>  将要下单的金额，单位美元 </td> </tr> <tr> <td>  userId </td> <td>  string </td> <td>  必传 </td> <td>  sdk登录成功返回的uid </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  cpOrderNo </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  必传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;"> 游戏订单号 </td> </tr> <tr> <td>  orderSubject </td> <td>  string </td> <td>  必传 </td> <td>  商品描述 </td> </tr> <tr> <td>  goodsName </td> <td>  string </td> <td>  必传 </td> <td>  商品名称 </td> </tr> <tr> <td>  goodsId </td> <td>  string </td> <td>  必传 </td> <td>  商品名id </td> </tr> <tr> <td>  roleName </td> <td>  string </td> <td>  必传 </td> <td>  角色名 </td> </tr> <tr> <td>  roleLevel </td> <td>  float </td> <td>  必传 </td> <td>  角色等级 </td> </tr> <tr> <td>  serverId </td> <td>  string </td> <td>  必传 </td> <td>  区服id </td> </tr> <tr> <td>  serverName </td> <td>  string </td> <td>  必传 </td> <td>  区服名称 </td> </tr> <tr> <td>  clientLang </td> <td>  string </td> <td>  必传 </td> <td>  支付中心语言包，填写地区语言代码，如en-US。默认为中文繁体 </td> </tr> <tr> <td>  extrasParams </td> <td>  string </td> <td>  选传 </td> <td>  透传参数，通常为研发需要的特定参数，sdk会原样回调。 </td> </tr> <tr> <td>  callbackUrl </td> <td>  string </td> <td>  选传 </td> <td>  支付成功回调结果的地址 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  sign </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  必传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  签名串，算法详见第4章签名方法描述 </td> </tr> </tbody> </table> 3.5 返回字段     接口会返回JSON格式字符串，如：     例1 {"status":false,"message":"tokenUidError",”data”:[]}     例2 {"status":true,"message":"","data":[]} <table cellpadding="2" cellspacing="0" border="1" bordercolor="#000000" style="width:900px;position:relative;left:15px;font-family:微软雅黑, "margin:0px;padding:0px;border-spacing:0px;color:#323232;font-size:14px;background-color:#FFFFFF;"> <tbody style="margin:0px;padding:0px;"> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;">  参数 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;">  类型 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 必要性 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;">  说明 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  status </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  bool </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;"> 必有 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  接口验证状态，若通过验证为true，否则为false </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  message </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;"> 必有 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  Status为false时，message有值，为错误提示语 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  data </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  array </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;"> 可为空 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  如果status为true时，data数组包含了订单详细信息 </td> </tr> </tbody> </table>     接口会返回JSON格式字串，形如： <table style="width:900px;position:relative;left:15px;color:#000000;"> <tbody> <tr> <td class="line-number" value="1" style="line-height:30px;height:30px;padding:0px 5px;"> </td> <td class="line-content" style="line-height:30px;height:30px;padding:0px 5px;"> {"status":true,"data":{"payUrl":"https://qkgamesdk.quickapi.net/payH5/payCenter?clientLang=zh-cn&data=zzk4puUOWCH13TXOOb6AuOhAiGb/slIUrw2+EURpRinTg1ubbYeMjLBb+Z3cVnn0AulLuWVOud86+EudHyYqX3oililkAcDT5G2+E9Og4U8=&sign=ce30d0a71aa2584bb8ee91921f4dca57"},"message":"请求成功"} 说明：返回的JSON结构体里，data.payUrl即为当前接口返回的完整支付页面url </td> </tr> </tbody> </table> <h4 style="white-space:normal;font-size:14px;margin:0px;padding:0px;color:#323232;"> 4. 构造并打开个人中心 </h4> 4.1 接口目的     用户构造用户中心地址，以便在游戏中打开用户中心，方便玩家进行修改密码等操作。 4.2 接口地址     http://xxx.com/openCenter/index 4.3 请求方式 GET 4.4 参数列表 <table cellpadding="2" cellspacing="0" border="1" bordercolor="#000000" style="width:900px;position:relative;left:15px;font-family:微软雅黑, "margin:0px;padding:0px;border-spacing:0px;color:#323232;font-size:14px;background-color:#FFFFFF;"> <tbody style="margin:0px;padding:0px;"> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;">  参数 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 类型 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 必要性 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 说明 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  appProduct </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  必传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  产品CODE，在Quick官方SDK后台获取 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  channelCode </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  选传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  cps分包标识，选传，不传系统默认website </td> </tr> <tr> <td>  authToken </td> <td>  string </td> <td>  必传 </td> <td>  登录成功回传的authToken </td> </tr> </tbody> </table> 4.5 返回字段   该接口无返回，以webview或默认浏览器加载构造的URL即可 <h4 style="white-space:normal;font-size:14px;margin:0px;padding:0px;color:#323232;"> 5. 上传角色信息 </h4> 5.1 接口目的    通过此接口上报游戏的角色信息 5.2 接口地址    http://xxx.com/webOpen/setGameRoleInfo 5.3 请求方式    POST 5.4 参数列表 <table cellpadding="2" cellspacing="0" border="1" bordercolor="#000000" style="width:900px;position:relative;left:15px;font-family:微软雅黑, "margin:0px;padding:0px;border-spacing:0px;color:#323232;font-size:14px;background-color:#FFFFFF;height:25%;"> <tbody style="margin:0px;padding:0px;"> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;">  参数 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 类型 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 必要性 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 说明 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  openId </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  必传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  开放平台开发者身份id，由Quick官方SDK分配 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  productCode </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  必传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  产品CODE，在Quick官方SDK后台获取 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  channelCode </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  选传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  cps分包标识，选传，不传系统默认website，如果是用登录器登录的，可以通过启动参数获取 </td> </tr> <tr> <td>  userId </td> <td>  string </td> <td>  必传 </td> <td>  sdk登录成功返回的uid </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  vipLevel </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  必传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;"> vip等级 </td> </tr> <tr> <td>  deviceId </td> <td>  string </td> <td>  必传 </td> <td>  设备信息设备号 </td> </tr> <tr> <td>  partyId </td> <td>  string </td> <td>  选传 </td> <td>  帮派id </td> </tr> <tr> <td>  partyName </td> <td>  string </td> <td>  选传 </td> <td>  公会社团名称 </td> </tr> <tr> <td>  userRoleName </td> <td>  float </td> <td>  必传 </td> <td>  角色名称 </td> </tr> <tr> <td>  userRoleLevel </td> <td>  string </td> <td>  必传 </td> <td>  角色等级 </td> </tr> <tr> <td>  userRoleBalance </td> <td>  string </td> <td>  必传 </td> <td>  角色用户余额 </td> </tr> <tr> <td>  userRoleId </td> <td>  string </td> <td>  选传 </td> <td>  角色ID </td> </tr> <tr> <td>  serverId </td> <td>  string </td> <td>  选传 </td> <td>  区服ID </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  serverName </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  必传 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  区服名称 </td> </tr> <tr> <td>  sign </td> <td>  string </td> <td>  必传 </td> <td>  签名串，算法详见第4章签名方法描述 </td> </tr> </tbody> </table> 5.6 返回字段        接口会返回JSON格式字符串，如：     例1 {"status":false,"message":"tokenUidError",”data”:[]}     例2 {"status":true,"message":"","data":[]} <table cellpadding="2" cellspacing="0" border="1" bordercolor="#000000" style="width:900px;position:relative;left:15px;font-family:微软雅黑, "margin:0px;padding:0px;border-spacing:0px;color:#323232;font-size:14px;background-color:#FFFFFF;"> <tbody style="margin:0px;padding:0px;"> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;">  参数 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;">  类型 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;"> 必要性 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;background-color:#CCCCCC;height:30px;">  说明 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  status </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  bool </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;"> 必有 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  接口验证状态，若通过验证为true，否则为false </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  message </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  string </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;"> 必有 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  Status为false时，message有值，为错误提示语 </td> </tr> <tr style="margin:0px;padding:0px;"> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  data </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  array </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;"> 可为空 </td> <td style="line-height:30px;font-family:微软雅黑, "margin:0px;padding:0px 5px;height:30px;">  如果status为true时，data数组包含了角色详细信息 </td> </tr> </tbody> </table>     接口会返回JSON格式字串，形如： <table style="width:900px;position:relative;left:15px;color:#000000;"> <tbody> <tr> <td class="line-number" value="1" style="line-height:30px;height:30px;padding:0px 5px;"> {"status":false,"data":[],"message":"Mandatory param missing:sign"} </td> <td class="line-content" style="line-height:30px;height:30px;padding:0px 5px;"> </td> </tr> </tbody> </table>         <h3 style="white-space:normal;font-family:微软雅黑, "margin:0px;padding:0px;color:#323232;background-color:#FFFFFF;"> 四、签名方法 </h3>   第一步：对所有参与请求的参数（排除sign本身）进行字典升序排序，首字母相同则按第二位升序，类推。   第二步：使用上述参数构造签名串比如key1=val1&key2=val2&key3=val3依次类推，假如得到签名串StringA，注意key与val都是urldecode之后的值。   第三步：拼接最终的签名串StringB = StringA + "&" + openKey(通过开发者平台获取)。   第四步：使用md5计算第三步签名串哈希值即为：sign=md5(StringB)。 <h3 style="white-space:normal;font-family:微软雅黑, "margin:0px;padding:0px;color:#323232;background-color:#FFFFFF;"> 五、其他注意事项 </h3>    当登录系统包含第三方授权登录时，游戏的webview应支持新窗口打开方法。各程序语法有差异，大体思路为继承webview控件重新实现onCreateWindow之类的方法。    新标签也应监听urlChange事件，当跳转至successUrl时应关闭webview并解析参数。    为获得较好的视觉效果，如圆角等，可将webview控件设为透明模式。等待webview加载网页期间，可设置一些过渡动画。