文档Dynamic Media查看器参考指南

自定义视频查看器 customizing-video-viewer

Last update: Sat Nov 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • Developer
  • User

所有可视自定义项和大多数行为自定义项均通过创建自定义CSS来完成。

建议的工作流程是获取相应查看器的默认CSS文件，将其复制到其他位置，对其进行自定义，然后在 style= 命令。

可以在以下位置找到默认CSS文件：

<s7_viewers_root>/html5/VideoViewer.css

自定义CSS文件必须包含与默认文件相同的类声明。 如果忽略类声明，则查看器将无法正常运行，因为它没有为用户界面元素提供内置的默认样式。

提供自定义CSS规则的替代方法是直接在网页或其中一个链接的外部CSS规则中使用嵌入样式。

创建自定义CSS时，请记住查看器分配 .s7videoviewer 类到其容器DOM元素。 如果您使用随一起传递的外部CSS文件 style= 命令，使用 .s7videoviewer 类作为CSS规则的后代选择器中的父类。 如果在网页上嵌入样式，则还可通过容器DOM元素的ID限定此选择器，如下所示：

#<containerId>.s7videoviewer

构建响应式设计的CSS section-63e8f93ee2f14fd8bba1ce33a6870b80

可以定位CSS中的不同设备，以使您的内容根据用户的设备而显示不同。 此定位包括但不限于不同的用户界面元素大小和图稿分辨率。

查看器支持两种创建响应式设计CSS的机制： CSS标记和标准CSS媒体查询。 可以单独或一起使用这两种机构。

CSS标记

为了帮助您创建响应式设计的CSS，查看器支持CSS标记，这些标记是动态分配给顶级查看器容器元素的特殊CSS类。 分配基于运行时查看器大小和当前设备上使用的输入类型。

第一组CSS标记包括 .s7size_large， .s7size_medium、和 .s7size_small 类。 它们根据查看器容器的运行时区域应用。 即，如果查看器区域等于或大于普通台式机显示器的大小 .s7size_large 如果该区域与普通平板电脑设备比较接近，则使用 .s7size_medium 已分配。 对于类似于手机屏幕的区域， .s7size_small 设置。 这些CSS标记的主要用途是为不同的屏幕和查看器大小创建不同的用户界面布局。

第二组CSS标记包括 .s7mouseinput 和 .s7touchinput. 标记 .s7touchinput 如果当前设备具有触摸输入功能，则进行设置；否则， .s7mouseinput 已使用。 这些标记旨在为不同的输入类型创建具有不同屏幕大小的用户界面输入元素，因为通常触摸输入需要更大的元素。 如果设备同时具有鼠标输入和触摸功能， .s7touchinput 已设置，且查看器呈现触控友好的用户界面。

以下示例CSS将播放/暂停按钮的大小设置为在输入鼠标的系统上为28 x 28像素，在触摸设备上为56 x 56像素。 此外，如果查看器大小变得太小，则会完全隐藏按钮：

.s7videoviewer.s7mouseinput .s7playpausebutton {
    width:28px;
    height:28px;
}
.s7videoviewer.s7touchinput .s7playpausebutton {
    width:56px;
    height:56px;
}
.s7videoviewer.s7size_small .s7playpausebutton {
    visibility:hidden;
}

要定位具有不同像素密度的设备，请使用CSS媒体查询。 以下媒体查询块将包含特定于高密度屏幕的CSS：

@media screen and (-webkit-min-device-pixel-ratio: 1.5)
{
}

使用CSS标记是构建响应式设计CSS的最灵活方法。 原因在于，它不仅允许您定位设备屏幕大小，而且允许您定位实际查看器大小，这对于响应式设计页面布局可能很有用。

使用默认查看器CSS文件作为CSS标记方法示例。

CSS媒体查询

设备感知也可以使用纯CSS媒体查询来完成。 给定媒体查询块中包含的所有内容，仅在相应设备上运行时适用。

应用于移动设备查看器时，使用四个CSS媒体查询，它们在CSS中按下列顺序定义：

  1. 仅包含特定于所有触控设备的规则。

    code language-none 
    @media only screen and (max-device-width:13.5in) and (max-device-height:13.5in) and (max-device-width:799px),
only screen and (max-device-width:13.5in) and (max-device-height:13.5in) and (max-device-height:799px)
{
}

  2. 仅包含特定于具有高分辨率屏幕的平板电脑的规则。

    code language-none 
    @media only screen and (max-device-width:13.5in) and (max-device-height:13.5in) and (max-device-width:799px) and (-webkit-min-device-pixel-ratio:1.5),
only screen and (max-device-width:13.5in) and (max-device-height:13.5in) and (max-device-height:799px) and (-webkit-min-device-pixel-ratio:1.5)
{
}

  3. 仅包含特定于所有手机的规则。

    code language-none 
    @media only screen and (max-device-width:9in) and (max-device-height:9in)
{
}

  4. 仅包含特定于高分辨率屏幕手机的规则。

    code language-none 
    @media only screen and (max-device-width:9in) and (max-device-height:9in) and (-webkit-min-device-pixel-ratio: 1.5),
  only screen and (device-width:720px) and (device-height:1280px) and (-webkit-device-pixel-ratio: 2),
  only screen and (device-width:1280px) and (device-height:720px) and (-webkit-device-pixel-ratio: 2)
{
}

使用CSS媒体查询方法，您应该使用设备感知来组织CSS，如下所示：

  • 首先，特定于桌面的部分定义了所有属性，这些属性特定于桌面或适用于所有屏幕。
  • 其次，四个媒体查询应按照上面定义的顺序进行，并提供特定于相应设备类型的CSS规则。

无需在每个媒体查询中复制整个查看器CSS。 只有特定于给定设备的属性才能在媒体查询中重新定义。

CSS脚本 section-9b6d8d601cb441d08214dada7bb4eddc

许多查看器用户界面元素使用位图图进行样式设置，并具有多个不同的可视状态。 一个很好的示例是一个按钮，该按钮通常至少具有三种不同的状态：“up”、“over”和“down”。 每个状态都需要为其指定自己的位图图稿。

使用经典样式设置方法时，对于用户界面元素的每个状态，CSS将对服务器上的单个图像文件进行单独的引用。 以下是用于设置全屏按钮样式的CSS示例：

.s7videoviewer.s7mouseinput .s7playpausebutton[selected='true'][state='up'] {
background-image:url(images/v2/PlayButton_up.png);
}
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='true'][state='over'] {
background-image:url(images/v2/PlayButton_over.png);
}
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='true'][state='down'] {
background-image:url(images/v2/PlayButton_down.png);
}
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='true'][state='disabled'] {
background-image:url(images/v2/PlayButton_disabled.png);
}
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='false'][state='up'] {
background-image:url(images/v2/PauseButton_up.png);
}
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='false'][state='over'] {
background-image:url(images/v2/PauseButton_over.png);
}
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='false'][state='down'] {
background-image:url(images/v2/PauseButton_down.png);
}
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='false'][state='disabled'] {
background-image:url(images/v2/PauseButton_disabled.png);
}
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='true'][replay='true'][state='up'] {
background-image:url(images/v2/ReplayButton_up.png);
}
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='true'][replay='true'][state='over'] {
background-image:url(images/v2/ReplayButton_over.png);
}
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='true'][replay='true'][state='down'] {
background-image:url(images/v2/ReplayButton_down.png);
}
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='true'][replay='true'][state='disabled'] {
background-image:url(images/v2/ReplayButton_disabled.png);
}

此方法的一个缺点是最终用户在首次与元素交互时体验到用户界面响应闪烁或延迟。 发生此操作是因为尚未下载新元素状态的图像图稿。 此外，由于对服务器的HTTP调用数量增加，此方法可能会对性能产生轻微的负面影响。

CSS sprite是一种不同的方法，所有元素状态的图像图稿都合并到称为“sprite”的单个PNG文件中。 此类“sprite”具有给定元素的所有视觉状态，它们彼此相邻。 使用拼写设置用户界面元素的样式时，同一个sprite图像将针对CSS中的所有不同状态引用。 此外， background-position 属性用于每个状态，以指定使用“sprite”图像的哪个部分。 您可以以任何适当的方式构建“Sprite”图像。 查看器通常将其垂直栈叠。 下面是基于“sprite”的示例，用于为上方显示的相同全屏按钮设置样式：

.s7videoviewer .s7fullscreenbutton[state][selected]{
 background-image: url(images/v2/FullScreenButton_dark_sprite.png);
}
.s7videoviewer.s7mouseinput .s7fullscreenbutton[selected='true'][state='up'] {
background-position: -84px -1148px;
}
.s7videoviewer.s7mouseinput .s7fullscreenbutton[selected='true'][state='over'] {
background-position: -56px -1148px;
}
.s7videoviewer.s7mouseinput .s7fullscreenbutton[selected='true'][state='down'] {
background-position: -28px -1148px;
}
.s7videoviewer.s7mouseinput .s7fullscreenbutton[selected='true'][state='disabled'] {
background-position: -0px -1148px;
}
.s7videoviewer.s7mouseinput .s7fullscreenbutton[selected='false'][state='up'] {
background-position: -84px -1120px;
}
.s7videoviewer.s7mouseinput .s7fullscreenbutton[selected='false'][state='over'] {
background-position: -56px -1120px;
}
.s7videoviewer.s7mouseinput .s7fullscreenbutton[selected='false'][state='down'] {
background-position: -28px -1120px;
}
.s7videoviewer.s7mouseinput .s7fullscreenbutton[selected='false'][state='disabled'] {
background-position: -0px -1120px;
}

常规样式注释和建议 section-097418bd618740bba36352629e4d88e1

  • 指向CSS内外部资源的所有路径都是根据CSS位置而不是查看器HTML页面的位置解析的。 将默认CSS复制到其他位置时，请记住考虑此规则。 复制自定义CSS中的默认资源或更新路径。

  • 位图图稿的首选格式为PNG。

  • 位图图稿使用分配给用户界面元素 background-image 属性。

  • 此 width 和 height 用户界面元素的属性定义其逻辑大小。 传递到的位图的大小 background-image 不会影响逻辑大小。

  • 若要使用高分辨率屏幕（如Retina）的高像素密度，请指定两倍于逻辑用户界面元素大小的位图图案。 然后，应用 -webkit-background-size:contain 属性，用于将背景缩小到逻辑用户界面元素的大小。

  • 要从用户界面删除按钮，请添加 display:none 添加到其CSS类中。

  • 您可以对CSS支持的颜色值使用各种格式。 如果需要透明度，请使用格式 rgba(R,G,B,A). 否则，可以使用格式 #RRGGBB.

  • 使用CSS自定义查看器用户界面时，使用 !IMPORTANT 不支持规则来设置查看器元素的样式。 特别是， !IMPORTANT 规则不应用于覆盖查看器或查看器SDK提供的任何默认样式或运行时样式。 原因是它可能会影响正确组件的行为。 您应该使用具有适当特定性的CSS选择器来设置本参考指南中记录的CSS属性。

常见用户界面元素 section-d6330c9be8c444aa9b2a07886e3dbc2a

以下是适用于Video Viewer的用户界面元素参考文档：

recommendation-more-help
b7426f53-aad9-4c00-83fc-664f30f681e8