混合媒体

混合媒体查看器是媒体查看器。 它支持包含图像、色板集、旋转集、视频和自适应视频集的媒体集。

查看器底部的缩略图表示每个媒体集元素及其资产类型指示器。 选择样本集元素后,将显示第二行样本,以便选择样本集中的颜色变化。 图像和样本集元素支持在连续或内联模式下缩放;旋转集支持缩放和旋转。 视频和自适应视频集支持所有基本的播放控件,只要视频内容顶部显示任何可选的隐藏式字幕即可。 用户可随时通过单击全屏按钮切换到全屏。 查看器具有可选的关闭按钮。 它适用于台式机和移动设备。

当基础系统支持HLS格式时,混合媒体查看器在其默认配置中使用HTML5流视频播放。 在不支持HTML5流播放的系统上,查看器会返回到HTML5渐进式视频交付。

注意

此查看器不支持使用IR(图像渲染)或UGC(用户生成的内容)的图像。

查看器类型505。

请参阅系统要求和先决条件

演示URL

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

使用混合媒体查看器

混合媒体查看器表示主JavaScript文件和一组由查看器在运行时下载的帮助程序文件(单个JavaScript包含该查看器的所有查看器SDK组件、资产和CSS)。

您可以在弹出模式下使用混合媒体查看器,方法是使用随IS-Viewers提供的生产就绪HTML页面。 或者,您也可以在嵌入式模式下使用查看器,在该模式下,可使用记录的API将查看器集成到目标网页中。

配置查看器并设置其外观的任务与其他查看器类似。 所有外观设置都通过自定义CSS实现。

请参阅所有查看器的通用命令引用 — 配置属性🔗所有查看器通用的命令引用 — URL

与混合媒体查看器交互

混合媒体查看器支持其他移动设备应用程序中常见的单点触控和多点触控手势。 当查看器无法处理用户的轻扫手势时,它会将事件转发到Web浏览器以执行本机页面滚动。 即使查看者占据了设备屏幕的大部分区域,该功能仍允许用户在页面中导航。

手势

说明

单点按

激活弹出视图或主缩放级别和次缩放级别之间的更改。

双击

连续缩放模式下,将放大一个级别直到达到最大放大率,下一个双击手势将重置为初始状态。

触摸并按住

在内联缩放模式下,激活缩放的图像。

捏合

在连续缩放模式下,放大或缩小图像。

水平轻扫或轻扫

当当前资产是旋转集,并且图像处于重置状态时,它会水平旋转旋转旋转集。

当当前资产是旋转集或图像,并且图像被放大时,会水平移动图像。 如果图像被移动到视图边缘,并且仍沿该方向轻扫,则手势将执行本机页面滚动。

滚动样本栏中的样本列表。

垂直轻扫或轻扫

如果图像处于重置状态,则当使用多维旋转集时,它会更改垂直视图角度。 在一维旋转集中,或者当多维旋转集位于最后一个或第一个轴上时,如果垂直轻扫不会导致垂直视图角度发生更改,则手势将执行本机页面滚动。

当当前资产是旋转集或图像,并且图像已放大时,会垂直移动图像。 如果图像被移动到视图边缘并且仍沿该方向轻扫,则手势将执行本机页面滚动。

如果手势是在色板区域内完成的,则会执行本机页面滚动。

查看器还支持在具有触摸屏和鼠标的Windows设备上输入触摸输入和鼠标。 但是,此支持仅限于Chrome、Internet Explorer 11和Edge Web浏览器。

此查看器可完全通过键盘访问。

请参阅键盘辅助功能和导航

嵌入混合媒体查看器

不同网页对查看者行为的需求不同。 有时,网页会提供一个链接,单击该链接后,即会在单独的浏览器窗口中打开查看器。 在其他情况下,需要将查看器权限嵌入到托管页面中。 在后一种情况下,网页可能具有静态页面布局,或者使用响应式设计,该设计在不同设备上显示不同,或针对不同的浏览器窗口大小显示不同。 为了满足这些需求,查看器支持三种主要操作模式:弹出窗口、固定大小嵌入和响应式设计嵌入。

关于弹出模式

在弹出模式下,查看器在单独的Web浏览器窗口或选项卡中打开。 它会占用整个浏览器窗口区域,并在浏览器大小调整或移动设备方向发生更改时进行调整。

弹出模式是移动设备最常见的模式。 网页会使用window.open() JavaScript调用、正确配置的A HTML元素或任何其他合适的方法加载查看器。

建议您使用现成的HTML页面进行弹出操作模式。 在这种情况下,它名为MixedMediaViewer.html,位于标准IS-Viewers部署的html5/子文件夹中:

<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或基础)的网页最常见的用例。

否则,如果网页同时设置查看器容器DIV的宽度和高度,则查看器仅填充该区域,并遵循网页布局提供的大小。 一个很好的示例是将查看器嵌入到模式叠加中,其中的叠加根据Web浏览器窗口大小来调整大小。

固定大小嵌入

可通过执行以下操作将查看器添加到网页:

  1. 将查看器JavaScript文件添加到网页。

  2. 定义容器DIV

  3. 设置查看器大小。

  4. 创建和初始化查看器。

  5. 将查看器JavaScript文件添加到网页。

    创建查看器要求您在HTML标头中添加脚本标记。 在使用查看器API之前,请确保包含MixedMediaViewer.js。 MixedMediaViewer.js文件位于标准IS-Viewers部署的html5/js/子文件夹下:

<s7viewers_root>/html5/js/MixedMediaViewer.js

如果查看器部署在某个Adobe的Dynamic Media Classic服务器上,并且从同一域提供该查看器,则可以使用相对路径。 否则,您将指定一个安装IS-Viewer的AdobeDynamic Media Classic服务器的完整路径。

相对路径如下所示:

<script language="javascript" type="text/javascript" src="/s7viewers/html5/js/MixedMediaViewer.js"></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. 设置查看器大小

    此查看器在处理多项目集时显示缩略图。 在桌面系统上,缩略图位于主视图的下方。 同时,查看器允许在运行时使用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-Hans?lang=zh-Hans

    要使主视图维度保持静态,请使用.s7mixedmediaviewer .s7container CSS选择器或使用stagesize修饰符为内部Container SDK组件定义查看器大小,以绝对单位表示。

    以下示例用于为内部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-Hans?lang=zh-Hans

    您可以在Dynamic Media Classic的查看器预设记录中设置stagesize修饰符,或通过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,直到网页结束。 为了实现最大的兼容性,请在结束BODY标记之前或在主体onload()事件上调用init()方法。

    同时,容器元素还不一定是网页布局的一部分。 例如,可以使用分配给它的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占用Web浏览器窗口大小的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嵌入

可以使用基于setter的API和no-args构造函数,而不是使用基于JSON的初始化。 使用此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>

在此页面上