DIV CSS 佈局教程網

jQuery + JSON + jPlayer 打造 QQ 空間音樂查詢播放器
編輯:JQuery特效代碼     

「輸入一個 QQ 號,就把對方收藏的音樂列出來直接線上聽」——這個想法看起來有趣,實作難度卻不高,因為整個流程可以拆成三段:算出簽名參數、抓 JSON 資料、把資料餵給播放器。這篇就用 jQuery 搭配 jPlayer 把它跑起來。

展示頁面:https://bejson.com/demos/qqmusic/

關於接口

QQ 音樂的查詢接口由 bejson 這類平台整理收錄,有興趣可以看他們的接口列表:https://www.bejson.com/webInterface.php,音樂相關的接口就在其中。要注意的是這類第三方整理的公共接口屬於早期產物,可用性與穩定性都不保證,正式專案請改用官方開放平台並依其規範取得授權,不要拿來當生產環境的依賴。

第一步:取得 g_tk 簽名

QQ 空間系的接口普遍要求帶一個 g_tk 參數,它由一組字元逐位累加推算而來,演算法是固定的:

function getGTK() {
    var str = "@HR3etVm80";
    var hash = 5381;
    for (var i = 0, len = str.length; i < len; ++i) {
        hash += (hash << 5) + str.charAt(i).charCodeAt();
    }
    var gtk = hash & 0x7fffffff;
    return gtk;
}

這裡的 hash << 5 就是乘以 32,用位移取代乘法是常見的效能寫法;最後 & 0x7fffffff 把結果壓成正的 31 位元整數。

第二步:發請求

因為接口回傳的是 JSONP 格式的腳本,可以直接用 getScript 載入,天然繞過跨網域限制:

function getMusicId() {
    var qqNo = document.getElementById("qqNo").value;
    var url = 'https://qzone-music.qq.com/fcg-bin/cgi_playlist_xml.fcg?uin='
            + qqNo + '&json=1&g_tk=' + getGTK();
    $.getScript(url);
}

第三步:解析回呼資料

拿到的結構大致是 data.qqmusic.playlist.song 這個陣列,每筆有歌名與 mp3 位址。我們把它轉成 jPlayer playlist 需要的格式:

function jsonCallback(data) {
    if (data.code == 1) {
        alert(data.msg);
        return;
    }
    var songs = data.qqmusic.playlist.song;
    var dataStr = "[";
    for (var i = 0; i < songs.length; i++) {
        dataStr += "{";
        dataStr += "title:'" + songs[i].xsong_name + "',";
        dataStr += "mp3:'" + songs[i].xsong_url + "'";
        dataStr += "}";
        if (i < songs.length - 1) { dataStr += ','; }
    }
    dataStr += ']';
    var ds = JSON.parse(dataStr.replace(/'/g, '"'));
    newPlayer(ds);
}

原始示範用的是 eval,這裡改成先正規化引號再走 JSON.parse,是因為 eval 會執行字串中的任意程式碼,只要歌名裡出現惡意片段就有風險,能避開就避開。

第四步:交給 jPlayer

var playList;
function newPlayer(data) {
    playList = new jPlayerPlaylist({
        jPlayer: "#jquery_jplayer_1",
        cssSelectorAncestor: "#jp_container_1"
    }, data, {
        swfPath: "js",
        supplied: "mp3",
        wmode: "window"
    });
}

supplied: "mp3" 告訴播放器資料來源格式是 mp3;swfPath 是舊版 jPlayer 用來放 Flash 後備播放元件的目錄。值得一提的是,Flash 已在主流瀏覽器全面退場,新版 jPlayer 早已改為純 HTML5 Audio 實作,這個參數可以直接拿掉。

整條鏈條回顧

使用者輸入 QQ 號 → 前端算出 g_tk → JSONP 抓歌單 → 回呼裡組出 jPlayer playlist 物件 → 播放器接管。整個過程沒有一次頁面刷新,這就是 AJAX 加 JSON 的價值所在。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved