混合媒體

上次更新: 2023-11-04
  • 建立對象:
  • Developer
    User

混合媒體檢視器是一種媒體檢視器。 它支援包含影像、色票集、迴轉集、視訊和自我調整視訊集的媒體集。

檢視器底部的縮圖代表每個媒體集元素,及其資產型別指標。 選取色票集元素時,會出現第二列的色票,以允許選取色票集內的顏色變化。 影像和色票集元素支援以連續或內嵌模式縮放;迴轉集支援縮放和旋轉。 視訊和自我調整視訊集支援所有基本播放控制項,只要視訊內容上方顯示任何選用的隱藏式字幕即可。 使用者可隨時按一下全熒幕按鈕以切換至全熒幕。 檢視器有選用的關閉按鈕。 專為桌上型電腦和行動裝置所設計。

只要基礎系統支援,混合媒體檢視器就會在其預設設定中使用HLS格式的HTML5串流視訊播放。 在不支援HTML5串流的系統上,檢視器會回到HTML5漸進式視訊傳送。

注意

此檢視器不支援使用IR (影像演算)或UGC (使用者產生的內容)的影像。

檢視器型別505。

另請參閱 系統需求和先決條件.

示範URL

https://s7d9.scene7.com/s7viewers/html5/MixedMediaViewer.html?asset=Scene7SharedAssets/Mixed_Media_Set_Sample

使用混合媒體檢視器

混合媒體檢視器代表主要JavaScript檔案和一組協助程式檔案(單一JavaScript包含此特定檢視器使用的所有Viewer SDK元件、資產、CSS),這些是檢視器在執行階段下載的。

您可以在快顯視窗模式中使用混合媒體檢視器,方法是使用IS-Viewers隨附的生產就緒HTML頁面。 或者,您可以在內嵌模式中使用檢視器,其中使用檔案化的API將其整合至目標網頁。

設定檢視器外觀的工作與其他檢視器類似。 所有外觀設定都是透過自訂CSS來達成。

另請參閱 所有檢視器通用的命令參考 — 組態屬性所有檢視器通用的命令參考 — URL

與混合媒體檢視器互動

混合媒體檢視器支援其他行動應用程式中常見的單一觸控和多重觸控手勢。 當檢視器無法處理使用者的撥動手勢時,會轉送事件給網頁瀏覽器以執行原生頁面捲動。 即使檢視器佔據裝置熒幕區域的大部分,此功能仍可讓使用者導覽頁面。

手勢

說明

點一下滑鼠

啟動彈出式檢視或在主要和次要縮放層級之間變更。

點兩下

當在 連續 縮放模式,會放大一個層級,直到達到最大放大倍數,下一個雙點選手勢會重設為初始狀態。

觸摸並停留

當在 內嵌 縮放模式,啟動縮放的影像。

捏合

在連續縮放模式中,放大或縮小影像。

水準撥動或輕觸

當目前資產為迴轉集且影像處於重設狀態時,會水準迴轉該迴轉集。

當目前資產為迴轉集或影像,且影像已放大時,會水準移動影像。 如果影像移至檢視邊緣,而且仍在該方向完成撥動,手勢會執行原生頁面捲動。

在色票列中捲動色票清單。

垂直撥動或輕觸

如果影像處於重設狀態,則會在使用多維度迴轉集時變更垂直檢視角度。 在一維迴轉集內,或多維迴轉集位於最後一個或第一個軸上,使得垂直撥動不會導致垂直檢視角度變更時,手勢會執行原生頁面捲動。

當目前資產為迴轉集或影像,且影像已放大時,會垂直移動影像。 如果影像移至檢視邊緣後仍沿該方向滑動,手勢會執行原生頁面捲動。

如果該手勢是在色票區域內完成,則會執行原生頁面捲動。

該檢視器也支援在具備觸控熒幕和滑鼠的Windows裝置上進行觸控輸入和滑鼠輸入。 不過,這項支援僅限Chrome、Internet Explorer 11和Edge網頁瀏覽器。

此檢視器可使用完整的鍵盤。

另請參閱 鍵盤協助工具和導覽.

內嵌混合媒體檢視器

不同的網頁對檢視者的行為有不同的需求。 有時,網頁會提供連結,在選取時會在個別瀏覽器視窗中開啟檢視器。 在其他情況下,需要直接將檢視器內嵌在託管頁面中。 在後一種情況下,網頁可能會有靜態頁面佈局,或使用在不同裝置上或不同瀏覽器視窗大小下顯示不同的回應式設計。 為了滿足這些需求,檢視器支援三種主要操作模式:快顯視窗、固定大小嵌入和回應式設計嵌入。

關於彈出式模式

在快顯視窗模式中,檢視器會在個別的網頁瀏覽器視窗或標籤中開啟。 它會取用整個瀏覽器視窗區域,並在瀏覽器調整大小或行動裝置方向變更時進行調整。

快顯視窗模式最常用於行動裝置。 網頁會使用載入檢視器 window.open() javascript呼叫,已正確設定 A HTML元素或任何其他適當的方法。

建議您為快顯視窗操作模式使用現成可用的HTML頁面。 在此案例中,它被稱為 MixedMediaViewer.html 且位於 html5/ 標準IS-Viewers部署的子資料夾:

<s7viewers_root>/html5/MixedMediaViewer.html

您可以套用自訂CSS以實現視覺化自訂。

以下是在新視窗中開啟檢視器的HTML程式碼範例:

<a href="http://s7d1.scene7.com/s7viewers/html5/MixedMediaViewer.html?asset=Scene7SharedAssets/Mixed_Media_Set_Sample" target="_blank">Open popup viewer</a>

關於固定大小和回應式設計內嵌

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

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

當檢視器在初始載入後未變更其大小時,會使用固定大小內嵌。 此動作是含有靜態佈局的網頁的最佳選擇。

回應式設計內嵌假設檢視器必須在執行階段調整大小以回應容器大小變更 DIV. 最常見的使用案例是將檢視器新增到使用彈性頁面配置的網頁。

在回應式設計內嵌模式中,檢視器的行為會因網頁大小其容器的方式而異 DIV. 如果網頁僅設定容器的寬度 DIV,只要其高度不受限制,檢視器就會根據所使用資產的外觀比例,自動選擇高度。 此功能可確保資產完全符合檢視方式,且兩側不會有任何邊框間距。 此使用案例最常用於使用回應式設計配置架構(例如Bootstrap或Foundation)的網頁。

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

固定大小內嵌

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

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

  2. 定義容器 DIV.

  3. 設定檢視器大小。

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

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

    建立檢視器需要您在HTML標題中新增指令碼標籤。 在可以使用檢視器API之前,請務必加入 MixedMediaViewer.js. 此 MixedMediaViewer.js 檔案位於 html5/js/ 標準IS-Viewers部署的子資料夾:

<s7viewers_root>/html5/js/MixedMediaViewer.js

如果檢視器部署在任一Adobe Dynamic Media Classic伺服器上,且從相同網域提供服務,您就可以使用相對路徑。 否則,請指定已安裝IS-Viewers之其中一個Adobe Dynamic Media Classic伺服器的完整路徑。

相對路徑如下所示:

<script language="javascript" type="text/javascript" src="/s7viewers/html5/js/MixedMediaViewer.js"></script>
注意

僅參照主要檢視器JavaScript include 檔案時,才會追蹤此專案。 請勿在網頁程式碼中參考任何其他JavaScript檔案(這些檔案可能由檢視器的邏輯在執行階段下載)。 尤其請勿直接參照HTML5 SDK Utils.js 檢視器從載入的程式庫 /s7viewers 內容路徑(所謂整合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. 設定檢視器大小

    此檢視器在處理多專案集時會顯示縮圖。 在桌上型電腦系統上,縮圖會放置在主要檢視的下方。 同時,檢視器允許在執行階段使用交換主要資產 setAsset() API。 身為開發人員,只要新資產只有一個專案,您就能控制檢視器管理底部縮圖區域的方式。 可以保持外部檢視器大小不變,並讓主檢視增加其高度並佔據縮圖區域。 或者,您可以讓主要檢視大小保持靜態,並摺疊外部檢視器區域,讓網頁內容向上移動。 接著,使用縮圖所留下的自由頁面空間。

    若要保持外部檢視器界限不變,請定義 .s7mixedmediaviewer 以絕對單位表示的頂層CSS類別。 CSS的大小調整可直接放在HTML頁面或自訂檢視器CSS檔案中,並於稍後指派給Dynamic Media Classic中的檢視器預設集記錄,或使用style命令明確傳遞。

    另請參閱 自訂混合媒體檢視器 以取得有關使用CSS設定檢視器樣式的詳細資訊。

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

    #s7viewer.s7mixedmediaviewer {
     width: 640px;
     height: 480px;
    }
    

    您可以在下列範例頁面上看到具有固定外部檢視器區域的行為。 請注意,當您在組之間切換時,外部檢視器大小不會變更:

    https://experienceleague.adobe.com/tools/dynamic-media-demo/viewers-ref/mixedmedia/MixedMediaViewer-fixed-outer-area.html?lang=zh-Hant

    若要使主檢視尺寸為靜態,請以絕對單位定義內部檢視器的大小 Container 使用的SDK元件 .s7mixedmediaviewer .s7container CSS選取器,或使用 stagesize 修飾元。

    以下範例是定義內部檢視器大小的範例 Container SDK元件,讓主要檢視區域在切換資產時不會變更其大小:

    #s7viewer.s7mixedmediaviewer .s7container {
     width: 640px;
     height: 480px;
    }
    

    以下範例頁面顯示具有固定主檢視大小的檢視器行為。 請注意,當您在組之間切換時,主要檢視會維持靜態,而網頁內容會垂直移動:

    https://experienceleague.adobe.com/tools/dynamic-media-demo/viewers-ref/mixedmedia/MixedMediaViewer-fixed-main-view.html?lang=zh-Hant

    您可以設定 stagesize 在Dynamic Media Classic的檢視器預設集記錄中修飾元,或使用檢視器初始化程式碼明確傳遞 params 集合。 或者,如本說明的命令參考一節中所述,作為API呼叫,如下所示:

    mixedMediaViewer.setParam("stagesize", "640,480");
    

    此範例建議您使用以CSS為基礎的方法。

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

    完成上述步驟後,您會建立 s7viewers.MixedMediaViewer 類別,將所有設定資訊傳遞至其建構函式,並呼叫 init() 方法。 組態資訊會以JSON物件的形式傳遞至建構函式。 此物件至少應具有 containerId 包含檢視器容器ID名稱且以巢狀顯示的欄位 params 包含檢視器支援之設定引數的JSON物件。 在此案例中, params 物件必須至少將「影像伺服」URL傳遞為 serverUrl 屬性,視訊伺服器URL傳遞為 videoserverurl 屬性,以及初始資產為 asset 引數。 JSON型初始化API可讓您使用一行程式碼來建立和啟動檢視器。

    請務必將檢視器容器新增至DOM,讓檢視器程式碼可依其ID尋找容器元素。 有些瀏覽器會延遲建立DOM,直到網頁結尾為止。 如需最大相容性,請呼叫 init() 方法(在結尾之前) BODY 標籤上,或在內文上 onload() 事件。

    同時,容器元素也不一定屬於網頁版面配置的一部分。 例如,可使用以下專案將其隱藏: display:none 樣式已指派給它。 在此情況下,檢視器會延遲其初始化程式,直到網頁將容器元素帶回版面配置為止。 當此動作發生時,檢視器載入會自動繼續。

    以下範例說明如何建立檢視器例項、將最低必要設定選項傳遞至建構函式,以及呼叫 init() 方法。 此範例假設 mixedMediaViewer 是檢視器例項; s7viewer 是預留位置名稱 DIV; http://s7d1.scene7.com/is/image/ 是「影像伺服」URL; http://s7d1.scene7.com/is/content/ 是視訊伺服器URL;以及 Scene7SharedAssets/Mixed_Media_Set_Sample 為資產:

<script type="text/javascript">
var mixedMediaViewer = new s7viewers.MixedMediaViewer({
 "containerId":"s7viewer",
"params":{
 "asset":"Scene7SharedAssets/Mixed_Media_Set_Sample",
 "serverurl":"http://s7d1.scene7.com/is/image/",
 "videoserverurl":"http://s7d1.scene7.com/is/content/"
}
}).init();
</script>
<script type="text/javascript">
mixedMediaViewer.init();
</script>

下列程式碼是嵌入固定大小混合媒體檢視器的簡單網頁的完整範例:

<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="http://s7d1.scene7.com/s7viewers/html5/js/MixedMediaViewer.js"></script>
<style type="text/css">
#s7viewer.s7mixedmediaviewer {
 width: 640px;
 height: 480px;
}
</style>
</head>
<body>
<div id="s7viewer" style="position:relative"></div>
<script type="text/javascript">
var mixedMediaViewer = new s7viewers.MixedMediaViewer({
 "containerId":"s7viewer",
"params":{
 "asset":"Scene7SharedAssets/Mixed_Media_Set_Sample",
 "serverurl":"http://s7d1.scene7.com/is/image/",
 "videoserverurl":"http://s7d1.scene7.com/is/content/"
}
}).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="http://s7d1.scene7.com/s7viewers/html5/js/MixedMediaViewer.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 mixedMediaViewer = new s7viewers.MixedMediaViewer({
 "containerId":"s7viewer",
"params":{
 "asset":"Scene7SharedAssets/Mixed_Media_Set_Sample",
 "serverurl":"http://s7d1.scene7.com/is/image/",
 "videoserverurl":"http://s7d1.scene7.com/is/content/"
}
}).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="http://s7d1.scene7.com/s7viewers/html5/js/MixedMediaViewer.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 mixedMediaViewer = new s7viewers.MixedMediaViewer({
 "containerId":"s7viewer",
"params":{
 "asset":"Scene7SharedAssets/Mixed_Media_Set_Sample",
 "serverurl":"http://s7d1.scene7.com/is/image/",
 "videoserverurl":"http://s7d1.scene7.com/is/content/"
}
}).init();
</script>
</body>
</html>

使用Setter型API進行內嵌

除了使用JSON型初始化之外,也可以使用setter型API和no-args建構函式。 使用此API建構函式不接受任何引數,而且設定引數是使用 setContainerId()setParam()、和 setAsset() API方法,具有個別的JavaScript呼叫。

下列範例說明如何將固定大小內嵌與setter型API搭配使用:

<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="http://s7d1.scene7.com/s7viewers/html5/js/MixedMediaViewer.js"></script>
<style type="text/css">
#s7viewer.s7mixedmediaviewer {
 width: 640px;
 height: 480px;
}
</style>
</head>
<body>
<div id="s7viewer" style="position:relative"></div>
<script type="text/javascript">
var mixedMediaViewer = new s7viewers.MixedMediaViewer();
mixedMediaViewer.setContainerId("s7viewer");
mixedMediaViewer.setParam("serverurl", "http://s7d1.scene7.com/is/image/");
mixedMediaViewer.setAsset("Scene7SharedAssets/Mixed_Media_Set_Sample");
mixedMediaViewer.init();
</script>
</body>
</html>

本頁內容