「輸入一個 QQ 號,就把對方收藏的音樂列出來直接線上聽」——這個想法看起來有趣,實作難度卻不高,因為整個流程可以拆成三段:算出簽名參數、抓 JSON 資料、把資料餵給播放器。這篇就用 jQuery 搭配 jPlayer 把它跑起來。
展示頁面:https://bejson.com/demos/qqmusic/
QQ 音樂的查詢接口由 bejson 這類平台整理收錄,有興趣可以看他們的接口列表:https://www.bejson.com/webInterface.php,音樂相關的接口就在其中。要注意的是這類第三方整理的公共接口屬於早期產物,可用性與穩定性都不保證,正式專案請改用官方開放平台並依其規範取得授權,不要拿來當生產環境的依賴。
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 會執行字串中的任意程式碼,只要歌名裡出現惡意片段就有風險,能避開就避開。
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 的價值所在。