-
响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 device_id String 设备ID，设备唯一标识符 device_name String 设备名称 device_type String 设备类型 枚举值 IPC 通用相机 NVR NVR设备 MEdge IVS1800设备 IPC-BULLET 枪机 IPC-BOX 筒机 IPC-CONCH 半球/海螺 IPDOME 球机 device_state String 设备状态 枚举值： OFFLINE 离线 ONLINE 在线 manufacture String 设备生产厂商
-
请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 表3 请求Body参数 参数 是否必选 参数类型 描述 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 verification_code 是 String 验证码：支持大小写字母、数字，长度固定为8位 description 否 String 设备描述：字符组成，长度范围[0,128]
-
请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 表3 请求Body参数 参数 是否必选 参数类型 描述 device_ids 是 Array of strings 要移动设备ID集合：数组长度范围[1,100] 单个设备： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型
-
响应示例 状态码： 200 OK {
"failed_num" : 1,
"results" : [ {
"device_id" : "952352DJNR***",
"result" : {
"code" : "IVM.0",
"msg" : "Success"
}
}, {
"device_id" : "952352LWXT***",
"result" : {
"code" : "IVM.10022037",
"msg" : "Move device is not exist"
}
} ]
}
-
响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 failed_num Integer 移动失败设备数 results Array of northMoveDevicesResult objects 设备移动结果详细信息 表5 northMoveDevicesResult 参数 参数类型 描述 device_id String 设备ID，设备唯一标识符 result ResultInfo object 错误或正确信息 表6 ResultInfo 参数 参数类型 描述 code String 单个结果码 msg String 单个结果信息
-
URI POST /v1/{user_id}/device-orgs/{device_org_id}/move-devices 表1 路径参数 参数 是否必选 参数类型 描述 device_org_id 是 String 设备分组ID：由数字组成，长度范围[1,25]，可以从查询子级设备组织获取，根节点下不允许添加设备 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节
-
基本消息结构体 推送消息给企业ISV平台时，各参数定义如下： 请求头header，当用户设置auth_key的值，会携带这两个请求头。 表1 请求头header 字段名 类型 是否可为空 说明 X-Ivm-Timestamp Int64/long整型 不为空 UNIX时间戳，整型正数，固定长度10，1970年1月1日以来的秒数，表示回调请求发起时间。 X-Ivm-Signature String 不为空 接口请求token，token生成方式，为将callback_url，X-Ivm-Timestamp，auth_key三个字段进行拼接，字段中间以竖线（|）分隔，后计算sha256值。即 X-Ivm-Signature = sha256(callback_url|X-Ivm-Timestamp|auth_key)，回调消息接收端接收请求后可自行计算该值并做比较，若不相等，则请求非法 表2 结构体req 字段名 类型 是否可为空 说明 message_id Int64/long整型 不为空 消息ID：该消息的唯一标识，根据时间戳生成（18到32位的数字），无重复 message_type String 可能为空 消息类型：分为设备智能告警消息、设备异常告警消息、设备解绑消息和设备智能数据消息四大类 枚举值： 设备智能告警消息： device_alarm 智能告警消息，包含目标智能告警，口罩告警，周界告警，人群态势告警及第三方智能告警消息等 设备异常告警消息： device_status 设备异常消息，包含设备/通道上下线告警，通道名称修改，以及设备升级失败 设备解绑消息： device_unbind 设备解绑和套餐解绑的消息 设备智能数据消息： target_data 智能业务中的目标及目标整体业务 third_data 第三方智能业务，目前是提供整个数据包，使用方需自行解析。订阅时要和第三方智能告警数据区分开 vehicle_data 智能业务中的机非人业务 head_shoulder_data 智能业务中的头肩业务 behavior_analysis_data 智能业务中的行为分析与人车物分离 micro_checkpoint_data 智能业务中的微卡口业务 data Object 可能为空 智能告警信息： 当 message_type 不同时，data 格式不同，可参考message_type里各种类型的介绍； 当智能类型算法升级时，可能会在推送的结构体里添加新字段； test Boolean 不为空 当test字段为true时，表示这是配置回调URL时测试是否可访问的消息，被调用方需要返回响应码为200。注意，此时message_type和data字段不传。 当test字段为false时，表示这是一条推送消息，message_type和data字段正常传入。 父主题： 告警推送消息体结构
-
操作场景 添加设备后，设备下的点位默认没有开通视频管理等服务，您可以按需选择并开通服务。提供的服务如下： 接入调阅服务：提供
视频接入 和管理功能，开通后可以查看实况和录像。使用录像存储服务，首先需要配置接入调阅服务。 录像存储服务：提供云端视频存储功能，开通后设置录像计划进行录像存储，关闭服务后会删除所有录像文件。 行业数据流服务：提供云端存储设备智能告警数据功能，开通后可以在云端保存设备智能告警数据，如智能告警图片、智能分析元数据等。关闭服务后会删除所有相关数据。
-
图像显示 表9 图像显示功能清单 功能 说明 OSD配置 - 用户可以在视频画面上显示时间和文字叠加的效果。可以理解为视频水印。支持配置最多6项OSD水印显示。并且支持调整水印字体大小。 图像套餐 图像套餐 图像套餐为一套图像参数的合集，可通过切换图像套餐或修改图像套餐中参数来达到更改图像参数： 支持使用/复制系统定义图像套餐。 支持新增/修改/删除/使用/复制用户自定义图像套餐，用户最多可自定义8个。 图像调节 支持调节图像基础参数：亮度、饱和度、对比度、锐度。 日夜切换 支持切换昼夜模式，通过调整昼夜模式能帮助摄像机适应低照度条件，体现更高的光灵敏度。 曝光/背光 曝光：支持切换曝光模式，并且可根据被拍摄画面的曝光值手动/自动调整快门速度与增益，提高画面质量。 背光：当曝光模式为自动曝光时，支持切换背光模式： 宽动态：在明暗反差过大的场合，有效解决背景过亮或前景太暗的情况。 强光抑制：有效抑制强光点直接照射问题，把强光部分弱化，把暗光部分亮化，达到光线平衡。 背光补偿模式：有效补偿摄像机在逆光环境下拍摄时画面主体黑暗的缺陷。 背光自适应：可以有效补偿摄像机在逆光环境下拍摄时画面主体黑暗的缺陷。 聚焦 支持切换相机的聚焦模式与聚焦补偿模式，并且可配置最小聚焦距离，提高图像清晰度。 白平衡 支持切换白平衡模式及调整红色增益和蓝色增益。在不同的光照环境中，物体颜色会因投射光线颜色产生变化，通过选择白平衡模式中红色增益和蓝色增益的值来修正颜色误差。 图像增强 在多种异常场景下可增强图像效果： 支持切换透雾模式，在有雾环境下可以使画面更清晰。 支持切换电子防抖模式，在设备抖动时保持大部分画面相对稳定，但会损失部分画面。 支持切换降噪模式，在嘈杂环境下提升语音清晰度。 支持切换伽马矫正，用于调节图像对比度，改善对比度的同时，可避免引入更多新的噪点。 支持切换畸变矫正，在摄像机的图像画面发生一定的几何畸变的情况下使画面更准确。 补光灯控制 支持切换智能红外模式，避免图像过曝。 支持调节内置灯（近光灯/中光灯/远光灯）的亮度与开关灯时间。 图像计划 年度计划 支持针对每月的不同的时间（00 : 00-24 : 00）制定年度图像套餐应用计划。 当前时间到达配置时间时，图像套餐自动切换为年度计划配置的套餐。 可选套餐来源于“图像套餐”，新增可选图像套餐、更改图像套餐参数时，需要前往图像套餐配置。 支持画框、复制、删除、撤销、恢复、清空等操作。 同一时间内只能执行一种套餐，不选择、不设置时为默认套餐。 昼夜计划 支持针对日夜不同场景制定年度图像套餐应用计划。 当通过光线发现周边场景发生变化时，将自动切换为白天套餐/夜晚套餐。 可选套餐来源于“图像套餐”，新增可选图像套餐/更改图像套餐参数时，需要前往图像套餐配置。 支持配置白天套餐、夜晚套餐、光学透雾模式。 同一时间内只能执行一种套餐。 当选择套餐内日夜切换不是自动模式时，无法生效。
-
视音频 表8 视音频功能清单 功能 说明 视频 视频参数 支持切换码流类别：可以根据实际使用情况选择码流组合。 支持切换镜像模式：可对视频画面做上下左右颠倒处理。 支持开启走廊模式：可对视频画面进行90度旋转，得到9:16或者3:4等横纵比。 支持配置全帧率：可更改摄像机最大支持帧率，码流帧率最大值将小于全帧率。 码流参数 支持切换编码协议：可更改编码协议为“H.264”、“H.265”、“MJPEG”。 支持开启智能编码能力与配置智能级别：智能编码可帮助摄像机自适应场景，降低码率大小，节省存储空间；智能级别越高，降低码率效果越显著。 支持开启多slice编码能力：将视频流分成多段，每段的编码过程是相互独立的，提升编码和解码的性能。 支持切换编码复杂度：可更改编码复杂度为“Base Profile”、“Main Profile”、“High Profile”，编码压缩性能依次升高，硬件设备解码性能要求也依次升高。 支持切换分辨率：可更改视频分辨率，分辨率越高，图像越清晰，占用的带宽越大。 支持切换码率类型：可切换码率类型为“变码率”或者“定码率”，并配置对应的码率上限、码率值。 支持切换图像质量：图像质量越好，占用带宽越大。 支持配置帧率：可更改每秒显示的帧数，帧率越高，图像越真实，占用带宽越大。 支持配置I帧间隔：可更改I帧（每个画面组的第一个帧）的时间间隔，I帧间隔越小，视频质量越高，占用带宽越大。 支持开启分层编码能力：编码时可以输出多层码流（基本层和增强层），同时保证视频流畅度和视频质量，提升编码和解码性能。 支持配置JPEG质量：可调整图像质量，JPEG质量数值越大，视频质量越好，占用带宽越大。 支持切换动态码率模式与动态帧率模式：当触发告警时，摄像机会自动采用动态码率/帧率值，告警结束后重新返回在码流中设置的码率/帧率值。 音频 音频参数 支持切换音频编码格式：可根据使用场景更改编码格式为“G.711u”、“G.711a”、“G.726”、“OPUS”、“AAC”。 支持切换输入端口类型：可更改音频流接入端口的类型为“Mic-in”、“Line-in”、“Double-Mic-in”。 支持配置输入、输出音量。 支持配置音频码率：音频码率值越大，音质越好，占用带宽越大。 支持配置音频采样率：录音设备在一秒钟内对声音信号的采样次数，采样率越高，声音的还原就越真实越自然。 支持开启环境噪声过滤：将周围环境的噪声减小，使有效声音更清晰。 支持开启音频自动增益：提升音频质量。 支持开启回声消除：可消除录制的语音数据中的AO设备播放的声音，提升音频质量。 支持开启二次降噪：用于去除外界噪声，提升音频质量。 支持开启抗削波：用于控制输出信号电平，防止削波（破音）。
-
智能配置 摄像机目标智能应用场景如表2所示，操作指导参见目标智能。 表2 摄像机目标智能应用场景 功能 说明 目标抓拍 对设定区域中目标进行抓拍，实时显示目标信息。以及发送目标图片。 口罩告警 对设定区域中目标是否佩戴口罩进行检测并告警。 目标统计 统计设定区域内越线的人流量，超过阈值时生成告警。 摄像机车辆智能应用场景如表3所示，操作指导参见车辆智能。 表3 摄像机车辆智能应用场景 功能 说明 机动车抓拍 对设定区域内的机动车进行抓拍，发送目标图片。 违法停车 检测到设定区域内有违法停车，生成告警。 摄像机非人参数应用场景如表4所示，操作指导参见机非人参数。 表4 摄像机机非人参数应用场景 功能 说明 机非人参数 对设定区域中机动车、非机动车、行人进行抓拍，发送图片。 摄像机智能行为分析智能应用场景如表5所示，操作指导参见行为分析智能配置。 表5 摄像机行为分析智能应用场景 功能 说明 越线检测 检测人员从某个设定方向越过设定边界的事件并告警。 入侵检测 检测人员在设定区域内出现的事件并告警。 区域进入 检测人员进入设定区域内的事件并告警。 区域离开 检测人员离开设定区域内的事件并告警。 快速移动 检测目标奔跑追逐事件，达到设定条件（通过配置灵敏度来设定条件）后立即告警。 徘徊检测 检测人员在设定区域内徘徊、滞留超过设定时间的事件并告警。 遗留检测 检测到设定区域内有物品遗留的事件并告警。 移走检测 检测到设定区域内有物品移走的事件并告警。 周界全局配置 支持配置周界所有算法的元数据处理、告警处理 、目标尺寸设置、最大目标数设置、检测灵敏度等基础能力。 停车检测 检测机动车在设定区域内停留超过设定时间的事件并告警。 备注 ： 需要开启周界全局开关才可支持算法配置； 单个设备最多支持画10个框，单个告警最多支持画4个框 ；最多支持10点成框； 单个设备最多支持画5条； 布防计划支持自定义计划与四种通用计划（全天候、工作日、周末、工作时间），算法仅在计划时间范围内生； 告警联动中，仅告警策略的联动状态为生效时，告警才会通过该策略上报。 摄像机电瓶车检测应用场景如表6所示，操作指导参见电梯楼道电瓶车检查。 表6 摄像机电瓶车检测应用场景 功能 说明 电梯楼道 检测到指定区域里的电瓶车，触发告警。 摄像机智能态势分析智能应用场景如表7所示，操作指导参见态势分析智能配置。 表7 摄像机智能态势分析应用场景 功能 说明 过线统计 统计设定区域内越线的人流量，超过阈值时生成告警。 人群密度 统计设定区域内人数，超过阈值时生成告警。 排队长度 统计设定区域内排队人数，总排队时长超过阈值时生成告警。 离岗检测 统计设定区域内在岗人数，少于设定人数且离岗时间超过阈值时生成告警。 热区分析 统计设定区域内驻足人次、驻足均时；人员进出时间、驻足时间。 热度图 统计设定区域内一定时间内的人群分布，生成报告。
-
告警配置 表1 告警配置功能清单 功能 说明 联动策略总开关 - 支持配置“告警联动策略”启用开关，控制所有事件的“告警联动策略”。 当总开关未开启时，单个告警配置开启时也不会生效。 设置对应的告警联动策略前，必须开启对应的开关。 普通告警 布防计划 配置告警上报计划，相关告警仅在计划时间内生效并上报。 支持自定义计划，支持画框、复制、删除、撤销、恢复、清空等操作。 支持四种通用计划：全天候、工作日、周末、工作时间。 告警联动 配置告警上报的时间间隔与方式。 支持配置告警间隔：针对事件类告警，系统按配置的告警间隔对业务上报的告警进行时间过滤，确保连续上报的告警发生时间不小于告警间隔。 支持配置告警联动策略：仅告警策略的联动状态为“生效”时，告警才会通过该策略上报。
-
高危操作清单 表1 高危操作一览表 操作对象 操作名称 风险描述 风险等级 应对措施 服务 关闭服务 关闭服务后会立即清理该通道下正在使用或者已经存储的相关数据资源，详细说明如下： 管理服务：该通道所有媒体相关服务，如实况播放，录像回放等。 收录服务：停止该通道云端录像计划，删除已存储的云端录像文件。 行业数据流服务：停止该通道行业数据流数据存储及转发能力，删除已存储的行业数据流数据。 高 操作之前，确认是否不再使用服务 企业 解散企业 解散企业后会将该企业下所有设备进行删除。 高 操作之前，确认是否有其他人在使用，并做好云存备份 如果误操作，可以重新创建，添加，但云存数据会被清理 用户 用户注销 用户注销后，会将该用户下所有用户数据进行清除，包含个人信息，个人所拥有设备信息，个人与企业权限关系等。 若用户属于某企业，用户注销只会删除用户与企业的权限关系，不影响企业下设备的正常使用。 中 操作之前，确认是否不再使用服务 AK/SK 删除AK/SK 企业开发者删除AK/SK后，原有企业凭证申请的所有AccessToken均会失效。 中 操作之前，确认是否有其他人在使用 如果误操作，请通知并替换新的AK/SK AccessToken 申请AccessToken 单个AK/SK只维护最新两个AccessToken的有效性，申请新的AccessToken会自动覆盖较早AccessToken有效性。 中 操作之前，确认是否有其他人在使用 如果误操作，请通知并替换新的AK/SK 设备 格式化SD卡 云服务下发格式化SD卡命令后，会删除设备本地存储的录像，且该操作不可逆。 高 操作之前，请做好本地数据备份 删除设备 删除设备后，会自动关闭该设备下所有通道开通的服务，同时将该设备从设备列表（含持有人及被分享人）中删除。 中 操作之前，确认是否有其他人在使用，并做好云存备份 如果误操作，可以重新添加，但云存数据会被清理 解绑设备 用户可以选择登录设备页面后进行设备与云服务解绑。 解绑后，该设备在云服务开通的服务会关闭，用户绑定关系会进行删除，该设备可以重新进行添加绑定。 中 操作之前，确认是否有其他人在使用，并做好云存备份 如果误操作，可以重新创建，添加，但云存数据会被清理 设备重启 云服务下发设备重启后，会导致该设备实况和录像中断。 低 暂无 父主题： 参考
-
包周期套餐包报价 表1 接入调阅服务套餐的商用报价 套餐包 接入路数（路） 调阅带宽（mbps） 官网单价（套/月） 官网包年价（套/年） 价格单位 体验版 20 1 0 - 元 IVM标准版（B100） 100 5 240 2400 元 IVM标准版（B500） 500 25 800 8000 元 IVM标准版（B2000） 2000 100 3000 30000 元 IVM标准版（B5000） 5000 250 6000 60000 元 IVM高级版（A100） 100 20 700 7000 元 IVM高级版（A500） 500 100 2500 25000 元 IVM高级版（A2000） 2000 200 5000 50000 元 IVM高级版（A5000） 5000 500 11000 110000 元 备注： 接入调阅服务套餐包括接入路数与调阅带宽： 实际接入路数达到套餐包接入路数限额后，您将无法将设备绑定该套餐包，但仍可绑定按需计费服务； 每天峰值带宽消耗超过套餐包最高带宽时，超出部分将按照按需计费（1.20元/mbps/天）收取额外费用。 调阅带宽使用场景： 实况/回放预览、回放录像下载：调阅带宽使用量与视频码率&音频码率有关，可配置相机码率上限限制码率。例如：5mbps码率预估支持6路512kbps码率或1024kbps码率视频同时播放； 告警图片下载：调阅带宽使用量与图片下载速率&并发数量有关； 告警数据转发：调阅带宽使用量与告警转发速率&并发数量有关，可配置相机告警生成间隔时间抑制告警并发数量。
-
到期与欠费 套餐到期 接入调阅套餐到期后，设备将无法继续使用行业视频管理服务，需要给设备绑定新的套餐，或者绑定按需计费。 录像存储套餐到期后，设备将停止将录像存至云端，需要给设备绑定新的套餐，或者绑定按需计费。云上存储的数据，超过保留期后会从行业视频管理删除。 账户欠费 账户欠费超过保留期后，视频点位会自动解绑按需计费，变为失效。账户缴费后，您可以点“恢复按需计费”按钮，恢复所有失效点位的按需计费服务。
