為網站接入 QQ 登入能讓使用者省去另外註冊的麻煩,提升使用體驗。以下說明兩種常見的接入方式。
第一步:引入授權 JS 檔
首先在頁面中引入 QQ 互聯的授權腳本,並配置你的 appid 與 redirecturi:
<script type="text/javascript" src="https://qzonestyle.gtimg.cn/qzone/openapi/qc_loader.js" data-appid="101140406" data-redirecturi="https://127.0.0.1" charset="utf-8"></script>
第二步:接入 QQ 登入
第一種方式:使用系統自帶按鈕登入
呼叫 QC.Login 方法,並指定 btnId 參數把按鈕綁定到容器節點。這種方式會彈出新視窗:
QC.Login({
// btnId:插入按鈕的節點 id,必選
btnId: "qqLoginBtn",
// scope:使用者需要確認的授權項,可選,預設 all
scope: "all",
// size:按鈕尺寸,可選,預設 B_S
size: "B_M"
}, function(reqData, opts){ // 登入成功
console.log(reqData, opts);
// 依返回資料更換按鈕顯示狀態
var dom = document.getElementById(opts['btnId']),
_logoutTemplate = [
'<span><img src="{figureurl}" class="{size_key}"/></span>',
'<span>{nickname}</span>',
'<span><a href="javascript:QC.Login.signOut();">退出</a></span>'
].join("");
dom && (dom.innerHTML = QC.String.format(_logoutTemplate, {
nickname: QC.String.escHTML(reqData.nickname), // 做 xss 過濾
figureurl: reqData.figureurl
}));
}, function(opts){ // 註銷成功
alert('QQ登錄 註銷成功');
});
第二種方式:使用自定義按鈕
以自訂的 <a> 標籤鏈接過去,成功後再呼叫對應的 API。登入後可呼叫 QC.api 取得使用者資訊,並透過 check 判斷是否已登入:
QC.api("get_user_info", {})
// 指定介面訪問成功的接收函式
.success(function(s){
console.log(s);
alert("獲取用戶信息成功!當前用戶昵稱為:" + s.data.nickname);
})
// 指定介面訪問失敗的接收函式
.error(function(f){
alert("獲取用戶信息失敗!");
})
// 指定介面完成請求後的接收函式
.complete(function(c){
alert("獲取用戶信息完成!");
});
// 檢查是否登入
if (QC.Login.check()) {
QC.Login.getMe(function(openId, accessToken){
alert(["當前登錄用戶的", "openId為:" + openId, "accessToken為:" + accessToken].join("\n"));
});
// 這裡可以調用自己的保存介面
}
這兩種方式各有千秋:第一種開發最快,適合快速接入,但會彈出新視窗;第二種可自訂按鈕樣式與登入流程,體驗更一致,適合對 UI 有較高要求的網站。實際接入時,別忘了把 appid 與 redirecturi 換成你自己在 QQ 互聯平台申請的資料。