一、前言

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

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

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

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

    7.游戏客户端进入游戏后，需判断timeleft的值，若为-1时则无需计时，若大于0则代表玩家需进行防沉迷保护，游戏客户端需设置计时器开始倒计时，倒计时为0时应提示未成年玩家下线。

2. 支付流程

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

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

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

三、接口列表

1. 构造登录链接（前端调用）

1.1  接口目的

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

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

1.2 接口地址

   https://qkgamesdk.quickapi.net/open/oauth

1.3 请求方式

   GET

1.4 参数列表

参数	类型	必要性	说明
openId	string	必传	开放平台开发者身份id，由SDK后台分配
productCode	string	必传	产品CODE，在SDK后台获取
channelCode	string