消息列表

更新时间:2024-06-17 07:53:42下载pdf

涂鸦智能摄像机(IPC)通常具有侦测报警的功能,可以通过设备功能打开侦测开关。

功能说明

侦测告警主要分 声音检测移动检测 两种。当设备检测到声音或者物体移动时,会上报一个报警消息,如果您的 App 集成了推送功能,App 还会收到一个推送通知。集成推送请参考 集成 Push

  • 报警消息通常会附带一张当前视频的截图。
  • 直供电的门铃设备,提供视频消息的能力。当有人按下门铃时,门铃可以上传一段留言视频,这个消息也会通过报警消息查询到,消息体会附带一段 6 秒的加密视频。

报警消息

类说明

类名 说明
ThingSmartCameraMessage IPC 侦测报警事件消息管理

初始化消息管理类

查询报警消息列表前,需要使用设备 ID 和时区初始化消息管理器。

接口说明

- (instancetype)initWithDeviceId:(NSString *)devId timeZone:(NSTimeZone *)timeZone;

参数说明

参数 说明
devId 设备 ID
timeZone 时区,默认使用用户手机的系统时区,即 [NSTimeZone systemTimeZone]

查询消息日历

可以通过 IPC SDK 查询到有报警消息的日期,以便于在日历上直观展示。

接口说明

- (void)messageDaysForYear:(NSInteger)year
                     month:(NSInteger)month
                   success:(void (^)(NSArray<NSString *> *result))success
                   failure:(void (^)(NSError *error))failure;

参数说明

参数 说明
year 年,如:2020
month 月,如:2
success 成功回调,返回当月有消息记录的日期数组,result 为字符串数组,元素为日期字符串,如:011130
failure 失败回调,error 表示错误信息

查询消息列表

侦测报警消息根据触发方式定义有多种类型,部分类型又可以划分为一个大的分类。IPC SDK 提供查询默认分类的列表,以便于分类查询报警消息。

接口说明

- (void)getMessageSchemes:(void (^)(NSArray<ThingSmartCameraMessageSchemeModel *> *result))success
                  failure:(void (^)(NSError *error))failure;

参数说明

参数 说明
success 成功回调,返回消息分类数据模型的数组
failure 失败回调,error 表示错误信息

ThingSmartCameraMessageSchemeModel 数据模型

字段 类型 说明
describe NSString 消息分类描述
msgCodes NSArray 消息分类所包含的消息类型数组
  • 在查询消息列表时,您可以设置为消息分类的 msgCodes 属性的值,以查询这个分类包含的所有类型的报警消息。
  • 消息类型表示报警消息的触发形式,代码中体现为报警消息数据模型的 msgCode 属性。

msgCodes 消息类型说明

类型 说明
ipc_motion 移动侦测
ipc_doorbell 门铃呼叫
ipc_dev_link 设备联动
ipc_passby 有人经过
ipc_linger 有人徘徊
ipc_leave_msg 门铃消息留言
ipc_connected 门铃已接听
ipc_unconnected 门铃未接听
ipc_refuse 门铃拒接
ipc_human 人形检测
ipc_cat 宠物检测
ipc_car 车辆检测
ipc_baby_cry 婴儿哭声
ipc_bang 异响
ipc_antibreak 强拆报警
ipc_low_battery 低电量告警

由于设备能力的不同,能触发的消息类型会有差别。消息分类和消息类型不同:

  • 消息类型表示报警消息的触发方式。
  • 消息分类是将一个或多个类型的消息组合成一个大类,例如 ipc_passbyipc_lingeripc_motion 可以组合成一个移动侦测的消息分类。

查询侦测报警消息列表

通过 IPC SDK 查询和删除侦测报警消息。

接口说明

- (void)messagesWithMessageCodes:(NSArray *)msgCodes
                          Offset:(NSInteger)offset
                           limit:(NSInteger)limit
                       startTime:(NSInteger)startTime
                         endTime:(NSInteger)endTime
                         success:(void (^)(NSArray<ThingSmartCameraMessageModel *> *result))success
                         failure:(void (^)(NSError *error))failure;

参数说明

参数 说明
msgCodes 消息类型数组,设置为 nil 可以查询所有类型的消息
offset 偏移量,0 表示从第一个报警消息开始
limit 分页大小,最大数量为 200
startTime 查询不早于 startTime 上报的消息,设置为 0 表示不限制开始时间,使用 Unix 时间戳
endTime 查询不晚于 endTime 上报的消息,使用 Unix 时间戳
success 成功回调,返回报警消息数据模型数组
failure 失败回调,error 表示错误信息

批量删除报警消息

参数说明

- (void)removeMessagesWithMessageIds:(NSArray *)msgIds
                             success:(void (^)(void))success
                             failure:(void (^)(NSError *))failure;

参数说明

参数 说明
msgIds 待删除的报警消息的 ID 数组
success 成功回调
failure 失败回调,error 表示错误信息

ThingSmartCameraMessageModel

字段 类型 说明
dateTime NSString 报警消息上报的日期字符串
msgTypeContent NSString 消息类型描述
attachPic NSString 图片附件地址
attachVideos NSArray 视频附件地址数组
msgSrcId NSString 触发报警消息的设备 ID
msgContent NSString 消息内容
msgTitle NSString 消息标题
msgId NSString 消息 ID
msgCode NSString 消息类型
time NSInteger 报警消息上报时间的 Unix 时间戳

根据消息类型不同,可能会有不同的附件:

  • 通过 attachPic 属性可以查询图片附件的地址。
  • 通过 attachVideos 属性可以查询视频附件的地址。通常情况下,这个属性只有一个元素。

开启消息的图片加密

为了保证数据的隐私安全性,可以选择使用加密图片的消息。

接口说明

图片加密默认为关闭。开启图片加密后,消息中携带的图片会加密。您需要使用 ThingEncryptImage 组件显示图片,详情请参考 加密图片

@property (nonatomic, assign) BOOL enableEncryptedImage;