一、前言

    本文档用于引导技术人员进行PC游戏接入，阅读者需具备一定web基础。

    通信时SDK均采用UTF8编码，若游戏使用其他编码，在处理中文时需转为UTF8。

    调用接口的凭证为openId和openKey，由SDK后台分配，需自行前往创建，功能位于”平台管理/开放平台“

    对于PC游戏，SDK提供了多种集成方式，具体可见文档：PC游戏接入方式说明

    本文档讲解上述第1种接入方式，即使用SDK提供的web界面基于OAuth协议进行授权认证

二、流程说明

1. 登录流程

    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匹配游戏角色并进入游戏。

2. 支付流程

    1.玩家在游戏内点击道具购买后，游戏应调用第三章“支付下单接口”传入商品信息等参数，此接口会返回支付链接。

    2.以webview或使用默认浏览器打开该支付链接。

    3.玩家支付成功后，SDK将向游戏服务器发送成功通知（支付回调地址callbackUrl）。

三、接口列表

1. 构造登录链接

1.1  接口目的

    构造登录链接，以便在PC平台中使用webview加载登录界面。

    若游戏使用专属登陆器，可尝试从进程启动参数中获取authToken，若取到authToken，可略过此步骤，直接前往本章2接口验证authToken并免登录进入游戏。

1.2 接口地址

http://xxx.com/openapi/oauth (xxx.com为域名，请联系贵方运营获取,获取之后替换即可)

1.3 请求方式

   GET

1.4 参数列表

 

参数	类型	必要性	说明
openId	string	必传	开放平台开发者身份id，由SDK分配，可通过后台获取
productCode	string	必传	产品标识，由SDK分配，可通过后台获取
channelCode	string	选传	分包标识，可选。用于识别玩家来源
successUrl	string	必传	完成登录后的回调地址（此地址由研发自行提供）
cancelUrl	string	可选	点击关闭按钮时，将跳转至此URL，游戏可捕捉该UrlChange事件
noQrLogin	string	可选	传1时关闭扫码登录
stopClose	string	可选	传1时禁用关闭按钮
lang	string	可选	多语言，支持zh、zh-TW、en
theme	string	可选	窗口风格参数,共有模板可选web,gameLauncher,android,dark

   

   注：登录页通常会100%铺满webview的尺寸，故游戏的webview多大，授权网页将等同其大小。
   游戏可自定义webview尺寸。
   作为建议，我们建议不同theme的尺寸如下：
   默认模板：440x540 (theme不传值则使用默认模板)
   web风格：470x475
   androrid风格：470x535
   gameLaucher风格：510x460
   dark风格：470x510 （注意，若使用dark风格，建议将webview设为透明状态以提高显示效果）

1.5 返回字段

   当玩家登录完成，SDK会跳转时传入的successUrl链接。同时附带uid、username、authToken参数。

   游戏客户端应监听URLChange并关闭webview同时解析GET参数，获取这几项参数。

参数	类型	必要性	说明
uid	string	必有	玩家身份唯一标识，游戏应以此匹配玩家角色
username	string	必有	玩家用户名，游戏可以记录，但需以uid作为唯一标识
authToken	string	必有	授权令牌，游戏服务器应调用授权验证接口，验证authToken和uid是否匹配

2. 验证uid及authToken