跳到主要内容

套餐、录制、事件和消息说明

更新时间：2025-04-25 22:12:04

前提必读​

  • 已经通读云存储开发指南，了解套餐、试用套餐概念和业务，了解套餐开通的一般流程。了解套餐开始和结束时间。
  • 已经开通了正式套餐，RTCX云平台就会通知设备，让设备走直存或转发的模式，实现视频录制。
  • 已经了解物模型概念，尤其是物模型中的事件。
    • RTCX的事件一般包括智能事件（参考侦测类型，实际需客户根据设备情况自定义）和自定义事件。
    • 事件指设备检测到某个动作触发的一条记录信息，一般包含需要被外部感知和处理的通知信息。可包含多个输出参数。例如：设备检测到异常运动发出告警等。
    • 事件缩略图，指事件触发后从视频的某个时刻截取的一张图片，一般基于视频当前的分辨率，这个完全依赖设备端实现。RTCX支持缩略图上传、下载，不会对缩略图做任何的缩放、裁剪等处理。

套餐​

信息

一般有存储天数和周期的概念，比如：7天全天录制月套餐。表示视频最多可以存储7天，1个月后失效。

  • 正式套餐（又称云存储套餐）
    • 全天录制套餐，全天一般表示7*24小时不间断录制。
    • 事件录制套餐，事件一般表示有事件发生时才进行的录制。
  • 试用套餐
    • 暂时只支持图片，只有图片，无视频，无智能事件。只是自定义事件，只能在消息中心展示。

录像【存储】​

  • 录像类型
    • 云端录像（或云存储录像）
      • 录制行为依赖正式套餐的类型。分为全天录制和事件录制。
      • 录制包括两部分：
        1. 录制的视频片段
        2. 设备触发的事件信息，比如：事件类型，发生的事件等，如果有图片则包含图片信息。
      • 一般有录制天数的概念，超过套餐指定的天数后，之前的视频和事件数据就会被删除。
      • 设备录像的录制在套餐过期后，会停止。
    • SD卡录像
      • 这个不依赖套餐。需设备端自己实现是否支持SD卡存储，以及支持的SD卡存储容量等。
      • SD卡录制前一般会要求进行格式化处理。确保视频切片数据可以写入。
      • SD卡存储没有固定存储天数和周期的概念，完全依赖SD卡的存储容量，一般都是循环删除模式。
      • RTCX SD卡录制目前支持私有格式和mp4格式。
      • SD卡录像功能基本上云端录像同，SD卡录像暂不支持事件按天统计和事件缩略图。

录像和事件展示​

提示

以下内容如无特殊说明，则表示不区分录像类型。

  • 录像列表展示效果如下： 录像列表

    • 粗红竖线的左边是横向时间轴展示方式，右边是竖向时间轴展示方式。
    • 其中左边横向时间轴的浅灰色部分表示有录像，红色或绿色表示智能事件，最终效果是通过录像列表和事件列表接口组合展示的效果。
      • 注意：RTCX云平台针对录像列表做了请求优化。无法获取到一个个具体的录制片段文件。
      • 蓝色光标拖到任何时间点，通过AppSDK/PCSDK传入该时刻点向RTCX云平台发起回放请求。
    • 其中右边竖向时间轴的浅蓝色部分表示有录像，深蓝色表示智能事件，最终效果也是通过录像列表和事件列表接口组合展示的效果。
      • 注意："20个录像"或"12个录像"是按时间段（比如：60分钟）进行的聚合，使用事件列表接口实现。

  • 事件列表展示效果如下： 事件列表

    • 其中在时间轴上的展示效果见录像列表展示效果。
    • 上图红竖线左边展示的是一种事件列表效果，有事件的缩略图。红竖线右边是一种按60分钟聚合后的展示效果，也是有事件缩略图的。RTCX的SD卡录制不支持事件缩略图展示。

  • 特别说明：

    1. 事件录制情况下，录像列表（不连续无法聚合）会退化成事件列表。在展示上，事件列表可能会覆盖掉录像列表。事件缩略图和回放效果同上面的说明。
    2. 对于低功耗录制，全天录制套餐效果基本上等同于事件录制套餐。事件缩略图和回放效果同上面的说明。

消息中心​

暂不考虑通过消息网关自行处理的情况。这里只说明通过AppSDK获取的消息中心。

  • 事件 VS 消息：

    • 事件：指智能事件，支持云端存储/SD卡存储，属于视频的附属属性。一般有横向时间轴展示或竖向瀑布流展示（以及按时间段聚合）。见录像列表展示效果。
    • 消息：智能事件【可选】 + 自定义事件/属性/状态【可选】，存储在云端（如果是事件，则包括对应的事件缩略图），无横向时间轴展示或竖向瀑布流展示，一般为列表展示方式，支持分页。

  • 消息列表入口：【依赖客户自行实现，会有不同】

    • 设备列表同级Tab页下的“消息”列表入口（简称账号下消息列表）
    • 设备实时视频同级Tab页下的“消息”列表入口（简称设备下消息列表） 不同的消息入口

  • 设备端的事件上报

  • 消息前提：设备告警配置处，勾选了消息中心，否则无法在消息中心查看到自定义的事件。如下图所示：

设备报警处已经勾选消息中心
  • 消息中心列表返回的DataType详细说明：
    信息

    0：纯文本。只能看到文字，比如：用户室内开门（此时业务展示上可以自定义默认图标，见建议"全部动态"部分）
    1：视频录制类型。即为事件转换而来，保持事件的各种业务逻辑。
    2：图片类型。只能查看图片，试用套餐产生。

事件和消息中心对比​

功能项事件消息中心
来源设备智能告警设备智能告警【可选】 + 设备自定义事件【可选】
DeviceSDK实现智能告警事件上报接口，支持缩略图针对智能告警事件，复用已上报的事件。
针对自定义事件使用单独的接口，支持有无缩略图
云端存储支持支持
SD卡存储支持不支持（也就是消息一定是在云端）
无套餐(*)时上传云端不支持支持
试用套餐时上传云端不支持支持
正式套餐时上传云端支持支持
列表和分页，条件查询支持支持
当前有无新增（New）支持支持
按天统计有无记录云端支持，SD卡存储暂不支持支持
列表返回的DataType1：视频录制类型。0：纯文本
1：视频录制类型
2：图片类型
列表返回的事件类型支持，具体见智能告警事件类型有限支持，dataType=1时，同智能告警事件类型
是否有缩略图支持，设备已上传情况下有限支持，dataType=1和2时，设备已上传情况下
是否可以回放支持有限支持，dataType=1时，可以回放，其他情况不支持
单删除，批量删除支持支持，如果是事件则不影响事件
视频单独下载暂不支持暂不支持

备注：无套餐，可以根据要求进行配置。目前无套餐时，都配置的试用套餐。

建议​

  • 针对门锁等品类，"全部动态"部分，建议使用消息中心方式（可以自定义需要的事件），一种效果如下图所示：
全部动态

  • 优先使用AppSDK封装优化过的事件/消息中心列表、删除等接口。

  • 如果要自己实现业务，只建议自己做App消息推送，可以通过消费消息网关来实现。

    • 针对门锁等事件相对低频的场景，可以考虑支持App消息推送带图片。IPC等不建议支持App消息推送带图片。

  • 针对录像/消息Tab页，分别使用事件列表（视套餐和时间轴展示，可能还需要录像列表）/消息中心列表。如下图所示： 事件列表和消息列表

  • 试用套餐时，如果支持SD卡且也插入已格式化的SD卡，可以使用SD卡存储代替云端存储（上图展示的就是SD卡存储）