AMP 影片
AMP 中大多數影片播放器元件都實作了 VideoInterface
API。這表示所有這些元件中都提供了一組功能,完整或部分皆有。
本文件說明這些播放器實作的所有功能 (正在進行中,尚未完成)。
播放器
通用
適用於第三方服務
- amp-3q-player
- amp-brid-player
- amp-brightcove
- amp-dailymotion
- amp-delight-player
- amp-gfycat
- amp-ima-video
- amp-jwplayer
- amp-minute-media-player
- amp-mowplayer
- amp-nexxtv-player
- amp-ooyala-player
- amp-powr-player
- amp-vimeo
- amp-viqeo-player
- amp-wistia-player
- amp-youtube
分析
請參閱影片分析。
自動播放
屬性:autoplay
如果此屬性存在,且瀏覽器支援自動播放
- 影片會在自動播放開始前自動靜音
- 當影片捲動移出檢視畫面時,影片會暫停
- 當影片捲動進入檢視畫面時,影片會繼續播放
- 當使用者輕觸影片時,影片會取消靜音
- 如果使用者曾與影片互動 (例如,靜音/取消靜音、暫停/繼續等),且影片捲動移入或移出檢視畫面,則影片的狀態會維持使用者離開時的狀態。例如,如果使用者暫停影片,然後將影片捲動移出檢視畫面,再返回影片,則影片仍會處於暫停狀態。
如需範例,請造訪AMP By Example。
停駐 (最小化至角落)
屬性:dock
此屬性目前僅支援 amp-brightcove
、amp-dailymotion
、amp-delight-player
、amp-ima-video
、amp-jwplayer
、amp-video
、amp-video-iframe
和 amp-youtube
。
如果此屬性存在且影片為手動播放,當使用者將影片元件捲動移出可視區域時,影片將會「最小化」並固定在角落。
- 使用者可以在不同角落拖曳並重新調整影片位置。
- 同一頁面上的多個影片可以停駐。
為了使用此屬性,必須存在 amp-video-docking
擴充功能指令碼
<script async custom-element="amp-video-docking" src="https://cdn.ampproject.org/v0/amp-video-docking-0.1.js" ></script>
如需更多詳細資訊,請參閱關於停駐擴充功能本身的說明文件。
旋轉至全螢幕
屬性:rotate-to-fullscreen
此屬性目前僅支援 amp-video
、amp-ima-video
和 amp-dailymotion
。
如果此屬性存在且影片為手動播放 (即使用者啟動播放,或在自動播放後輕觸影片),則在使用者將裝置旋轉為橫向模式後,影片會顯示為全螢幕,前提是影片為可見狀態。
當同時有多個設定 rotate-to-fullscreen
屬性的影片可見時,會採用啟發式方法來選擇要在全螢幕中顯示哪個影片。這些啟發式方法依優先順序降序套用如下
- 如果影片為手動播放 (即使用者啟動播放,或在自動播放後輕觸影片)
- 如果影片的可見百分比更高。
- 如果影片更靠近檢視區塊的中心。
- 如果其他條件都相同,則選取最靠近檢視區塊頂端的影片。