做過網頁音訊的人,大概都碰過同一個老問題:一份 Flash 播放器在 IE 上跑得順順的,換到 Firefox 或 Chrome 就因為外掛限制而動彈不得。HTML5 的 audio 標準出現之後,這道難題總算有了正規解法,但「能播放」跟「好用」完全是兩回事——進度條、音量控制、循環播放、歌詞隨時間滾動,這些細節才是使用者真正有感的部分。
本文以 jPlayer 為播放核心,搭配 jQuery 與一支 LRC 解析腳本,做出一個向下相容 IE6 到 IE9、同時支援 Chrome、Firefox、Opera 等主流瀏覽器的播放器,並附上完整程式碼與實作說明。
jPlayer 最實用的地方在於它的「雙軌方案」:在支援 HTML5 的瀏覽器裡使用原生音訊,遇到舊版 IE 時自動退回 Flash 播放,同一份程式碼就能覆蓋兩種環境。設定裡的 solution 屬性決定了嘗試順序,supplied 則宣告音訊格式,兩者搭配就能把相容性問題交給函式庫處理。
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>歌詞同步播放器</title>
<meta http-equiv="Cache-Control" content="no-cache">
<meta name="viewport" content="width=device-width; initial-scale=1.0; minimum-scale=1.0; maximum-scale=1.4">
<meta name="MobileOptimized" content="240">
<link href="/mp3/css/blue.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="/mp3/js/jquery.js"></script>
<script type="text/javascript" src="/mp3/js/jquery.jplayer.js"></script>
<script type="text/javascript" src="/mp3/js/lrc.js"></script>
<style type="text/css">
* { margin: 0; padding: 0; }
ul, ol, dl { list-style: none; }
.content li.hover { color: red; }
.content { width: 402px; height: 200px; background: #ccc; overflow: hidden; padding: 10px; }
</style>
<script>
//<![CDATA[
$(document).ready(function () {
$("#jquery_jplayer_1").jPlayer({
ready: function (event) {
$(this).jPlayer("setMedia", {
mp3: "yangcong.mp3" // mp3 的播放位址
}).jPlayer("play");
},
timeupdate: function (event) {
// 把當前播放秒數記到 time,供歌詞比對使用
if (event.jPlayer.status.currentTime == 0) {
time = "";
} else {
time = event.jPlayer.status.currentTime;
}
},
play: function (event) {
// 有歌詞就啟動 lrc.start,並回傳目前時間
if (event.jPlayer.status.currentTime == 0) {
$("#jquery_jplayer_1").jPlayer("pause", 1);
}
if ($('#lrc_content').val() !== "") {
$.lrc.start($('#lrc_content').val(), function () { return time; });
} else {
$(".content").html("沒有字幕");
}
},
repeat: function (event) {
if (event.jPlayer.options.loop) {
$(this).unbind(".jPlayerRepeat")
.bind($.jPlayer.event.ended + ".jPlayer.jPlayerRepeat", function () {
$(this).jPlayer("play");
});
} else {
$(this).unbind(".jPlayerRepeat");
}
},
swfPath: "/js", // jplayer.swf 的存放路徑
solution: "html, flash", // 播放方案與順序
supplied: "mp3", // 支援的音訊格式
wmode: "window"
});
$("#lrc_content").hide();
});
//]]>
</script>
</head>
<body>
<!-- 歌詞資料先放在 textarea 裡,實際專案可改由後端輸出 -->
<textarea id="lrc_content" name="textfield" cols="70" rows="10">
[ar:測試用]
[ti:洋蔥]
[00:03.00]洋蔥
[00:06.00]演唱:平安
[00:11.38]如果你眼神能夠為我片刻的降臨
[00:21.23]如果你能聽到心碎的聲音
[00:28.88]盤底的洋蔥像我永遠是配角戲
[00:44.90]如果你願意一層一層
[00:48.46]一層的剝開我的心
[00:52.66]你會發現你會訝異
[00:56.40]你是我最壓抑最深處的秘密
...... 其餘行格式相同,時間標籤在前、歌詞在後 ......
</textarea>
<div id="jquery_jplayer_1" class="jp-jplayer"></div>
<div id="jp_container_1" class="jp-audio">
<div class="jp-type-single">
<div class="jp-gui jp-interface">
<ul class="jp-controls">
<li><a href="javascript:;" class="jp-play" tabindex="1">play</a></li>
<li><a href="javascript:;" class="jp-pause" tabindex="1">pause</a></li>
<li><a href="javascript:;" class="jp-stop" tabindex="1">stop</a></li>
<li><a href="javascript:;" class="jp-mute" tabindex="1" title="mute">mute</a></li>
<li><a href="javascript:;" class="jp-unmute" tabindex="1" title="unmute">unmute</a></li>
<li><a href="javascript:;" class="jp-volume-max" tabindex="1" title="max volume">max volume</a></li>
</ul>
<div class="jp-progress">
<div class="jp-seek-bar"><div class="jp-play-bar"></div></div>
</div>
<div class="jp-volume-bar"><div class="jp-volume-bar-value"></div></div>
<div class="jp-time-holder">
<div class="jp-current-time"></div>
<div class="jp-duration"></div>
</div>
<ul class="jp-toggles">
<li><a href="javascript:;" class="jp-repeat" tabindex="1" title="repeat">repeat</a></li>
<li><a href="javascript:;" class="jp-repeat-off" tabindex="1" title="repeat off">repeat off</a></li>
</ul>
</div>
<div class="jp-title">
<ul><li>mp3 player</li></ul>
</div>
<div class="jp-no-solution">
<span>Update Required</span>
要播放媒體,請更新瀏覽器或安裝 Flash 外掛。
</div>
</div>
</div>
<div class="content">
<ul id="lrc_list">點擊開始播放……</ul>
</div>
</body>
</html>
歌詞同步的資料流。LRC 檔本質上就是「時間標籤 + 文字」的清單。timeupdate 事件每一輪都會帶回 event.jPlayer.status.currentTime,把它寫進全域變數 time,再交給 $.lrc.start() 的第二個參數當回呼,插件就能依此比對目前該高亮哪一行。
沒有歌詞的降級處理。先判斷 textarea 內容是否為空字串,空的時候直接把提示文字寫進 .content,避免插件拿到無效資料而拋錯。
循環播放。jPlayer 的 loop 選項在部分瀏覽器上行為不一致,因此這裡改用監聽 ended 事件、播放結束後重新觸發 play 的方式,跨瀏覽器表現更穩定。
路徑別寫死。swfPath 與 CSS、JS 的引用路徑都要依實際目錄結構調整,這是最常見的「本機正常、上線失效」原因。
HTML5 音訊真正的價值不是取代 Flash,而是把播放能力還給瀏覽器標準;再加上 jPlayer 這類具備降級能力的函式庫,就能用一份程式碼同時照顧新舊環境。把歌詞同步、進度拖曳、音量與循環這些模組接上之後,一個够水準的播放器其實只需要不到兩百行設定碼。