互動式視訊

互動式視訊檢視器是播放以H.264格式編碼的串流和漸進式視訊的視訊播放器。

檢視器檢視器也會在視訊內容旁顯示互動式產品色票。 同時支援單一視訊和最適化視訊集。 它可在支援HTML5視訊的案頭和行動網頁瀏覽器上運作。 檢視器支援視訊內容上方顯示的選擇性隱藏字幕、視訊章節導覽和社交分享工具。 此檢視器的目的是協助您建置「可購買的視訊」體驗。 也就是說,使用者可以選取與特定視訊時區相關聯的色票,並重新導向至客戶網站上的快速檢視或產品詳細資訊頁面。

檢視器類型為510。

示範URL

https://marketing.adobe.com/resources/help/en_US/dm/shoppable-video/glacier/InteractiveVideoViewerDemo.html

https://marketing.adobe.com/resources/help/en_US/dm/shoppable-video/AXIS/index.html

系統要求

請參閱系統需求

使用互動式視訊檢視器

互動式視訊檢視器代表主要JavaScript檔案和一組輔助檔案(單一JavaScript包含此特定檢視器、資產和CSS所使用的所有檢視器SDK元件),由檢視器在執行時期下載。

互動式視訊檢視器可在快顯模式下使用Image Serving檢視器隨附的可立即生產使用的HTML頁面。 它也可以在內嵌模式中使用,在此模式中,它會使用檔案化的API整合到目標網頁中。

設定和外觀設定與本指南中說明的其他檢視器類似。 所有外觀設定都是透過自訂(CSS)階層式樣式表來實現。

請參閱所有檢視器通用的命令參考——設定屬性所有檢視器通用的命令參考- URL

與互動式視訊檢視器互動

互動式視訊檢視器提供一組標準的視訊播放使用者介面控制項,例如播放/暫停按鈕、視訊筆畫、視訊時間泡泡、播放時間/總時間指示器、音量控制、全螢幕按鈕和隱藏字幕切換。 所有這些控制項都會直接在主檢視下方分組為控制列。

請注意,在觸控裝置上,音量控制會從使用者介面中隱藏,因為只有使用裝置的硬體按鈕才能控制音量。

當檢視器在快顯模式下運作時,使用者介面中就無法使用全螢幕按鈕。

檢視器會在視訊檢視區域右側顯示具有互動色票的面板。 當視訊播放時,色票清單會自動前進,以顯示與目前視訊區域對應的色票。 按一下或點選色票會觸發在作者期間與此色票關聯的動作。 視您的設定而定,觸發器可能會重新導向至網站上的不同頁面,或將產品資訊傳回網頁邏輯,而網頁邏輯則會觸發開啟顯示相關產品內容的快速檢視。

在啟動視訊旁白時,可快速導覽視訊內容。 視訊章節會在視訊筆畫軌道中顯示為標籤,並在滑鼠指向(或在觸控系統上按一下滑鼠)時顯示章節標題和說明。 客戶可以按一下章節標籤或點選章節描述泡泡,以「尋找」特定章節。

檢視器也支援各種社交媒體分享工具。 使用者介面中的單一按鈕可供使用,當使用者點選或點選時,此按鈕會展開為共用工具列。 共用工具列包含每種支援分享管道類型的圖示,例如Facebook、Twitter、電子郵件分享、內嵌代碼分享和連結分享。 當啟用電子郵件共用、內嵌共用或連結共用工具時,檢視器會顯示包含對應資料輸入表單的強制對話方塊。 呼叫Facebook或Twitter時,檢視器會將使用者從社交媒體服務重新導向至標準共用對話方塊。 此外,當共用工具啟動時,會自動暫停視訊播放。 由於網頁瀏覽器的安全性限制,共用工具無法在全螢幕模式下使用。

檢視器可完全透過鍵盤存取。 請參閱鍵盤協助功能和導覽

內嵌互動式視訊檢視器

互動式視訊檢視器可內嵌至代管頁面。 這種網頁可以具有靜態版面,或者可以是「自適應」的,並在不同裝置上或不同瀏覽器視窗大小顯示不同。

為滿足這些需求,檢視器支援兩種主要作業模式:固定大小內嵌和回應式內嵌。

關於固定大小嵌入模式和自適應設計嵌入模式

在內嵌模式中,檢視器會新增至現有的網頁,而現有網頁可能已有與檢視器無關的客戶內容。 檢視器通常只佔用網頁的部分空間。

主要使用案例是針對桌上型電腦或平板電腦裝置的網頁,以及回應式設計的頁面,可根據裝置類型自動調整版面。

當檢視器在初始載入後未變更其大小時,會使用固定大小內嵌。 這是具有靜態版面的網頁的最佳選擇。

回應式設計內嵌假設檢視器可能需要在執行時期調整大小,以回應其容器DIV的大小變更。 最常見的使用案例是將檢視器新增至使用彈性頁面版面的網頁。

在回應式設計內嵌模式中,檢視器的運作方式會因網頁大小的容器DIV而異。 如果網頁僅設定容器的寬度DIV,而不限制其高度,檢視器會根據所使用資產的寬高比自動選擇其高度。 此功能可確保資產完美整合至檢視中,而不會在側邊產生任何填補空間。 此使用案例是使用互動式網頁設計版面架構(例如Bootstrap、基礎等)的網頁最常見的使用案例。

否則,如果網頁同時設定檢視器容器DIV的寬度和高度,檢視器只會填滿該區域,並遵循網頁版面所提供的大小。 一個很好的例子是將檢視器內嵌至模態覆蓋,其中覆蓋會根據網頁瀏覽器視窗大小而調整大小。

固定大小內嵌

您可執行下列動作,將檢視器新增至網頁:

  1. 將檢視器JavaScript檔案新增至您的網頁。

  2. 定義容器DIV

  3. 設定檢視器大小。

  4. 建立和初始化檢視器。

  5. 將檢視器JavaScript檔案新增至您的網頁。

    建立檢視器時,您必須在HTML標題中新增指令碼標籤。 請務必加入InterativeVideoViewer.js,才能使用檢視器API。 InteractiveVideoViewer.js檔案位於標準IS-Viewer部署的html5/js/子資料夾下:

<s7viewers_root>/etc/dam/viewers/s7viewers/html5/js/InteractiveVideoViewer.js

如果檢視器部署在其中一個Adobe的Dynamic Media經典伺服器上,且是從相同網域提供,則可使用相對路徑。 否則,您將指定到安裝IS-Viewer的AdobeDynamic Media經典伺服器之一的完整路徑。

相對路徑如下所示:

<script language="javascript" type="text/javascript" src="/etc/dam/viewers/s7viewers/html5/js/InteractiveVideoViewer.js?lang=zh-Hant"></script>
注意

您只應在頁面上參考主要檢視器JavaScript include檔案。 您不應在網頁程式碼中參考檢視器邏輯在執行時期中可能下載的任何其他JavaScript檔案。 尤其是,請勿直接參考檢視器從/s7viewers內容路徑載入的HTML5 SDK Utils.js程式庫(稱為統一SDK include)。 原因是Utils.js或類似的執行時期檢視器程式庫的位置完全由檢視器的邏輯管理,而檢視器版本間的位置也會變更。 Adobe不會在伺服器上保留舊版次要檢視器includes

因此,將檢視器使用的任何次要JavaScript include直接參考放在頁面上,將來部署新產品版本時,檢視器功能會中斷。

  1. 定義容器DIV

    將空的DIV元素新增至您要檢視器出現的頁面。 DIV元素必須已定義其ID,因為此ID稍後會傳遞至檢視器API。 DIV的大小是透過CSS指定的。

    預留位置DIV是定位的元素,這表示position CSS屬性已設為relativeabsolute

    若要讓全螢幕功能在Internet Explorer中正常運作,請確定DOM中沒有其他元素的堆疊順序高於預留位置DIV

    以下是已定義的佔位符DIV元素的示例:

    <div id="s7viewer" style="position:relative"></div>
    
  2. 設定檢視器大小

    您可以設定檢視器的靜態大小,方法是以絕對單位聲明.s7interactivevideoviewer頂層CSS類別,或使用stagesize修飾元。

    您可以直接在HTML頁面上或自訂檢視器CSS檔案中放入CSS大小,然後再將檔案指派給AEM Assets的檢視器預設記錄——隨選,或使用style命令明確傳遞。

    如需使用CSS設定檢視器樣式的詳細資訊,請參閱自訂互動式視訊檢視器

    以下是在HTML頁面中定義靜態檢視器大小的範例:

    #s7viewer.s7interactivevideoviewer { 
     width: 640px; 
     height: 640px; 
    }
    

    您可以在AEM Assets的檢視器預設記錄中設定stagesize修飾元——隨選。 或者,您可以透過檢視器初始化程式碼與params系列明確傳遞,或像「命令參考」區段中所述,以API呼叫的形式傳遞,例如:

    interactivevideoviewer.setParam("stagesize", "640,640");
    

    建議使用以CSS為基礎的方法,並在此範例中使用。

  3. 建立和初始化檢視器。

    完成上述步驟後,您將建立一個s7viewers.InteractiveVideoViewer類的實例,將所有配置資訊傳遞給其建構子,並在查看器實例上調用init()方法。 設定資訊會以JSON物件的形式傳遞至建構函式。 至少,此物件應具有containerId欄位,此欄位包含檢視器容器ID的名稱,並巢狀內嵌params JSON物件,且檢視器支援設定參數。

    在這種情況下,params物件至少必須將「影像伺服URL」傳遞為serverUrl屬性,並將初始資產傳遞為asset參數。 以JSON為基礎的初始化API可讓您使用單一程式碼行、以videoserverurl屬性傳遞的視訊伺服器URL、以asset參數傳遞的初始資產,以及以interactivedata屬性傳遞的互動式資料來建立和啟動檢視器。 以JSON為基礎的初始化API可讓您使用單行程式碼來建立和啟動檢視器。

    請務必將檢視器容器新增至DOM,如此檢視器程式碼就能依其ID找到容器元素。 有些瀏覽器會延遲建立DOM,直到網頁結束為止。 為獲得最大相容性,請在BODY結束標籤之前或在主體onload()事件上調用init()方法。

    同時,容器元素也不一定是網頁版面的一部分。 例如,它可能會使用指派給它的display:none樣式進行隱藏。 在此情況下,檢視器會延遲其初始化程式,直到網頁將容器元素帶回版面為止。 此時,檢視器載入會自動繼續。

    以下是建立檢視器例項的範例,將最小必要的設定選項傳遞至建構函式並呼叫init()方法。 該示例假設如下:

    • 檢視器例項為interactiveVideoViewer
    • 佔位符DIV的名稱為s7viewer
    • 影像伺服URL為https://aodmarketingna.assetsadobe.com/is/image/
    • 視訊伺服器URL為https://gateway-na.assetsadobe.com/DMGateway/public/aodmarketingna
    • 內容URL為https://aodmarketingna.assetsadobe.com/
    • 資產為/content/dam/mac/aodmarketingna/dm-viewers-content/video/Glacier.mp4
    • 互動資料為is/content/content/dam/mac/aodmarketingna/_VTT/dm-viewers-content/video/Glacier.mp4.svideo.vtt
    <script type="text/javascript"> 
    var interactiveVideoViewer = new s7viewers.InteractiveVideoViewer({ 
     "containerId":"s7viewer", 
    "params":{ 
     "asset":"/content/dam/mac/aodmarketingna/dm-viewers-content/video/Glacier.mp4", 
    "config":"/etc/dam/presets/viewer/Shoppable_Video_Dark", 
     "serverurl":"https://aodmarketingna.assetsadobe.com/is/image/", 
     "videoserverurl":"https://gateway-na.assetsadobe.com/DMGateway/public/aodmarketingna", 
     "contenturl":"https://aodmarketingna.assetsadobe.com/", 
    "interactivedata":"is/content/content/dam/mac/aodmarketingna/_VTT/dm-viewers-content/video/Glacier.mp4.svideo.vtt" 
    } 
    }).init(); 
    </script>
    

    以下程式碼是內嵌固定大小之互動式視訊檢視器之簡單網頁的完整範例:

    <!DOCTYPE html> 
    <html> 
    <head> 
    <script type="text/javascript" src="https://aodmarketingna.assetsadobe.com/etc/dam/viewers/s7viewers/html5/js/InteractiveVideoViewer.js"></script> 
    <style type="text/css"> 
    #s7viewer.s7interactivevideoviewer { 
     width: 640px; 
     height: 480px; 
    } 
    </style> 
    </head> 
    <body> 
    <div id="s7viewer" style="position:relative;"></div> 
    <script type="text/javascript"> 
    var interactiveVideoViewer = new s7viewers.InteractiveVideoViewer({ 
     "containerId":"s7viewer", 
    "params":{ 
     "asset":"/content/dam/mac/aodmarketingna/dm-viewers-content/video/Glacier.mp4", 
    "config":"/etc/dam/presets/viewer/Shoppable_Video_Dark", 
     "serverurl":"https://aodmarketingna.assetsadobe.com/is/image/", 
     "videoserverurl":"https://gateway-na.assetsadobe.com/DMGateway/public/aodmarketingna", 
     "contenturl":"https://aodmarketingna.assetsadobe.com/", 
    "interactivedata":"is/content/content/dam/mac/aodmarketingna/_VTT/dm-viewers-content/video/Glacier.mp4.svideo.vtt" 
    } 
    }).init(); 
    </script> 
    </body> 
    </html>
    

不受高度限制的自適應設計內嵌

有了互動式設計內嵌功能,網頁通常就有某種靈活的版面配置,指定檢視器容器DIV的執行時期大小。 在下列範例中,假設網頁允許檢視器的容器DIV取用40%的網頁瀏覽器視窗大小,而不會限制其高度。 網頁HTML程式碼如下所示:

<!DOCTYPE html> 
<html> 
<head> 
<style type="text/css"> 
.holder { 
 width: 40%; 
} 
</style> 
</head> 
<body> 
<div class="holder"></div> 
</body> 
</html>

將檢視器新增至此類頁面的步驟類似於固定大小內嵌的步驟。 唯一的區別是您不需要明確定義檢視器大小。

  1. 將檢視器JavaScript檔案新增至您的網頁。
  2. 定義容器DIV。
  3. 建立和初始化檢視器。

上述所有步驟都與固定大小內嵌相同。 將容器DIV新增至現有的"holder" DIV。 以下程式碼為完整範例。 請注意,當重新調整瀏覽器大小時,檢視器大小會變更,以及檢視器外觀比例如何符合資產。

<!DOCTYPE html> 
<html> 
<head> 
<script type="text/javascript" src="https://aodmarketingna.assetsadobe.com/etc/dam/viewers/s7viewers/html5/js/InteractiveVideoViewer.js"></script> 
<style type="text/css"> 
.holder { 
 width: 40%; 
} 
</style> 
</head> 
<body> 
<div class="holder"> 
<div id="s7viewer" style="position:relative"></div> 
</div> 
<script type="text/javascript"> 
var interactiveVideoViewer = new s7viewers.InteractiveVideoViewer({ 
 "containerId":"s7viewer", 
"params":{ 
 "asset":"/content/dam/mac/aodmarketingna/dm-viewers-content/video/Glacier.mp4", 
"config":"/etc/dam/presets/viewer/Shoppable_Video_Dark", 
 "serverurl":"https://aodmarketingna.assetsadobe.com/is/image/", 
 "videoserverurl":"https://gateway-na.assetsadobe.com/DMGateway/public/aodmarketingna", 
 "contenturl":"https://aodmarketingna.assetsadobe.com/", 
"interactivedata":"is/content/content/dam/mac/aodmarketingna/_VTT/dm-viewers-content/video/Glacier.mp4.svideo.vtt" 
} 
}).init(); 
</script> 
</body> 
</html>

下列範例頁面說明在實際使用中,不受高度限制的互動式設計內嵌功能:

即時展示

定義寬度和高度的自適應內嵌

如果定義了寬度和高度的互動式內嵌,網頁樣式會有所不同。 它為"holder" DIV提供兩種大小,並將它置於瀏覽器視窗中。 此外,網頁還將HTMLBODY元素的大小設為100%。

<!DOCTYPE html> 
<html> 
<head> 
<style type="text/css"> 
html, body { 
 width: 100%; 
 height: 100%; 
} 
.holder { 
 position: absolute; 
 left: 20%; 
 top: 20%; 
 width: 60%; 
height: 60%; 
} 
</style> 
</head> 
<body> 
<div class="holder"></div> 
</body> 
</html>

其餘的嵌入步驟與不受限高度的自適應嵌入步驟相同。 產生的範例如下:

<!DOCTYPE html> 
<html> 
<head> 
<script type="text/javascript" src="https://aodmarketingna.assetsadobe.com/etc/dam/viewers/s7viewers/html5/js/InteractiveVideoViewer.js"></script> 
<style type="text/css"> 
html, body { 
 width: 100%; 
 height: 100%; 
} 
.holder { 
 position: absolute; 
 left: 20%; 
 top: 20%; 
 width: 60%; 
height: 60%; 
} 
</style> 
</head> 
<body> 
<div class="holder"> 
<div id="s7viewer" style="position:relative"></div> 
</div> 
<script type="text/javascript"> 
var interactiveVideoViewer = new s7viewers.InteractiveVideoViewer({ 
 "containerId":"s7viewer", 
"params":{ 
 "asset":"/content/dam/mac/aodmarketingna/dm-viewers-content/video/Glacier.mp4", 
"config":"/etc/dam/presets/viewer/Shoppable_Video_Dark", 
 "serverurl":"https://aodmarketingna.assetsadobe.com/is/image/", 
 "videoserverurl":"https://gateway-na.assetsadobe.com/DMGateway/public/aodmarketingna", 
 "contenturl":"https://aodmarketingna.assetsadobe.com/", 
"interactivedata":"is/content/content/dam/mac/aodmarketingna/_VTT/dm-viewers-content/video/Glacier.mp4.svideo.vtt" 
} 
}).init(); 
</script> 
</body> 
</html>

使用Setter型API內嵌

您可以使用setter-based API和no-args建構函式,而不是使用JSON型初始化。 使用此API建構函式時,不會使用任何參數,而且設定參數是使用setContainerId()setParam()setAsset() API方法來指定,並使用個別的JavaScript呼叫。

下列範例說明如何搭配基於setter的API使用固定大小內嵌:

<!DOCTYPE html> 
<html> 
<head> 
<script type="text/javascript" src="https://aodmarketingna.assetsadobe.com/etc/dam/viewers/s7viewers/html5/js/InteractiveVideoViewer.js"></script> 
<style type="text/css"> 
#s7viewer.s7interactivevideoviewer { 
 width: 640px; 
 height: 480px; 
} 
</style> 
</head> 
<body> 
<div id="s7viewer" style="position:relative;width:640px;height:360px;"></div> 
<script type="text/javascript"> 
var interactiveVideoViewer = new s7viewers.InteractiveVideoViewer(); 
interactiveVideoViewer.setContainerId("s7viewer"); 
interactiveVideoViewer.setParam("config", "/etc/dam/presets/viewer/Shoppable_Video_Dark"); 
interactiveVideoViewer.setParam("serverurl", "https://aodmarketingna.assetsadobe.com/is/image/"); 
interactiveVideoViewer.setParam("videoserverurl", "https://gateway-na.assetsadobe.com/DMGateway/public/aodmarketingna"); 
interactiveVideoViewer.setParam("contenturl", "https://aodmarketingna.assetsadobe.com/"); 
interactiveVideoViewer.setParam("interactivedata", "is/content/content/dam/mac/aodmarketingna/_VTT/dm-viewers-content/video/Glacier.mp4.svideo.vtt"); 
interactiveVideoViewer.setAsset("/content/dam/mac/aodmarketingna/dm-viewers-content/video/Glacier.mp4"); 
interactiveVideoViewer.init(); 
</script> 
</body> 
</html>

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now