Video.js 播放器方法/選項參考


在本教程中,我們將學習 Video.js 的一些基本選項參考。選項參考就像設定一樣,用於控制或修改影片播放器的行為。

這些選項既可以是 HTML5 選項(如自動播放、重新載入等),也可以是 Video.js 特定的設定。我們將逐一檢視這些選項。

標準 HTML5 <video> 元素選項

標準 HTML5 <video> 元素選項是標準設定,適用於 <video> 標籤和 <video-js> 標籤。藉助這些選項,您可以更改影片播放器的高度、寬度、控制元件等。

讓我們討論一些最常見的標準 HTML5 影片選項:

自動播放 (Autoplay)

用法 - 屬性 - HTML 頁面載入後,影片將立即開始播放。

型別 - 布林值

<!DOCTYPE html> <html> <head> <link href="https://vjs.zencdn.net/7.19.2/video-js.css" rel="stylesheet" /> </head> <body> <video autoplay muted src="https://tutorialspoint.tw/videos/myVideo.mp4"> </video> <video-js autoplay muted src="https://tutorialspoint.tw/videos/myVideo.mp4" data-setup='{}'> </video-js> <script src="https://vjs.zencdn.net/7.19.2/video.min.js"></script> </body> </html>

在上例中,您可以看到使用自動播放屬性的兩種方法:使用 <video> 元素標籤和使用 <video-js> 標籤。

注意 - 請確保影片的 src 屬性指向您的影片檔案路徑。

控制元件 (Controls)

用法 - "controls" 屬性允許您在影片播放器上新增按鈕或控制元件,例如播放和暫停。如果沒有 controls 屬性,則只能使用 autoplay 屬性播放影片。

型別 - 布林值

<video controls src="https://tutorialspoint.tw/videos/myVideo.mp4"></video>
<video-js controls src="https://tutorialspoint.tw/videos/myVideo.mp4" data-setup='{}'></video-js>

在上例程式碼中,controls 屬性已新增到 <video> 和 <video-js> 標籤。

高度和寬度 (Height and Width)

用法 - 正如名稱所示,height 和 width 標籤分別允許您更改影片播放器的高度和寬度。

型別 - 字串或數字

<video controls width="320" height="240" src="myVideo.mp4"></video>
<video-js controls width="320" height="240" src="myVideo.mp4" datasetup='{}'></video-js>

正如您在上例中看到的,我們已將兩個影片元素的高度設定為 240 畫素,寬度設定為 320 畫素。

因此,這些是一些常用且最常用的標準 HTML 影片元素選項。在下一節中,我們將瞭解一些 Video.js 特定的設定。

Video.js 元素特定選項

Video.js 特定選項僅適用於 <video-js> 標籤,而不適用於標準 <video> 標籤。除非指定,否則每個設定的預設值為 *undefined*。

讓我們看看一些 Video.js 元素特定的選項:

縱橫比 (aspectRatio)

用法 - 此選項使影片播放器更流暢,aspectRatio 引數的值用於動態計算播放器的大小。aspectRatio 的值應為兩個用冒號分隔的數字的比率。例如:"21:9"

型別 - 字串

<video-js aspectRatio="21:9" src="myVideo.mp4" data-setup='{}'></video-js>

在上例中,aspectRatio 已設定為 21:9。除此之外,還可以使用類 "vjs-21-9" 來實現相同的效果。

<video-js class="vjs-21-9" src="myVideo.mp4" data-setup='{}'></video-js>

僅音訊模式 (audioOnlyMode)

用法 - 設定為 true 時,所有播放器元件(除控制欄外)都將隱藏,以及僅影片所需的控制欄元件。

型別 - 布林值 (true/false)

<video-js aspectRatio="21:9" audioOnlyMode="true" src="myVideo.mp4" datasetup='{}'></video-js>

在上例程式碼中,audioOnlyMode 屬性已設定為 true。這將隱藏影片的所有影片播放器元件。

流暢 (Fluid)

用法 - 要使影片播放器流暢,此選項應設定為 true。它將縮放影片播放器大小以適應影片的內部縱橫比或指定的比率。

型別 - 布林值

<video-js aspectRatio="21:9" fluid="true" src="myVideo.mp4" datasetup='{}'></video-js>

在上例中,影片播放器大小將縮放以適應給定的縱橫比,即 21:9。如果沒有提供縱橫比,則 fluid 屬性將設定為影片的固有比率。

播放速率 (playbackRates)

用法 - playbackRates 允許您顯示控制元件,讓使用者控制影片的播放速度。播放速率的值必須是一個嚴格大於 1 的陣列。播放值“1”表示常規速度,“2”表示影片速度的兩倍,依此類推。播放速率從下到上顯示。

型別 - 陣列

<!DOCTYPE html> <html> <head> <link href="https://vjs.zencdn.net/7.19.2/video-js.css" rel="stylesheet" /> </head> <body> <video-js controls id="myVideo" data-setup='{"playbackRates": [0.5, 1,1.5, 2, 3]}'> <source src="https://tutorialspoint.tw/videos/video1.mp4/sample720.mp4" > </video-js> <script src="https://vjs.zencdn.net/7.19.2/video.min.js"></script> </body> </html>

在此程式碼片段中,我們已將播放速率新增到 data-setup 中的影片播放器選項。因此,播放速度控制器將顯示 0.5、1、1.5、2 和 3 作為播放速率。

使用者操作 (userActions)

用法 - userActions 具有多種功能,可以更改使用者與影片播放器互動的方式。

型別 - 物件

userAction.click - 這是一個布林值或函式型別選項,用於控制使用者單擊播放器的行為。如果此選項的值設定為 false,則不允許使用者在暫停和播放之間切換。

<!DOCTYPE html> <html> <head> <link href="https://vjs.zencdn.net/7.19.2/video-js.css" rel="stylesheet" /> </head> <body> <video-js autoplay muted aspectRatio="21:9" fluid="true" id="myVideo"data-setup='{}'> <source src="https://tutorialspoint.tw/videos/sample480.mp4" type="video/mp4"></source> </video-js> <script src="https://vjs.zencdn.net/7.19.2/video.min.js"> videojs("myVideo", {"userActions": {"click": false }});</script> </body> </html>

在上例程式碼片段中,使用了 userActions.click,並將其值設定為 id 為“myVideo”的影片播放器的值。

如果“userActions.click”的值設定為 undefined 或 true,則啟用單擊和播放/暫停切換。

userAction.doubleClick - doubleClick 也是一個布林值和函式型別選項,用於控制影片上的雙擊操作。

如果此選項的值設定為 false,則設定不允許雙擊影片。如果其值為 true 或 undefined,則允許雙擊,並且它將切換全屏模式。還可以使用單擊處理程式函式覆蓋預設的全屏切換操作。

<!DOCTYPE html> <html> <head> <link href="https://vjs.zencdn.net/7.19.2/video-js.css" rel="stylesheet" /> </head> <body> <video-js controls autoplay muted aspectRatio="21:9" fluid="true" id="myVideo" data-setup='{}'> <source src="https://tutorialspoint.tw/videos/sample480.mp4" type="video/mp4"></source> </video-js> <script src="https://vjs.zencdn.net/7.19.2/video.min.js"> videojs("myVideo", {"userActions": {"doubleClick": true }}); </script> </body> </html>

在上例程式碼中,對於 id 為“myVideo”的影片播放器,“userActions.doubleClick”已設定為 true。它將啟用影片上的雙擊,並將影片設定為全屏模式。

結論

在本教程中,我們學習了 Video.js 庫的一些方法參考或選項參考。我們瞭解了一些標準的 HTML5 選項,這些選項同時適用於 <video> 和 <video-js>。之後,我們看到了一些 Video.js 特定的設定,這些設定僅適用於 <video-js> 標籤,並允許您進一步控制影片播放器的行為和操作。

更新於:2023年4月4日

931 次瀏覽

啟動您的 職業生涯

完成課程獲得認證

開始學習
廣告