以下是自己整理的全螢幕播放寫法筆記,涵蓋 Windows Media Player 與 RealPlayer 兩大播放器。當年為了這些片段耗掉不少時間,留著以後查用。
核心只有一行:把 DisplaySize 設為 3 即進入全螢幕,使用者按 Esc 可退出。
<script language="JavaScript">
var Real = 'MediaPlayer1.';
function DoFull() {
eval(Real + 'DisplaySize=3');
}
</script>
<input type="button" onMouseDown="DoFull()" value="全屏顯示">
<span>ESC 返回</span>
搭配的 object 宣告大致如下,關鍵是 id 要與前面 JS 的字串一致,且 EnableFullScreenControls 若設 0,就把全螢幕控制權交給自訂按鈕:
<object id="MediaPlayer1" classid="clsid:22D6F312-B0F6-11D0-94AB-0080C74C7E95" width="468" height="358"> <param name="filename" value="/film/play.asp"> <param name="AutoStart" value="-1"> <param name="ShowControls" value="-1"> <param name="ShowStatusBar" value="-1"> <param name="EnableFullScreenControls" value="0"> <param name="DisplaySize" value="4"> <param name="enableContextMenu" value="0"> </object>
也有人把 DisplaySize 直接寫成 2(200%)並保留完整的 Show* 與快捷鍵、右鍵選單,看起來更接近原生播放器的操作手感,可依需求挑。
RealPlayer 的 ActiveX 控制項 RAOCX 提供 SetFullScreen() 方法,包成函式後掛到按鈕即可:
<SCRIPT language="javascript">
Real = 'document.RAOCX.';
function DoPlay() { eval(Real + 'DoPlay()'); }
function DoStop() { eval(Real + 'DoStop()'); }
function DoPlayPause() { eval(Real + 'DoPlayPause()'); }
function SetFullScreen() {
eval(Real + 'SetFullScreen()');
fullscreen = true;
DoPlayPause();
DoPlay();
}
</SCRIPT>
<a href="#" onclick="SetFullScreen()"
title="全螢幕欣賞,按 ESC 鍵還原">□ 全屏播放 □</a>
注意這裡呼叫全螢幕前後各做了一次暫停與播放,是為了讓播放器重新套用尺寸設定。
另一種常見結構是把影像視窗與控制列拆成兩個 object,用同一個 CONSOLE 值(例如 Clip1)綁在一起,控制列那顆只放 ControlPanel,影像那顆只放 ImageWindow:
<OBJECT classid="clsid:CFCDAA03-8BE4-11cf-B84B-0020AFBBCCFA"
id="RAOCX" width="376" height="248">
<PARAM NAME="SRC" VALUE="movie.rm">
<PARAM NAME="CONSOLE" VALUE="Clip1">
<PARAM NAME="CONTROLS" VALUE="ImageWindow">
<PARAM NAME="AUTOSTART" VALUE="true">
</OBJECT>
<OBJECT classid="CLSID:CFCDAA03-8BE4-11CF-B84B-0020AFBBCCFA"
id="video2" width="376" height="24">
<PARAM NAME="SRC" VALUE="movie.rm">
<PARAM NAME="CONTROLS" VALUE="ControlPanel">
<PARAM NAME="CONSOLE" VALUE="Clip1">
</OBJECT>
接著用 document.RP1.SetFullScreen() 呼叫全螢幕。這種寫法的優點是版面配置自由,控制列要放上面或下面都行。
RealOne 的元件名稱不同,全螢幕前建議先確認是否已在播放,否則會失敗:
<script>
function setFull() {
if (!document.playfull.CanStop()) {
alert("影片未開始播放,無法切換為全螢幕模式");
} else {
alert("按確定後進入全螢幕播放模式,按 Esc 鍵退出");
document.playfull.SetFullScreen();
}
}
</script>
<a href="#" onclick="setFull();">全屏</a>
這三段程式碼都建立在同兩個前提上:ActiveX 元件可用、且控制項名稱固定。這兩點在今天的瀏覽器已完全不成立,RealPlayer 的網頁插件也早已退場。
現在要全螢幕播放,標準做法是 HTML5 的 Fullscreen API:
<video id="v" controls src="movie.mp4"></video>
<button onclick="document.getElementById('v').requestFullscreen()">全螢幕</button>
要注意的是,requestFullscreen() 必須在使用者點擊等直接互動的呼叫堆疊中觸發,放在 setTimeout 或 AJAX 回呼裡會被瀏覽器拒絕;iOS Safari 上的 video 元素還需改用 webkitEnterFullscreen()。屬性層級的做法則是把 controlsList 與 disablePictureInPicture 搭配使用,決定要保留哪些原生控制項。