CCTV¶

CCTV 组件用于在仪表盘页面上播放摄像头的视频流，支持实时监控与历史监控两种类型。视频地址可以直接填写，也可以按资产查询获取视频流。

与视频组件的区别：CCTV 一个组件只播放一路画面，但支持 HLS、FLV、WebRTC 和 MP4 多种流类型，地址可以手动填写，也可以按资产 ID 查询，并能回放指定时间段的历史录像；视频组件则在一个组件中并排播放多路画面，地址只能由 REST API 数据源提供，且只支持海康格式。

有关基本、过滤器 标签页的通用配置，参见图表通用配置。

CCTV 的数据¶

CCTV 使用 1 个指标 字段，默认字段名为 streamUrl，用于存放视频流地址。组件不使用维度和对比字段。

有关数据源和数据项的通用配置信息，参见图表通用配置 > 配置数据。

备注

指标字段的取值优先于视频服务地址中手动填写的地址。只有指标字段未绑定或取不到值时，才使用手动填写的地址。

CCTV 的样式¶

样式标签页按视频来源、播放画面和播放行为顺序排列以下配置项。

视频流来源¶

视频流来源 决定组件如何获得视频流，默认 流地址：

流地址：直接使用指标字段或视频服务地址中的地址加载视频，适合地址固定或由数据源直接给出完整流地址的场景。
视频服务地址：把地址作为 EnOS 视频服务的接口地址，组件携带资产 ID 等参数向该接口发起请求，再用接口返回的地址播放，由 EnOS 负责鉴权和地址解析。

视频类型¶

仅在 视频流来源 为 视频服务地址 时显示，默认 实时监控：

实时监控：播放摄像头当前的直播画面。
历史监控：播放指定时间段内的录像，需要另外填写起始时间和结束时间。

视频服务地址¶

填写视频地址。视频流来源 为 流地址 时，此处填写视频流本身的地址；为 视频服务地址 时，此处填写视频服务的接口地址。

地址支持使用 @{参数名} 引用数据源查询参数、${参数名} 引用页面参数。更多信息，参见配置动态参数。

资产 ID¶

仅在 视频流来源 为 视频服务地址 时显示。填写要查询的资产 ID，组件会将其作为参数附加到视频服务的请求地址上。同样支持填写参数占位符。更多信息，参见配置动态参数。

起始时间 / 结束时间¶

仅在 视频流来源 为 视频服务地址 且 视频类型 为 历史监控 时显示。填写录像片段的起止时间，支持填写参数占位符，从而由全局过滤器动态控制回放区间。

时间范围类的过滤器可能把起止时间作为一个以英文逗号分隔的整体传入。组件会自动拆分：起始时间取逗号左侧，结束时间取逗号右侧，因此可以只把该过滤器绑定到 起始时间。

开启 UTC 时间¶

仅在 视频流来源 为 视频服务地址 且 视频类型 为 历史监控 时显示，默认不勾选。

勾选后，起止时间中不带时区信息的文本按 UTC 时间解析；不勾选则按浏览器所在时区解析。两种情况下最终都会转换为毫秒时间戳发送给视频服务。

流类型¶

指定视频流的协议，需与视频源实际提供的格式一致，默认 HLS：

HLS：基于 HTTP 的分段流，兼容性好，适合大多数场景。
FLV：延迟较低，常用于直播推流。
WebRTC：延迟最低，适合对实时性要求极高的场景。
MP4：标准视频文件格式，适合录像回放。

封面图¶

填写一张图片的地址，作为视频加载完成前显示的占位画面，避免加载期间出现空白区域。默认为空。

画面比例¶

控制播放区域的宽高比，可选 16:9（默认）、4:3 或 Auto。选择 Auto 时，播放区域随组件容器尺寸自由伸缩。

填充方式¶

决定画面如何适应播放区域，默认等比：

等比：保持原始宽高比缩放，画面完整显示，多余空间显示为黑边。
填满：保持原始宽高比缩放至铺满整个区域，超出部分被裁剪。

自动播放¶

默认勾选。勾选后视频加载完成即开始播放，无需终端用户手动点击。

默认静音¶

默认勾选。勾选后视频以静音状态开始播放。多数浏览器要求静音才允许自动播放，因此启用 自动播放 时建议保持勾选。

自动重连¶

默认勾选。视频流因网络波动等原因中断时，组件自动尝试重新连接，减少人工干预。

运行时交互¶

以下行为由组件在运行时提供，不需要配置：

地址解析：地址中的参数占位符在发起请求前解析。视频流来源 为 视频服务地址 时，组件把资产 ID 和（历史监控时的）起止时间拼为查询参数请求视频服务，并使用返回的地址播放；是否为回放由请求中是否带起止时间决定。
播放控制：由 自动播放、默认静音、显示工具栏 和 自动重连 四项共同决定，运行时终端用户可通过工具栏手动操作。

备注

CCTV 组件的基本标签页不提供 显示提示 和 导出组件数据；组件也不支持组件联动和样式复制。