本文是 HTML5 系列教學的第三部分(共三部分)。在前兩部分中,我們談到了 video 與 audio 元素,並簡短示範了如何為這些元素加上 controls 屬性,讓瀏覽器套用媒體元素的預設控制。如果你實際試過,應該會發現各瀏覽器的預設外觀並不一致。
如果你希望媒體元素在各瀏覽器下呈現相同樣式,就可以善用 HTML5 媒體元素提供的便捷 API:一方面用標準的 HTML 與 CSS 掌控外觀,另一方面則透過 media 元素的 API 來操控 audio 與 video。
本篇詳細說明了打造一個自訂媒體播放器的各個步驟,逐步加入不同特色與功能,並靈活運用各項 API 屬性、事件與方法。本文以 video 元素為例,但 audio 的處理方式同理可證。
熟悉 HTML 與 JavaScript;適合具備中級程度、想深入理解媒體 API 的開發者。
第一步,先在頁面中定義一個 video 元素:
<video id="video" controls> <source src="grass-in-the-wind-sma.mp4" type="video/mp4"> <source src="grass-in-the-wind-sma.webm" type="video/webm"> </video>
注意這裡先保留了 controls 屬性。由於自訂控制需要用到 JavaScript,我們會先用 JS 把預設控制關掉。這樣一來,萬一使用者停用 JS,仍能使用瀏覽器自帶的預設控制。
要透過 JS 關閉預設控制,只需把 video 元素的 controls 屬性設為 false:
<script>
// 取得 video 元素的參照
var video = document.getElementById("video");
// 關閉預設控制
video.controls = false;
</script>
對大多數播放器而言,最基本的需求就是播放與暫停。這個範例只用了單一按鈕:暫停時顯示為「播放」,播放時則顯示為「暫停」。
<div id="controls"> <button id="playpause" title="play">Play</button> </div>
接著建立一個 JS 函式,用來切換按鈕的 title 屬性,並實現播放與暫停。這個函式取名為 togglePlayPause():
function togglePlayPause() {
var playpause = document.getElementById("playpause");
if (video.paused || video.ended) {
playpause.title = "pause";
playpause.innerHtml = "pause";
video.play();
} else {
playpause.title = "play";
playpause.innerHtml = "play";
video.pause();
}
}
要讓這個函式在每次點擊時被呼叫,把它掛到 button 標籤的 onclick 事件上即可:
<button id="playpause" title="play" onclick="togglePlayPause()">Play</button>
函式第一行先取得播放/暫停按鈕自身的參照,賦值給變數 playpause:
var playpause = document.getElementById("playpause");
接著透過 paused 與 ended 兩個屬性檢查影片狀態。若影片處於暫停或結束狀態,就把按鈕的 title 與 innerHtml 設為「pause」,並呼叫 video.play() 播放;反之若不在這兩個狀態,則視為正在播放,於是將按鈕文字設為「play」,並呼叫 video.pause() 暫停。
如你所見,後續介紹的功能都遵循同樣的模式:為 video 元素加上監聽器、檢查元素當前狀態,然後呼叫對應的 API 方法。
音量控制(含靜音)是播放器不可或缺的功能。要加入音量控制,可使用 HTML5 新增的 range 輸入型別,瀏覽器會將它渲染成一個可左右拖動的滑桿,並可透過 min、max 屬性指定範圍、以 step 屬性設定每次滑動的幅度:
<input id="volume" min="0" max="1" step="0.1" type="range" />
當滑桿滑動時需要調整音量,只要設定 onchange 屬性呼叫 JS 監聽器:
<input id="volume" min="0" max="1" step="0.1" type="range" onchange="setVolume()" />
接著建立名為 setVolume() 的函式:
function setVolume() {
var volume = document.getElementById("volume");
video.volume = volume.value;
}
這個簡短的函式負責讀取音量滑桿的值,並賦給 video 元素的 volume 屬性。值得留意的是,早期 Firefox 7 不支援 range 型別,會退化成文字欄位;此時可手動輸入 0~1 的值並點擊其他位置使其失焦,同樣能達到調整音量的效果。
靜音按鈕也很簡單,一樣定義一個帶 onclick 的新按鈕:
<button id="mute" onclick="toggleMute()">Mute</button>
再建立名為 toggleMute() 的函式:
function toggleMute() {
video.muted = !video.muted;
}
這個功能把 video 元素的 muted(布林值)設為目前值的相反值,藉此切換靜音狀態。非常直觀!
使用者習慣在觀看影片時掌握已播放多少、還剩多少。要加入簡單的進度條,可用 div 與 span 標籤,透過增加 span 的寬度來顯示進度。
<div id="progressBar"> <span id="progress"></span> </div>
當然,也要搭配一些 CSS 才能看出 span 的效果:
#progressBar {
border:1px solid #aaa; color:#fff;
width:295px; height:20px;
}
#progress {
background-color:#ff0000; // red
height:20px;
display:inline-block;
}
接著定義一個函式,透過改變 span 元素的 width 來更新進度條:
function updateProgress() {
var progress = document.getElementById("progress");
var value = 0;
if (video.currentTime > 0) {
value = Math.floor((100 / video.duration) * video.currentTime);
}
progress.style.width = value + "%";
}
這個函式先取得進度 span 的參照,接著檢查 video 元素的 currentTime(以秒計的當前播放位置)。若 currentTime 大於 0,代表影片已開始播放,於是透過 duration(影片總長度,以秒計)計算目前進度的百分比,最後把結果賦給進度 span 的 CSS width。
先前的播放、暫停、靜音都可用 onclick、onchange 等事件呼叫函式,但進度條不同——它響應的是影片進度,而非使用者互動。為此,HTML5 媒體元素 API 提供了 timeupdate 事件:每當 currentTime 改變時便會觸發(也就是影片開始播放後會連續不斷觸發)。在初始化程式碼中加上事件監聽器即可:
video.addEventListener("timeupdate", updateProgress, false);
如此一來,進度條就會隨著影片播放而不斷更新。
Media 元素 API 定義了許多事件,可用來完善你的播放器。以下列出幾個常用事件:
使用自訂控制機制時,監聽這些事件來確保介面狀態即時同步,會是比較好的體驗。介面為何會不同步?當你用 JS 關掉預設控制、改由使用者透過其他方式(例如在 Firefox 下於影片上按右鍵選單)操作影片時,你自訂的介面就可能無法即時反映目前的影片狀態。但無論用哪種方式控制,對應事件總會被觸發,因此可監聽 play 與 pause 事件來同步:
video.addEventListener('play', function() {
var playpause = document.getElementById("playpause");
playpause.title = "pause";
playpause.innerHtml = "pause";
}, false);
video.addEventListener('pause', function() {
var playpause = document.getElementById("playpause");
playpause.title = "play";
playpause.innerHtml = "play";
}, false);
你也應該監聽 ended 事件,讓影片結束時播放/暫停按鈕能即時更新。當 ended 觸發時,可呼叫影片的 pause() 方法:
video.addEventListener('ended', function() {
this.pause();
}, false);
之所以在這裡呼叫 pause(),是因為如此能觸發 pause 事件,進而呼叫我們前面寫好的 pause 事件處理器。當然,你也可以直接把相關程式碼複製到 ended 監聽器中,或依自身擴充需求另行定義。
最後一個功能是媒體播放清單,讓使用者切換播放器中的影片。首先定義播放清單:
<ul id="playlist">
<li><a href="#" onclick="playlistClick('grass-in-the-wind-sma');">Grass blowing in the wind</a></li>
<li><a href="#" onclick="playlistClick('tree-in-the-wind-sma');">Trees blowing in the wind</a></li>
</ul>
清單中的每個項目被點擊時,都會呼叫名為 playlistClick() 的函式,參數為要播放的檔案位址(不含副檔名)。函式定義如下:
function playlistClick(file) {
var v = document.createElement("video");
if (v.canPlayType("video/mp4") != "") {
changeSource(file + ".mp4");
}
else if (v.canPlayType("video/webm") != "") {
changeSource(file + ".webm");
}
return false;
}
這個函式先產生一個臨時 video 元素,再對每種支援的影片格式呼叫 canPlayType()(此例為 MP4 與 WebM)。確認瀏覽器能播放的格式後,呼叫只有一個參數的 changeSource(),傳入帶有合適副檔名的檔名,並回傳 false 以避免連結跳轉到 href 的值。
changeSource() 的定義如下:
function changeSource(src) {
resetPlayer();
video.src = src;
video.load();
}
這個函式先呼叫稍後會看到的 resetPlayer(),接著把 video 元素的 src 設為新傳入的影片檔,最後呼叫 load() 將新來源載入 video 元素。注意:並非所有瀏覽器都要求呼叫 load(),但 Safari 需要,因此呼叫它是個好習慣。
resetPlayer() 為了準備載入新影片,會重置部分播放器元件:
function resetPlayer() {
var playpause = document.getElementById("playpause");
playpause.title = "play";
playpause.innerHtml = "play";
if (video.currentTime > 0) video.currentTime = 0;
updateProgress();
}
它先把播放/暫停按鈕文字設為「play」,接著若 currentTime 不為 0 就重設為 0,最後呼叫 updateProgress() 把進度條歸零(進度條依賴 currentTime,設為 0 即可)。
就是這樣!你已經掌握打造一個簡單 HTML5 媒體播放器所需的所有關鍵步驟。雖然這個播放器的外觀還不夠吸引人,但只要善用 CSS 樣式,就能大幅改善它的視覺呈現。想深入了解媒體元素 API、其事件與執行時屬性,可參考 W3C 的 HTML5 Video Events and API 展示頁面。