QQ互联 JS-SDK

对于自己最近在做QQ第三方登录的过程过个简单的总结和笔记。方便自己以后的记忆也希望可以帮到有需要的朋友。

1. 首先，需要申请接入QQ登录，并成功获取到 appid 和 appkey。另外还要拿到之前在QQ互联申请接入时候填的回调地址。

2. 设置2个页面：QQ登录页面和回调地址页面。

（注：如果QQ登录页面与回调地址页面是同一个页面， 则只需要引用一次脚本文件。）

回调地址页面（因为回调地址页面比较简单）

只要添加一下的代码可以：

QQ登录页面

 
引入JS SDK的JS文件

设置QQ登录按钮

如果正确的话会出现这个按钮:

image

这个时候点击按钮的时候，就会跳转到QQ用户的登录授权页面。

【链接是由你的appid，回调地址，授权信息和一些设置得到的。用户确认授权之后，跳转到回调页面并得到code和state参数之后，在去获取Access Token，等到这个Token之后结合appid去拿到每个QQ用户唯一的OpenID，之后就可以调用用户的数据和权限等，OAuth的具体详情有兴趣可以参考我另一篇文章。】

授权成功返回数据

只要授权和登录成功后，就可以获取用户数据和调用接口了，JS的SDK不会很复杂，只要掌握好对应的几个公开方法既可操作。

    QC.Login(
    /*设置按钮的样式*/
    {
        btnId: \"qqLoginBtn\",
        scope: \"all\",
        size: \"B_M\"
    },
    /*
    @登录成之后的回调方法
    @oInfo object 返回用基本信息
    @oOpts object 按钮的基本情况，多个按钮时可用来区分
    */
    function(oInfo, oOpts){
        console.log(oInfo);
        console.log(oOpts);
    }
    );

就可以根据登录成功的回调函数获取到基本信息去设置用户登录的状态了。

image

JS SDK公开方法介绍：

1. QC.Login.showPopup(oOpts)【直接打开QQ登录弹窗】

   参数说明：

   oOpts：需要指定appId，回调地址redirect_URI。

   参数示例如下：

    QC.Login.showPopup({
       appId:\"[appId]\",
       redirectURI:\"[回调地址]\"
    });

   注意：

   oOpts参数不需必传，不传此参数时，登录成功后会跳回登录按钮所在页面。
   如果已使用QC.Login方法，则不需再使用此方法。

2. QC.Login.signOut()【注销当前登录用户】

3. QC.Login.check()【检测当前登录状态】

   返回值说明：

   true：说明登录成功。
   false：说明登录失败。

4. QC.Login.getMe(function(openId, accessToken){})【获取当前登录用户的Access Token以及OpenID】

   参数说明：

   这里的参数为回调函数，通过回调函数获取openId和accessToken。
   openId：用户身份的唯一标识。建议保存在本地，以便用户下次登录时可对应到其之前的身份信息，不需要重新授权。
   accessToken：表示当前用户在此网站/应用的登录状态与授权信息，建议保存在本地。

   参数示例如下:

    QC.Login.getMe(function(openId, accessToken){
        console.log(\"当前登录用户的accessToken为：\"+accessToken);
        console.log(\"当前登录用户的openId为：\"+openId);
    });

   注意：

    getMe方法只能在用户登录授权后调用，建议总是在使用check方法并返回true的条件下，调用getMe方法。

   ---

   调用QQ登录OpenAPI接口

   QQ互联在JS SDK中封装了所有的OpenAPI接口，开发者只需要传递OpenAPI名称，以及OpenAPI需要的相关参数，就可以调用OpenAPI。
   QC.api(api, paras, fmt, method)【OpenAPI统一调用方式】

   参数说明：

直接上代码最靠谱了。
可以直接用个function包含起来，然后通过一个按钮的事件去触发而获取到用户信息

这个可以add_t接口也是可以用个function包含起来，然后通过一个按钮的事件去触发用户发布微博。

而我们需要的只是更改API调用的接口名。如果没有参数就为空，如果有，则为JSON的键值对形式填写。
具体的众多参数请访问API列表。

Request与Response内置对象

1. Request

   JS SDK在初始化时会根据浏览器环境创建不同的请求代理，QC.api的每次调用都是一个Request对象。

   Request对象的公开方法如下：
   success(resp): 请求完成并且返回码为0的回调。
   error(resp): 请求完成并且返回码不为0的回调。
   complete(resp): 请求完成后的回调。

   调用时序为success/error -> complete，每个方法都可以调用多次，每次调用返回Request本身，支持链式调用。
   resp参数为回调函数，回调函数参数为Response对象。

2. Response

   Response为Request对象绑定的回调函数的返回参数，每次QC.api调用的异步响应都会返回一个Response对象，该对象在Request对象的success/error -> complete调用流程中传递。

   Response的公开方法如下：
   stringifyData：返回该Response对象包含的数据体的文本串。

   Response的公开属性如下：
   status：响应状态，-1：代表未知；404：响应错误；200：响应成功。
   fmt：响应数据格式，json/xml。
   code/ret：响应返回码，0为成功，其他为失败。
   data：响应数据实体，json对象/xml对象。
   seq：响应序号，从1000开始编号。