华为云用户手册

URI GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/time-policy 表1 路径参数 参数 是否必选 参数类型 描述 channel_id 是 String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节 表2 Query参数 参数 是否必选 参数类型 描述 record_type 否 String 录像类型：枚举类型，默认为normal 枚举值： normal 连续云 alarm 动检云

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 device_id String 设备id channel_id String 设备通道id time_policies Array of TimePolicy objects 资源储存留存期集合 表5 TimePolicy 参数 参数类型 描述 storage_days Integer (单位：天) 留存期：0：代表永久，不传默认0。留存期取值范围：[1,365]， 公测期间，在白名单内的企业，开通管理服务、收录服务、录像计划存储周期不限[1,365]，不在白名单内的企业，限额如下：管理服务100路，收录服务10路，录像计划存储周期1-7天 storage_type String 留存期类型：计划录像：PLAN_RECORD 动检录像：MOTION_RECORD 枚举值： PLAN_RECORD MOTION_RECORD

响应示例 状态码： 200 OK { "device_id" : "952352LWXT***", "channel_id" : "0", "time_policies" : [ { "storage_days" : 15, "storage_type" : "PLAN_RECORD" }, { "storage_days" : 7, "storage_type" : "MOTION_RECORD" } ] }

响应示例 状态码： 200 OK { "device_id" : "952352LWXT***", "channel_id" : "0", "plans" : [ { "alarm_type" : "motion_detection", "advance_time" : 30, "after_time" : 15 } ], "all_day" : false, "time_sections" : [ { "day_of_week" : 1, "start_time" : "00:02:00", "end_time" : "00:05:00" } ] }

URI GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/record-alarm-plan 表1 路径参数 参数 是否必选 参数类型 描述 channel_id 是 String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 device_id String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 channel_id String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 plans Array of GetChannelRecordAlarmPlan objects 动检录像计划列表 all_day Boolean 是否全程录像：枚举类型。 默认为false，如果为true，time_sections省略（不进行校验） 枚举值： true 是 false 否 time_sections Array of TimeSection objects 通道录像计划时间段 表4 GetChannelRecordAlarmPlan 参数 参数类型 描述 alarm_type String 告警类型：枚举类型 枚举值： motion_detection 移动侦测报警 io_event 外部IO输入报警 target_alarm 目标报警 mask_alarm 口罩报警 people_queue_alarm 排队长度报警 people_count_region_alarm 区域人数统计报警 people_count_line_alarm 过线人数统计报警 over_line_alarm 越线检测报警 region_invasion_alarm 区域入侵报警 region_in_alarm 区域进入报警 region_out_alarm 区域离开报警 fast_move_alarm 快速移动报警 linger_alarm 徘徊检测报警 thirdparty_intelligent 第三方告警 face_alarm 人脸告警 abandon_alarm 物品遗留告警 removed_alarm 物品移走告警 electric_bicycle_alarm 电瓶车检测告警 people_leave_station_alarm 人员离岗告警 lift_electric_alarm 电梯电瓶车告警_新 occlusion_alarm 遮挡告警 advance_time String 预录时间，取值范围[1,59] after_time String 延录时间，取值范围[1,59] 表5 TimeSection 参数 参数类型 描述 day_of_week Integer 日期：取值[1,7]（对应周一~周日） 最小值：1 最大值：7 start_time String 录像开始时间：格式为HH:mm:ss，范围为[00:00:00~23:59:59] end_time String 录像结束时间：格式为HH:mm:ss，范围为[00:00:00~23:59:59]

响应示例 状态码： 200 OK { "fail_num": 0, "channels": [ { "device_id": "952352LWXT***", "channel_id": "0", "live_url": "jvmp://123.123.*.*:***/live/952352LWXT***?token=...", "result": { "code": "IVM.0", "msg": "Success" } }, { "device_id": "952352DJNR***", "channel_id": "0", "live_url": "http://123.123.*.*:***/live/live.m3u8?token=...&device_id=952352DJNR***&channel_id=0&stream_type=0&forbid_audio=1", "result": { "code": "IVM.0", "msg": "Success" } }, { "device_id": "952352DJNR***", "channel_id": "0", "live_url": "https://123.123.*.*:***/live/live.m3u8?token=...&device_id=952352DJNR***&channel_id=0&stream_type=0", "result": { "code": "IVM.0", "msg": "Success" } } ], "request_id": "0e3515f7-4c5e-497f-abb8-4541d6963dd2" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 表3 请求Body参数 参数 是否必选 参数类型 描述 channels 是 Array of GetLiveURLChannelsParam objects 通道列表 expire_time 否 Integer 自定义Url过期时间：时间范围[30, 86400]，不传默认为 30（单位/秒） 备注：仅对channels中的live_url有效 use_times 否 Integer 自定义Url使用次数：枚举类型，当expire_time和use_times都不填写时，use_times默认为1，仅use_times不填写时，use_times默认为0，RTSP协议固定为 0 备注：仅对channels中的live_url有效 枚举值： 0 使用一次 1 有效时间内任意使用，此参数对RTSP协议无效 表4 GetLiveURLChannelsParam 参数 是否必选 参数类型 描述 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度固定为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 channel_id 是 String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 live_protocol 是 String 媒体播放协议：枚举类型，选择获取地址的媒体播放协议类型 枚举值： HOLO 好望协议 HLS 基于HTTP的HLS流媒体传输协议（该协议存在安全风险，建议优先使用其他协议） HLS_HTTPS 基于HTTPS的HLS流媒体传输协议 HTTP_FLV 基于HTTP的FLV媒体协议（该协议存在安全风险，建议优先使用其他协议） HTTPS_FLV 基于HTTPS的FLV媒体协议 RTSP RTSP流媒体传输协议（该协议存在安全风险，建议优先使用其他协议） stream_type 是 String 码流类型：枚举类型 枚举值： PRIMARY_STREAM 主码流 SECONDARY_STREAM_1 子码流1 SECONDARY_STREAM_2 子码流2 forbid_audio 否 Integer 禁用音频选项：不填写默认值为 0 备注：只针对HLS有效，推荐微信小程序端使用禁用音频选项 枚举值： 0 不禁用音频 1 禁用音频 trans_protocol 否 String 传输协议：枚举类型，不填写时默认值为 TCP，仅适用于gb28181，其它接入协议无效 枚举值： TCP TCP传输协议 UDP UDP传输协议

请求示例 查询通道实况播放地址 POST /v1/2562572829***/devices/channels/cloud-live/url { "channels": [ { "device_id": "952352LWXT***", "channel_id": "0", "live_protocol": "HOLO", "stream_type": "PRIMARY_STREAM" }, { "forbid_audio":1, "device_id": "952352DJNR***", "channel_id": "0", "live_protocol": "HLS", "stream_type": "PRIMARY_STREAM" }, { "device_id": "952352DJNR***", "channel_id": "0", "live_protocol": "HLS_HTTPS", "stream_type": "PRIMARY_STREAM" }] }

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 fail_num Integer 获取设备url失败的数量 channels Array of getLiveURLChannelsResp objects 响应信息 request_id String 该请求的记录id 表6 getLiveURLChannelsResp 参数 参数类型 描述 device_id String 设备ID：设备唯一标识，长度范围[1,32] channel_id String 通道ID：长度范围[1,20] live_url String 媒体实况播放地址：将此url输入播放地址栏开始播放 result Result object 错误信息 表7 Result 参数 参数类型 描述 code String 错误编码：请参见错误码 msg String 错误信息

URI GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/control-lock 表1 路径参数 参数 是否必选 参数类型 描述 channel_id 是 String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节

URI GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/cloud-records/playback-url 表1 路径参数 参数 是否必选 参数类型 描述 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度固定为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 channel_id 是 String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 表2 Query参数 参数 是否必选 参数类型 描述 playback_protocol 是 String 媒体播放协议：枚举类型，选择获取地址的媒体播放协议类型 枚举值： HOLO 好望协议 HLS 基于HTTP的HLS流媒体传输协议（该协议存在安全风险，建议优先使用其他协议） HLS_HTTPS 基于HTTPS的HLS流媒体传输协议 RTSP RTSP流媒体传输协议（该协议存在安全风险，建议优先使用其他协议） record_type 否 String 录像类型：枚举类型，不填则默认包含以下两种录像类型 枚举值： NORMAL_RECORD 全量录像 MOTION_RECORD 动检录像 start_time 是 String 开始时间：格式如：yyyy-MM-dd HH:mm:ss，北京时间 end_time 是 String 结束时间：格式如：yyyy-MM-dd HH:mm:ss，北京时间 expire_time 否 String 自定义Url过期时间：时间范围[30, 86400]，不填写时默认值为 30（单位/秒） 备注：仅对channels中的live_url有效 use_times 否 String 自定义Url使用次数：枚举类型，当expire_time和use_times都不填写时，use_times默认为1，仅use_times不填写时，use_times默认为0，RTSP协议固定为 0 备注：仅对channels中的live_url有效 枚举值： 0 使用一次 1 有效时间内任意使用，此参数对RTSP协议无效

请求示例 查询云端的录像回放地址 GET /v1/2562572829***/devices/952352LWXT***/channels/0/cloud-records/playback-url?start_time=2020-07-15 14:32:00&end_time=2020-07-15 15:32:00&playback_protocol=HOLO GET /v1/2562572829***/devices/952352LWXT***/channels/0/cloud-records/playback-url?start_time=2020-07-15 14:32:00&end_time=2020-07-15 15:32:00&playback_protocol=HLS GET /v1/2562572829***/devices/952352LWXT***/channels/0/cloud-records/playback-url?start_time=2020-07-15 14:32:00&end_time=2020-07-15 15:32:00&playback_protocol=HLS_HTTPS

响应示例 状态码： 200 OK { "device_id" : "952352LWXT***", "channel_id" : "0", "playback_url" : "holo://123.123.*.*:***/vod/952352LWXT***?token=..." } { "device_id" : "952352LWXT***", "channel_id" : "0", "playback_url" : "http://123.123.*.*:***/vod/vod.m3u8?token=...&device_id=952352LWXT***&channel_id=0" } { "device_id" : "952352LWXT***", "channel_id" : "0", "playback_url" : "https://123.123.*.*:***/vod/vod.m3u8?token=...&device_id=952352LWXT***&channel_id=0" }

响应示例 状态码： 200 OK { "devices" : [ { "device_id" : "952352LWXT***", "device_name" : "好望设备", "device_state" : "UNREGISTERED", "device_type" : "IPC", "device_system_state" : "NORMAL", "access_protocol" : "HOLO", "manufacture" : "HUAWEI", "device_ability" : "ptz", "channel_total" : "1", "channels" : [ { "channel_resource_state" : [ "MANAGEMENT_GRANT", "INDUSTRY_DATA_GRANT", "FULL_RECORD_GRANT", "EVENT_RECORD_CLOSED" ], "channel_state" : "ONLINE", "channel_system_state" : "NORMAL", "channel_id" : "0", "channel_name" : "好望通道", "invalid_type" : "NORMAL" } ], "operator_total" : "0", "create_time" : "2020-09-01 17:09:12", "update_time" : "2020-12-30 09:30:31", "device_org_name" : "好望设备组" } ], "total" : 1, "device_total" : 1, "admin_total" : 0, "online_total" : 0 }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 devices Array of InnerDeviceInfoMuti objects 设备列表 total Integer 查询条数 device_total Integer 设备总数 admin_total Integer 管理员总数 online_total Integer 在线设备数 表5 InnerDeviceInfoMuti 参数 参数类型 描述 device_id String 设备ID，设备唯一标识符 device_name String 设备名称 device_state String 设备状态 枚举值： OFFLINE 离线 ONLINE 在线 UNREGISTERED 未注册 device_type String 设备类型 枚举值： IPC 直连摄像机 NVR NVR设备 MEdge IVS1800设备 device_system_state String 设备系统冻结 枚举值： NORMAL 正常 UNAVAILABLE_FROZEN 冻结 access_protocol String 接入协议类型 枚举值： HOLO 好望协议 GB28181 国标协议 manufacture String 生产厂家 device_ability String 设备能力集：枚举类型，参考附录设备能力集，多个能力集用英文逗号分隔 channel_total Integer 通道总数 channels Array of InnerChannelInfo objects 通道信息 operator_total Integer 该设备绑定的普通用户总数 model String 设备型号 create_time String 设备添加时间 update_time String 设备更新时间，在设备重新上线后或者移动设备分组后会修改时间 device_org_name String 设备组织名称 frimware String 设备版本 channel_allocated_total Integer 已分配通道总数 channel_online_count Integer 在线通道总数 audio_input_cnt Integer 音频输入通道个数 audio_output_cnt Integer 音频输出通道个数 gb_access_state String 国标设备未上线原因 枚举值 NOT_CONNECTED：云服务未收到设备信息 NO_AUTHENTICATION_INFO：云服务接受设备信息不全 AUTHENTICATION_FAILED：鉴权失败 CATA LOG _ERROR：未收到正确的通道信息 UNKNOWN_ERROR：未知错误 CONNECTED：已连接 表6 InnerChannelInfo 参数 参数类型 描述 channel_resource_state Array of strings 通道资源列表：一个通道可以存在多个套餐，枚举类型 枚举值： MANAGEMENT_GRANT 管理套餐开通 MANAGEMENT_ARREAR 管理套餐欠费 MANAGEMENT_CLOSED 管理套餐未开通 EVENT_RECORD_GRANT 动检套餐开通 EVENT_RECORD_ARREAR 动检套餐欠费 EVENT_RECORD_CLOSED 动检套餐关闭 FULL_RECORD_GRANT 全量套餐开通 FULL_RECORD_ARREAR 全量套餐欠费 FULL_RECORD_CLOSED 全量套餐关闭 INDUSTRY_DATA_GRANT 行业数据流套餐开通 INDUSTRY_DATA_ARREAR 行业数据流套餐欠费 INDUSTRY_DATA_CLOSED 行业数据流套餐关闭 channel_state String 通道状态：枚举类型 枚举值： OFFLINE 离线 ONLINE 在线 UNREGISTERED 未注册 channel_system_state String 设备系统状态：枚举类型 枚举值： NORMAL 正常 UNAVAILABLE_FROZEN 冻结 channel_id String 通道ID channel_name String 通道名称 channel_model String 通道的设备型号 channel_mode String 通道的设备型号，此字段已废弃，不推荐使用，建议使用channel_model字段代替 invalid_type String 通道无效类型：枚举类型 枚举值： NORMAL 正常 CHANNEL_ID_INVALID 通道ID无效 channel_ability String 通道能力集 storage_card_status String SD卡状态 枚举类型： 0-卡存在且运行正常 1-卡存在但是异常需要格式化 2-卡不存在 3-格式化中 -1-设备不支持 mask_mode String 隐私遮蔽开关状态 枚举类型： OPEN-开 CLOSE-关

URI GET /v1/{user_id}/device-orgs/{device_org_id}/devices 表1 路径参数 参数 是否必选 参数类型 描述 device_org_id 是 String 设备组织ID：由数字组成，长度范围[1,25]，根组织节点的值为0，可以从查询子级设备组织获取 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节 表2 Query参数 参数 是否必选 参数类型 描述 access_protocol 否 String 接入协议：枚举类型，多个查询使用英文逗号分隔 枚举值： HOLO 好望协议 GB28181 国标协议 channel_resource_state 否 String 通道资源状态：枚举类型，多个查询使用英文逗号分隔 枚举值： MANAGEMENT_GRANT 管理套餐开通 MANAGEMENT_ARREAR 管理套餐欠费 MANAGEMENT_CLOSED 管理套餐未开通 EVENT_RECORD_GRANT 动检套餐开通 EVENT_RECORD_ARREAR 动检套餐欠费 EVENT_RECORD_CLOSED 动检套餐关闭 FULL_RECORD_GRANT 全量套餐开通 FULL_RECORD_ARREAR 全量套餐欠费 FULL_RECORD_CLOSED 全量套餐关闭 INDUSTRY_DATA_GRANT 行业数据流套餐开通 INDUSTRY_DATA_ARREAR 行业数据流套餐欠费 INDUSTRY_DATA_CLOSED 行业数据流套餐关闭 ability 否 String 设备能力：枚举类型，仅支持单个能力集查询 枚举值： algorithm 算法能力 ptz 云台能力 device_id 否 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 device_name 否 String 模糊查询字段：支持设备名称模糊匹配，由字符组成，支持数字、中文（一个汉字算两个字符）、英文、-、_、空格，长度范围[1,128] device_state 否 String 设备状态：枚举类型，多个查询使用英文逗号分隔 枚举值： OFFLINE 离线 ONLINE 在线 UNREGISTERED 未注册 device_system_state 否 String 设备系统状态：枚举类型，多个查询使用英文逗号分隔 枚举值： NORMAL 正常 UNAVAILABLE_FROZEN 冻结 device_type 否 String 设备类型：枚举类型，多个查询使用英文逗号分隔 枚举值： IPC 直连摄像机 NVR NVR设备 MEdge IVS1800设备 direction 否 String 排序方向：枚举类型，默认降序，不区分大小写 枚举值： ASC 升序 DESC 降序 group_ids 否 String 所属分组ID列表：支持多个设备组织查询，使用英文逗号分隔 单个设备组织ID：由数字组成，长度范围[1,25]（根组织节点的值为0） is_current_org 否 String 是否属于当前组织：枚举类型，不填就是查询全部组织 枚举值： 0 下级组织 1 当前组织 2 所有组织 limit 否 Integer 限制条数：取值范围[0,1000]，不填写时默认值为10 manufactures 否 String 厂商：支持多个厂商查询，使用英文逗号隔开 单个厂商：由中文（一个汉字算两个字符）、英文、数字 、特殊字符（_-空格）组成，长度范围[1,64] offset 否 Integer 偏移量页数：0为第一页，取值范围[0,2147483646]，不填写时默认为0 sort_by 否 String 排序字段：枚举类型，默认按创建时间create_time排序 枚举值： create_time 创建时间 update_time 更新时间 operator_total 拥有该设备的普通用户总数 user_order 否 Integer 排序字段：枚举类型，按用户数排序（当前无效） 枚举值： 0 数量从小到大 1 数量从大到小

请求示例 查询前端的录像回放地址 GET /v1/2562572829***/devices/952352LWXT***/channels/0/device-records/web-playback-url?start_time=2021-12-04 15:09:00&end_time=2021-12-04 15:10:00&playback_protocol=HLS_DEV GET /v1/2562572829***/devices/952352LWXT***/channels/0/device-records/web-playback-url?start_time=2021-12-04 15:09:00&end_time=2021-12-04 15:10:00&playback_protocol=HLS_DEV_HTTPS

响应示例 状态码： 200 OK { "device_id" : "952352LWXT***", "channel_id" : "0", "playback_url" : "http://123.123.*.*:***/dev_vod/vod.m3u8?token=...&device_id=952352LWXT***&channel_id=0&stream_type=0" } { "device_id" : "952352LWXT***", "channel_id" : "0", "playback_url" : "https://123.123.*.*:***/dev_vod/vod.m3u8?token=...&device_id=952352LWXT***&channel_id=0&stream_type=0" }

URI GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/device-records/web-playback-url 表1 路径参数 参数 是否必选 参数类型 描述 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度固定为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 channel_id 是 String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 表2 Query参数 参数 是否必选 参数类型 描述 protocol 是 String 媒体播放协议：枚举类型，选择获取地址的媒体播放协议类型 枚举值： HLS_DEV 基于HTTP的HLS流媒体传输协议的前端录像（该协议存在安全风险，建议优先使用其他协议） HLS_DEV_HTTPS 基于HTTP的HLS流媒体传输协议的前端录像 RTSP_DEV RTSP流媒体传输协议的前端录像（该协议存在安全风险，建议优先使用其他协议） HTTP_FLV_DEV 基于HTTP的FLV媒体协议的前端录像（仅适用于国标设备）（该协议存在安全风险，建议优先使用其他协议） HTTPS_FLV_DEV 基于HTTPS的FLV媒体协议的前端录像（仅适用于国标设备） start_time 是 String 开始时间：格式如：yyyy-MM-dd HH:mm:ss，北京时间 end_time 是 String 结束时间：格式如：yyyy-MM-dd HH:mm:ss，北京时间 expire_time 否 String 自定义Url过期时间：时间范围[30, 86400]，不填写时默认值为 30（单位/秒） 备注：仅对响应Body参数中的playback_url有效 use_times 否 String 自定义Url使用次数：枚举类型，当expire_time和use_times都不填写时，use_times默认为1，仅use_times不填写时，use_times默认为0，RTSP_DEV协议固定为 0 备注：仅对响应Body参数中的playback_url有效 枚举值： 0 使用一次 1 有效时间内任意使用，此参数对RTSP_DEV协议无效 trans_protocol 否 String 传输协议：枚举类型，不填写时默认值为 TCP，仅适用于gb28181，其它接入协议无效 枚举值： TCP TCP传输协议 UDP UDP传输协议 stream_type 否 String 码流类型：枚举类型，不填写时默认值为 PRIMARY_STREAM 枚举值： PRIMARY_STREAM 主码流 SECONDARY_STREAM_1 子码流1 SECONDARY_STREAM_2 子码流2

URI POST /v1/{user_id}/devices/{device_id}/channels/{channel_id}/control-lock 表1 路径参数 参数 是否必选 参数类型 描述 channel_id 是 String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节

消息结构体介绍 表1 message_type为target_data时，data结构体如下 字段名 类型 说明 device_id String 设备ID：正常情况下不为空，必传 channel_id String 通道ID：正常情况下不为空，必传 report_time String 上报告警时间：示例：2020-09-26T14:28:00+08:00 data_id String 数据ID：正常情况下不为空，必传。可用于查询智能图片数据，参考链接：智能图片下载 itgt_type Int 智能业务场景 枚举值： 1 目标属性检测 2 目标识别 20 一拖N 22 特征协同 itgt_version String 目标识别算法版本号 quality_score Int 目标识别目标抠图质量分 age Int 年龄：取值范围[0,99]（0为未知年龄） age_group String 年龄区间 枚举值： 0 未知 1 少年 2 青年 3 老年 4 儿童 5 中年 gender String 性别，当检测到目标属性传该值 枚举值： male 男性 female 女性 unknown 未知 glasses String 是否戴眼镜，当检测到目标属性传该值 枚举值： true 戴眼镜 false 不戴眼镜 unknown 未知 hair String 发型，当检测到目标属性传该值 枚举值： long 长头发 short 短头发 unknown 未知 hat String 是否戴帽子，当检测到目标属性传该值 枚举值： true 戴帽子 false 不戴帽子 unknown 未知 mouth_mask String 是否带口罩，当检测到目标属性传该值 枚举值： true 戴口罩 false 不戴口罩 unknown 未知 target_id Int 目标ID global_obj_id Int64 全局ID，设备传入的唯一标识 target_expression String 目标表情，当检测到目标属性传该值 枚举值： smile 微笑 anger 愤怒 sad 悲伤 normal 正常 surprised 惊讶 unknown 未知 target_url String 目标抠图的 URL target_all_pic_url String 目标整体抠图的 URL panorama_url String 目标全景的 URL target_pos RectCor object 目标检测框，位置万分比，当设备发送目标图 human_pos RectCor object 人体检测框，位置万分比，当设备发送目标整体图 target_cap_feature String 目标特征值，base64编码的字符串，当设备具有目标识别能力，上层业务可根据两个特征值进行比较，得出目标相似度 target_pic_time Int64 目标抠图产生时间 common Common object 通用数据定义 target Target object 目标：设备上传TLV时的设备的原始数据，该字段是设备上传的原始数据的解析，不同的业务场景传入的字段会不相同。 表2 RectCor 字段名 类型 说明 x_cor Int x坐标：上层业务检测框左上角坐标点计算方式，x1 = x_cor *全景图像素宽度/ 10000 y_cor Int y坐标：上层业务检测框左上角坐标点计算方式，y1 = y_cor *全景图像素高度/ 10000 width Int 像素高度：上层业务检测框宽度计算方式 widht1 = widht *全景图像素宽度/ 10000 height Int 像素宽度：上层业务检测框长度计算方式 height1 = height *全景图像素高度/ 10000 表3 Common 字段名 类型 说明 channel_id Int64 通道ID channel_id_ex Int64 相机扩展通道ID pts Int64 时间戳 sdc_device_id String 主从机设备ID sdc_uuid String 摄像机视频源通道号 target_type Int 智能业务场景 枚举值： 1 目标属性检测 2 目标识别 20 一拖N 22 特征协同 trecord_type Int 告警类型，见附录告警类型 vehicle_type Int 机非人类型，当检测到机非人属性时传该值，见附录机非人类型 vehicle_type_ext Int 机非人扩展类型，当检测到机非人属性时传该值，见附录机非人类型，例如机非人类型为轿车，扩展类型为两厢轿车 intelligence_type Int 智能类型 image_height Int 图片高度 image_width Int 图片宽度 meta_type_mask Int 元数据类型掩码 枚举值： 1 框数据 2 图数据 8 保活数据 16 告警数据 表4 Target 字段名 类型 说明 taget_age Int 年龄：取值范围[0,99]（0为未知年龄） target_expression String 目标表情，当检测到目标属性传该值 枚举值： smile 微笑 anger 愤怒 sad 悲伤 normal 正常 surprised 惊讶 unknown 未知 target_feature TargetAtrrubites object 目标属性对象 target_gender String 性别 枚举值： male 男性 female 女性 unknown 未知 target_glass String 是否带眼镜 枚举值： true 戴眼镜 false 不戴眼镜 unknown 未知 target_glass_type Int 眼镜 枚举值： 0 无 1 普通眼镜 2 太阳眼镜 target_hair String 发型 枚举值： long 长头发 short 短头发 unknown 未知 target_hat String 是否戴帽子 枚举值： true 戴帽子 false 不戴帽子 unknown 未知 target_id Int 目标ID target_lib_type Int 目标库类型 枚举值： 0 默认库 1 黑名单 2 白名单 target_lib_name String 目标库名称 target_lib_recordid Int 目标库中的目标ID，用来维持特征 record的一致性 target_mouth_mask String 是否戴口罩 枚举值： true 戴口罩 false 不戴口罩 unknown 未知 target_mustache Int 是否有胡子 枚举值： 0 没有胡子 1 有胡子 target_panopic_size Int 大图码流的长度 target_panorama String 大图码流，已经转化为图片下载url target_pic String 目标抠图码流，已转化为图片下载url target_pic_kps Int 目标抠图kps质量过滤标志位 target_pic_position Rect object 目标抠图小框位置（万分比） target_pic_time Int64 目标抠图产生时间 target_pic_tzone Int64 目标抠图设备时区：单位毫秒/ms 东区为+ 西区为-，例如：东八区为28800000 body_panopic_size Int64 人体全景大图码流长度 global_object_id Int64 智能目标全局ID human_pic String 目标整体抠图码流，已转化为图片下载url human_pic_kps Int 目标整体抠图kps质量过滤标志位 human_pic_roi Rect object 目标整体抠图中的目标整体目标框 human_rect_position Rect object 目标整体抠图中的目标整体目标框位置 obj_appear_timems Int64 目标起始出现时间：单位毫秒/ms pic_snapshot_dst_offset Int64 夏令时偏移时间：单位秒/s pic_snapshot_time Int 抓拍时间：unix时间戳 pic_snapshot_tzone Int64 抓拍时区：单位毫秒/ms 东区为+ 西区为-，支持夏令时 target_type Int 智能业务场景 枚举值： 1 目标属性检测 2 目标识别 20 一拖N 22 特征协同 trecord_type Int 告警类型，见附录告警类型 vehicle_type Int 机非人类型，当检测到机非人属性时传该值，见附录机非人类型枚举值 vehicle_type_ext Int 机非人扩展类型，当检测到机非人属性时传该值，见附录机非人类型枚举值，例如机非人类型为轿车，扩展类型为两厢轿车 target_recog_box_colour Int 目标识别框颜色 match_type Int 目标识别是否比对成功 枚举值 0 失败 1 成功 snap_matchrate_million Int 发送给元数据网关的匹配率，6位有效数字 target_rec_version String 目标识别算法版本号 target_quality_score Int 目标识别目标抠图质量分 visitor_type Int 访客类型 枚举值 0 社区居民 1 访客 target_match String 目标匹配图 target_matchrate Int 目标匹配率 target_age_group Int 目标年龄人群 枚举值： 0 未知 1 少年 2 青年 3 老年 4 儿童 5 中年 id_cardmd5 String 身份证MD5 total_snap_num Int 抓拍总数 snap_target_num Int 抓拍目标数量 表5 Rect 字段名 类型 说明 x Int x坐标：上层业务检测框左上角坐标点计算方式，x1 = x *全景图像素宽度/ 10000 y Int y坐标：上层业务检测框左上角坐标点计算方式，y1 = y *全景图像素高度/ 10000 width Int 像素高度：上层业务检测框宽度计算方式 widht1 = widht *全景图像素宽度/ 10000 height Int 像素宽度：上层业务检测框长度计算方式 height1 = height *全景图像素高度/ 10000 表6 TargetAtrrubites 字段名 类型 说明 glasses Int 眼镜： 枚举值： 0 戴眼镜 1 不戴眼镜 gender Int 性别 枚举值： 1 女性 2 男性 其他值 未知 age Int 年龄：取值范围[0,99]（0为未知年龄） mouth_mask Int 是否戴口罩 枚举值： 0 不戴口罩 1 戴口罩 expression Int 目标表情 枚举值： 0 微笑 1 愤怒 2 悲伤 3 正常 4 惊讶 示例一、目标属性检测 { "message_id": 1676512199147779269, "message_type": "target_data", "data": { "device_id": "219123456CYP***219123456CYP***", "channel_id": "4", "report_time": "2023-02-16T09:49:56+08:00", "data_id": "167651219912500100070000kcxdq120", "itgt_type": 1, "age_group": "2", "gender": "male", "glasses": "false", "hair": "short", "hat": "false", "mouth_mask": "false", "target_id": 403056, "global_obj_id": 7197546666114033264, "human_pos": { "height": 9222, "width": 5000, "x_cor": 3312, "y_cor": 250 }, "target_url": "https://www.example.com/v1/holo/tlv_219123456CYP***_4_20230216_tlv_167651219912500100010000kcxdq120.jpg/static", "target_all_pic_url": "https://www.example.com/v1/holo/tlv_219123456CYP***_4_20230216_tlv_167651219912500100020000kcxdq120.jpg/static", "panorama_url": "https://www.example.com/v1/holo/tlv_219123456CYP***_4_20230216_tlv_167651219912500100040000kcxdq120.jpg/static", "target_pos": { "x_cor": 1500, "y_cor": 3120, "width": 473, "height": 1000 }, "target_pic_time": 1676512196331, "common": { "channel_id": 101, "channel_id_ex": 101, "image_height": 1080, "image_width": 1920, "meta_type_mask": 2, "pts": 731629820465, "sdc_device_id": "30833dda-60af-9050-d0ee-7b1408902***", "sdc_uuid": "30833dda-60af-9050-d0ee-7b1408902***" }, "target": { "target_age_group": 2, "target_feature": { "glasses": 1, "gender": 2, "age": 0, "mouth_mask": 1, "expression": 0 }, "target_gender": "male", "target_glass": "false", "target_glass_type": 1, "target_hair": "short", "target_hat": "false", "target_id": 403056, "target_mouth_mask": "false", "target_mustache": 1, "target_panopic_size": 136954, "target_panorama": "https://www.example.com/v1/holo/tlv_219123456CYP***_4_20230216_tlv_167651219912500100040000kcxdq120.jpg/static", "target_pic": "https://www.example.com/v1/holo/tlv_219123456CYP***_4_20230216_tlv_167651219912500100010000kcxdq120.jpg/static", "target_pic_kps": 1, "target_pic_position": { "x": 1500, "y": 3120, "width": 473, "height": 1000 }, "target_pic_time": 1676512196331, "target_pic_tzone": 28800000, "body_panopic_size": 28187, "global_object_id": 7197546666114033264, "human_pic": "https://www.example.com/v1/holo/tlv_219123456CYP***_4_20230216_tlv_167651219912500100020000kcxdq120.jpg/static", "human_pic_kps": 1, "human_pic_roi": { "x": 0, "y": 109, "width": 10000, "height": 9796 }, "human_pic_roi": { "x": 3312, "y": 250, "width": 5000, "height": 9222 }, "obj_appear_timems": 1676512196331, "pic_snapshot_dst_offset": 0, "pic_snapshot_time": 1676512196, "pic_snapshot_tzone": 28800000, "target_type": 1, "trecord_type": 3, "vehicle_type": 9, "vehicle_type_ext": 9 } }, "test": false } 示例二、目标识别 { "message_id": 1676373406883530016, "message_type": "target_data", "data": { "device_id": "210123456SML***", "channel_id": "0", "report_time": "2023-02-14T19:16:40+08:00", "data_id": "167637340686100110050000boayq020", "itgt_type": 2, "itgt_version": "SDC_FR V1.8.1b030s001", "age": 45, "age_group": "2", "gender": "female", "glasses": "true", "hair": "short", "hat": "true", "mouth_mask": "false", "quality_score": 87, "target_id": 1206, "global_obj_id": 7199914494412322202, "target_cap_feature": "uhQAAAAAAABiAwAAQggAAKICAABW/f//oRoAABHy//+0GgAA9fb//+PZ//8a6f//6gAAAAnO//8b6f//Ix8AAFUCAAAQ/P//Nfj//8Hz//+88P//weT//9cHAACY/P//+fz//7EGAABq+///wuz//8YGAABI////B/X//+36//8zFwAAXQEAAIkXAABH8///UPH//5fx///oEQAA3QgAAOkJAAA+FQAA3R0AAKDj//8O8P//qgQAAIni//+J5v//yQkAABQSAABjGAAAwf3//5YEAABNFwAApgMAAIYHAAC9EQAAbhEAAPDq//+m+///UQkAAKIUAADkHwAAMwEAAKHs//+O8///o+b//zslAACvKQAAlg8AABLu//8d8///TO///8Dy//+z+///ffz//3UFAADE5P//JxAAANjx//858v//Iw4AAMYCAADz9v//IhAAAC/5//9LLgAALOX//4QLAADSEgAAkQwAAJHs//9OBwAADQ8AABj6//9e/v//G93//5YIAAAmAAAAau7//5YBAABbDgAAYPz//yrS//9OLL4///I////hez//0L4//8j9///IgkAAK0DAAAhDAAA++z//yAUAAA9/f//xgwAAPr9//844f//CPb//+/4//959///UPX//8T///8fAwAAfwoAAO4FAABy6v//ZP7//3z7///h////jAcAAJj0//9tDQAAR+r//4IRAABZ9P//K/L//ycIAABlEgAA5fP//wHi///iFwAAwwUAADLr///bDwAAoBUAAJsHAAAk/f//0P7//7b5///C9f//nO7//y33//+M7f//Cf7//+QDAADd9P//xvz//7L9//9g4v//TQcAAGMHAACI7f//QBMAAHv0//9OGAAAsw0AAH3g//9NKgAAzwwAAHIJAAAhIAAAoPf//ynp//+Y/P//8/v//+UWAADK+f//+wUAALz4//8wDwAAoPf//xMTAAABGAAAURgAANAMAAC/HQAAaCkAAOD3//87CQAAlBkAAOjv//8r/P//NQYAAOQ2AAA8EwAALQoAAF0KAABwBAAAaQQAAB/u///7/f//", "target_expression": "normal", "target_url": "https://api-ivm.myhuaweicloud.com/v1/holo/tlv_210123456SMY***_0_20230214_tlv_167637340686100110010000boxyq020.jpg/static", "panorama_url": "https://api-ivm.myhuaweicloud.com/v1/holo/tlv_210123456SMY***_0_20230214_tlv_167637340686100110040000boxyq020.jpg/static", "target_pos": { "x_cor": 7239, "y_cor": 4888, "width": 750, "height": 1453 }, "target_pic_time": 1676373400610, "common": { "channel_id": 101, "channel_id_ex": 101, "intelligence_type": 1, "meta_type_mask": 2, "pts": 41539402291, "sdc_uuid": "9c0d9984-e09f-477d-f123-f8b96aab5***", "target_type": 2 }, "target": { "target_age": 45, "target_age_group": 2, "target_cap_feature": "uhQAAAAAAABiAwAAQggAAKICAABW/f//oRoAABHy//+0GgAA9fb//+PZ//8a6f//6gAAAAnO//8b6f//Ix8AAFUCAAAQ/P//Nfj//8Hz//+88P//weT//9cHAACY/P//+fz//7EGAABq+///wuz//8YGAABI////B/X//+36//8zFwAAXQEAAIkXAABH8///UPH//5fx///oEQAA3QgAAOkJAAA+FQAA3R0AAKDj//8O8P//qgQAAIni//+J5v//yQkAABQSAABjGAAAwf3//5YEAABNFwAApgMAAIYHAAC9EQAAbhEAAPDq//+m+///UQkAAKIUAADkHwAAMwEAAKHs//+O8///o+b//zslAACvKQAAlg8AABLu//8d8///TO///8Dy//+z+///ffz//3UFAADE5P//JxAAANjx//858v//Iw4AAMYCAADz9v//IhAAAC/5//9LLgAALOX//4QLAADSEgAAkQwAAJHs//9OBwAADQ8AABj6//9e/v//G93//5YIAAAmAAAAau7//5YBAABbDgAAYPz//yrS//9OLL4///I////hez//0L4//8j9///IgkAAK0DAAAhDAAA++z//yAUAAA9/f//xgwAAPr9//844f//CPb//+/4//959///UPX//8T///8fAwAAfwoAAO4FAABy6v//ZP7//3z7///h////jAcAAJj0//9tDQAAR+r//4IRAABZ9P//K/L//ycIAABlEgAA5fP//wHi///iFwAAwwUAADLr///bDwAAoBUAAJsHAAAk/f//0P7//7b5///C9f//nO7//y33//+M7f//Cf7//+QDAADd9P//xvz//7L9//9g4v//TQcAAGMHAACI7f//QBMAAHv0//9OGAAAsw0AAH3g//9NKgAAzwwAAHIJAAAhIAAAoPf//ynp//+Y/P//8/v//+UWAADK+f//+wUAALz4//8wDwAAoPf//xMTAAABGAAAURgAANAMAAC/HQAAaCkAAOD3//87CQAAlBkAAOjv//8r/P//NQYAAOQ2AAA8EwAALQoAAF0KAABwBAAAaQQAAB/u///7/f//", "target_expression": "normal", "target_gender": "female", "target_glass": "true", "target_glass_type": 2, "target_hair": "short", "target_hat": "true", "target_id": 1206, "target_lib_name": "test", "target_lib_recordid": 1, "target_lib_type": 2, "target_match": "https://www.example.com/v1/holo/tlv_210123456SMY***_0_20230410_tlv_168110987103000110080000bdiol010.jpg/static", "target_matchrate": 0, "target_mouth_mask": "false", "target_mustache": 1, "target_panorama": "https://api-ivm.myhuaweicloud.com/v1/holo/tlv_210123456SMY***_0_20230214_tlv_167637340686100110010000boxyq020.jpg/static", "target_pic": "https://api-ivm.myhuaweicloud.com/v1/holo/tlv_210123456SMY***_0_20230214_tlv_167637340686100110010000boxyq020.jpg/static", "target_pic_position": { "x": 7239, "y": 4888, "width": 750, "height": 1453 }, "target_pic_time": 1676373400610, "target_pic_tzone": 28800000, "target_pic_uuid": "000000000000", "target_quality_score": 87, "target_rec_version": "SDC_FR V1.8.1b030s001", "target_recog_box_colour": 255, "global_object_id": 7199914494412322***, "id_cardmd5": "xxxxx", "match_type": false, "obj_appear_timems": 1681109824063, "pic_snapshot_dst_offset": 0, "pic_snapshot_time": 1676373400, "pic_snapshot_tzone": 28800000, "snap_matchrate_million": 0, "snap_target_num": 1, "target_type": 2, "total_snap_num": 1, "visitor_type": 0 } }, "test": false } 示例三、NVR800人脸特征元数据 { "message_id": 1676517738152255022, "message_type": "target_data", "data": { "device_id": "219123456CYP***", "channel_id": "10", "report_time": "2023-02-16T11:21:56+08:00", "data_id": "167651773814300130000000kcxdq140", "itgt_type": 20, "itgt_version": "SDC_FR V1.8.1b030s001", "target_cap_feature": "FAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "target_pic_time": 1676517716849, "common": { "channel_id": 101, "intelligence_type": 1, "pts": 1676546516 }, "target": { "target_cap_feature": "FAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "target_pic_time": 1676517716849, "target_pic_tzone": 28800000, "target_rec_version": "SDC_FR V1.8.1b030s001", "pic_snapshot_dst_offset": 0, "pic_snapshot_time": 1676517716, "pic_snapshot_tzone": 28800000, "target_type": 20 } }, "test": false } 示例四、目标特征协同 { "message_id": 1676517170860820696, "message_type": "target_data", "data": { "device_id": "219123456CYP***", "channel_id": "4", "report_time": "2023-02-16T11:12:46+08:00", "data_id": "167651717084000120050000kcxdq120", "itgt_type": 22, "itgt_version": "SDC_FR V1.8.1b030s001", "quality_score": 71, "age_group": "2", "gender": "male", "glasses": "true", "hair": "short", "hat": "false", "mouth_mask": "false", "target_id": 4059**, "target_cap_feature": "oTEGAAAAAAD46f//HfP//yb9//9F+///m////wMCAAB3CwAAifj//+P5//9w/P//3gAAAMj6//97/f//w/7//135///N9P//gAUAABf8//9C+v//HwQAAN7n//8JCgAA7AQAAGD6//+TAAAA+wAAAOcAAAA7+v//uwgAAEQNAAAE9P//v/////D///8c+f//rgAAAHQKAACcBAAAWQ8AAL0KAAAfCQAAlvz//xD3//9uDQAAnQ8AAFD5//+z/v//jwgAAJMPAAAtAAAAaRIAABj4//8O7P//7AsAAGn9//+pCwAAV/j//9YTAACJ////uwkAAPQPAAC6CQAAL/n//wrq//82CgAAkRIAAFz////Z/v//Qfv//4kMAACp/v//UPb//20AAAB0CgAAmfv//7j9//+tAgAAogMAAFj+//8E+v// RAM AAFT+//8s9///EgYAAEn+//+p////aPT//5YFAAA1/v//TQAAAEIJAACsAwAAevL//yTu///58v//bwEAAAv3//8H9P//Off//3MDAADi8P//7/j//yTs//9D+f//DwMAALb6//9BAwAAxBIAAEn0//849///yf7//4P5//9VAAAAa/z//+wEAAA+AAAAmvn//4nt//8z+///Mff//2b5//8sDwAAyQgAANMKAAAA/v//CfH//7APAADVCwAAiAIAAJQOAAAGAwAAv/r//z36//+FAwAAbxIAAM4MAADE+P//Hfb//yoDAADIBAAAXvn//3sBAADLBQAAX/f//5////+E+v//PgAAAGIGAABTBgAAVP3//8oOAABM9P//bAIAALTq//+AAgAANwoAAOf4///HGAAADgsAANEBAACsBQAAFAYAAMcHAAC7AgAAb+///yYOAADG9P//Jvz//0X8///dBQAA/wIAAAcBAAA0/P//Iv///zcJAABf8f//0PX//7QCAACw9///QP3//ygHAAD6////Mfz//zP7//938///EP3//2v4//85BwAAKAMAAGH3//9cDQAAWg8AADcMAADeDwAATwUAAD0HAAC/9v//uAMAAFQMAACMBgAAGAYAAAH7//92AAAASv3//6Xw///B////S/j//8n8//989v//BOr//wMMAADq8P//nPX//0UHAABP/v//hP///9gIAADpBwAAefL//3D7//+z+v//AAMAAEz///8q+f//1gcAAK/8//8d+///lP3//3cBAABC9v//pPn///L7//+PBAAAK/n//2ACAACK/v//agsAALX9//8TEQAA/PX///L7//+8FwAA2QYAADwKAAA6BwAAUwsAAJz0//8VAAAA9gEAADD4//9QFAAAVvz//wP9//8v+///tgYAAGEFAACF9v//", "target_url": "https://www.example.com/v1/holo/tlv_219123456CYP***_4_20230216_tlv_167651717084000120010000kcxdq120.jpg/static", "panorama_url": "https://www.example.com/v1/holo/tlv_219123456CYP***_4_20230216_tlv_167651717084000120040000kcxdq120.jpg/static", "target_pos": { "x_cor": 1687, "y_cor": 2694, "width": 270, "height": 620 }, "target_pic_time": 1676517166963, "common": { "channel_id": 101, "channel_id_ex": 101, "intelligence_type": 1, "meta_type_mask": 2, "pts": 736600801653, "sdc_device_id": "30833dda-60af-9050-d0ee-7b1408902***", "sdc_uuid": "30833dda-60af-9050-d0ee-7b1408902***" }, "target": { "target_age_group": 2, "target_cap_feature": "oTEGAAAAAAD46f//HfP//yb9//9F+///m////wMCAAB3CwAAifj//+P5//9w/P//3gAAAMj6//97/f//w/7//135///N9P//gAUAABf8//9C+v//HwQAAN7n//8JCgAA7AQAAGD6//+TAAAA+wAAAOcAAAA7+v//uwgAAEQNAAAE9P//v/////D///8c+f//rgAAAHQKAACcBAAAWQ8AAL0KAAAfCQAAlvz//xD3//9uDQAAnQ8AAFD5//+z/v//jwgAAJMPAAAtAAAAaRIAABj4//8O7P//7AsAAGn9//+pCwAAV/j//9YTAACJ////uwkAAPQPAAC6CQAAL/n//wrq//82CgAAkRIAAFz////Z/v//Qfv//4kMAACp/v//UPb//20AAAB0CgAAmfv//7j9//+tAgAAogMAAFj+//8E+v//RAMAAFT+//8s9///EgYAAEn+//+p////aPT//5YFAAA1/v//TQAAAEIJAACsAwAAevL//yTu///58v//bwEAAAv3//8H9P//Off//3MDAADi8P//7/j//yTs//9D+f//DwMAALb6//9BAwAAxBIAAEn0//849///yf7//4P5//9VAAAAa/z//+wEAAA+AAAAmvn//4nt//8z+///Mff//2b5//8sDwAAyQgAANMKAAAA/v//CfH//7APAADVCwAAiAIAAJQOAAAGAwAAv/r//z36//+FAwAAbxIAAM4MAADE+P//Hfb//yoDAADIBAAAXvn//3sBAADLBQAAX/f//5////+E+v//PgAAAGIGAABTBgAAVP3//8oOAABM9P//bAIAALTq//+AAgAANwoAAOf4///HGAAADgsAANEBAACsBQAAFAYAAMcHAAC7AgAAb+///yYOAADG9P//Jvz//0X8///dBQAA/wIAAAcBAAA0/P//Iv///zcJAABf8f//0PX//7QCAACw9///QP3//ygHAAD6////Mfz//zP7//938///EP3//2v4//85BwAAKAMAAGH3//9cDQAAWg8AADcMAADeDwAATwUAAD0HAAC/9v//uAMAAFQMAACMBgAAGAYAAAH7//92AAAASv3//6Xw///B////S/j//8n8//989v//BOr//wMMAADq8P//nPX//0UHAABP/v//hP///9gIAADpBwAAefL//3D7//+z+v//AAMAAEz///8q+f//1gcAAK/8//8d+///lP3//3cBAABC9v//pPn///L7//+PBAAAK/n//2ACAACK/v//agsAALX9//8TEQAA/PX///L7//+8FwAA2QYAADwKAAA6BwAAUwsAAJz0//8VAAAA9gEAADD4//9QFAAAVvz//wP9//8v+///tgYAAGEFAACF9v//", "target_feature": { "glasses": 2, "gender": 2, "age": 0, "mouth_mask": 1, "expression": 0 }, "target_gender": "male", "target_glass": "true", "target_glass_type": 2, "target_hair": "short", "target_hat": "false", "target_id": 405***, "target_mouth_mask": "false", "target_mustache": 1, "target_panorama": "https://www.example.com/v1/holo/tlv_219123456CYP***_4_20230216_tlv_167651717084000120040000kcxdq120.jpg/static", "target_pic": "https://www.example.com/v1/holo/tlv_219123456CYP***_4_20230216_tlv_167651717084000120010000kcxdq120.jpg/static", "target_pic_position": { "x": 1687, "y": 2694, "width": 270, "height": 620 }, "target_pic_time": 1676517166963, "target_pic_tzone": 28800000, "target_quality_score": 71, "target_rec_version": "SDC_FR V1.8.1b030s001", "obj_appear_timems": 1676517166963, "pic_snapshot_dst_offset": 0, "pic_snapshot_time": 1676517166, "pic_snapshot_tzone": 28800000, "target_type": 22 } }, "test": false }

功能介绍 目标及目标整体业务：处理一些与目标识别相关的智能数据。 目标及目标整体业务消息体的message_type值为target_data。 目前行业视频管理服务会处理以下场景： itgt_type/target_type枚举值： 1 目标属性检测（摄像机SDC开启目标抓拍，对出现在区域内的人进行抓拍，获取抓拍到目标的特征信息，如：年龄人群、男性还是女性、是否戴眼镜、是否戴帽子、是否戴口罩等） 2 目标识别（摄像机SDC在开启目标属性检测的基础上，开启目标识别，对抓拍到的人与提前在摄像机设置好的白名单、黑名单目标库进行对比识别，得到识别的结果，结果包括白名单、黑名单、陌生人，当然还会有目标的特征信息） 20 NVR800人脸特征元数据（摄像机SDC开启目标属性检测的基础上，开启多机互助作为智能主机，连接多台摄像机从机，接入NVR800，主机会对主机和从机出现在区域内的人进行抓拍，获取抓拍到目标的特征值） 22 NVR800人脸特征协同元数据（摄像机SDC接入NVR800，NVR800开启目标抓拍和目标识别特征协同功能，对进入区域的人进行抓拍和获取特征信息）

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 表3 请求Body参数 参数 是否必选 参数类型 描述 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度固定为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 channel_id 是 String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 session_id 是 String 录像唯一标识：使用获取回放地址统一接口返回的PlaybackConnectionsResp中的session_id domain 是 String 域名 标识：使用获取回放地址统一接口返回的PlaybackConnectionsResp中的domain action 是 String 动作类型：枚举类型 枚举值： PLAY 播放 PAUSE 暂停 STOP 关闭 skip_time 否 String 跳转时间：格式如：yyyy-MM-dd HH:mm:ss，北京时间；不可与speed同时出现 speed 否 Float 倍速：取值范围(0.25, 0.5, 1, 2, 4, 8, 16)，云端回放支持所有倍速，前端回放倍速依赖设备能力；不可与skip_time同时出现

请求示例 回放控制 POST /v2/123456789*****/media/control/recordctl { "device_id": "210123456SMY***", "channel_id":"0", "session_id":"172588870750***", "domain": "123.123.123.123", "action":"PLAY", "speed":4 }

退订订单如何结算？ 当最终客户申请退订并经华为云确认符合退订标准时，华为云会发送退款通知给商家和最终客户。 在华为云向最终客户退款后，华为云将从当月或次月从商家结算金额里扣除退款金额后与商家结算；如金额不足，华为云将从商家缴纳的保证金（如有）扣除；如金额仍不足，商家应通过其他方式向华为云补付。 退订5天无理由产品 支持5天无理由全额退订的商品，在交易担保期内，用户可在线提交退款申请，退款成功的订单，在结算账单中会同时出账原始订单和退订订单。合计结算金额为0。 尚未生效的续费订单，退款成功后在结算账单中会同时出账原始订单和退订订单，合计结算金额为0。 示例：用户在2024年1月5号购买了商家的saas包周期商品，每月100元，购买时长12个月，订单金额1200元，但1月7号就退订完成。 如商家的账单中只有这个原始订单和退订订单，商家的实际出账为： 2月7号生成1月账单：账单结算金额（含税）=1200元-1200元=0元 退订包周期产品 包周期的商品过了担保期申请退款，按实际使用天数扣除费用，剩余天数退余款。 示例：用户在2024年3月5号开通了包月的镜像，每月100元，购买时长12个月，订单金额1200元，但因特殊情况用户在5月5号申请退款成功。 实际出账为： 4月3号生成3月账单：原始订单结算金额（含税）=1200元 6月3号生成5月账单：退订订单结算金额（含税）=-1000元 即华为云在5月对商家付款1200元后，在7月将从该商家未结算金额或保证金里扣除1000元，或商家通过其他方式向华为云退回1000元。

不支持全额退订说明 如用户存在下列任何一种情况的不支持全额退订说明： 服务过程中，用户超出1个月未向商家提供项目所需资料，导致项目无法继续实施被动停止的情况。 服务过程中，用户新增加需求，并超出商家接单时承诺的服务范围的情况。 服务过程中，用户超出3个月未对商家的服务成果进行“反馈或确认”的情况，或者因客户未及时反馈、确认导致服务项目已经过期的情况。 因用户自身问题违反国家相关法律规定导致商家无法兑现服务承诺（包括但不限于用户未获得网站ICP备案许可导致网站无法上线等情况）。

通用退订指引 华为云云商店各类型商品退订规则不同，具体请参见下方表1。 如商品涉及服务监管，在服务监管完成前即为交易担保期，交易担保期内商品支持协商退订。用户可在“云商店买家中心-退订管理”中发起退订，输入退款金额和原因后需由对应商家审批后方可完成退订。 如商品不涉及服务监管，根据商品类型分为5天无理由全额退订和不支持退订。如商品支持5天无理由全额退订，用户可在“费用中心-订单管理-退订与退换货-云服务退订”中发起退订，无需商家审核。 支持5天无理由全额退订的商品，每个账号每自然年周期内（从1月1日算起）可享有10次自助退订机会，若超过10次则用户无法发起自助退订。注：华为云官网其他云服务产品（如ecs等）退订也会占用此退订次数。 云商店不支持用户在交易担保期外提出的全额退订要求。 如果用户已经开具云商店发票，必须退票后才能退订，云商店商品不支持欠票。 如果是电子发票：无需邮寄材料。 如果是纸质普票：邮寄发票联原件。 如果是纸质专票（未抵扣）：邮寄发票联和抵扣联原件。 如果是纸质专票（已抵扣）：提供《开具红字增值税专用发票信息表》扫描件，无需邮寄材料。 参与活动购买的云商店商品，若通用退订规则与活动规则冲突，则以活动规则为准。活动中说明“不支持退订”的商品不支持退订。 涉及服务监管的线上交付License类商品，用户领取授权码后不支持协商退订。 涉及里程碑验收（分阶段验收）的订单，若服务监管未完成，用户可按与商家协商的金额申请协商退订，上限为未完成状态的里程碑涉及金额，需商家审批。里程碑交付完成后，不能退订已完成状态的里程碑金额。 订购“数据资产-数据文件”商品前，用户应仔细阅读商品说明信息以及商品服务协议中的使用约束限制条件，并与使用实际场景进行匹配，非数据商品本身质量问题导致的不可用或产生任何问题不支持退订。 退订金额返回方式：按照原支付方式，等比例退还实付金额（实付金额不包含代金券金额）到客户的华为云账户；代金券：2020年发放云商店代金券，支持5天无理由自助退订时退还云商店代金券，退订未生效的资源退返代金券，其他退订场景不退还代金券。退订时若代金券已过期，则退回的代金券无法再次使用。 退款资金流向：退订成功后，退订金额会返还到华为云账户，具体请参见退款资金流向。

退订规则说明 表1 云商店商品详细退订规则 商品类型 计费模式 是否涉及服务监管 退订规则 备注 SaaS 包周期 是 交易担保期内可协商退订 支持退订的场景 资源开通失败的订单自动全额退订。 交易担保期内未生效的续费订单支持全额退订，全额退还实付金额。 不支持退订的场景 超过有效期的订单不支持退订。 已生效的续费订单不支持退订。 试用订单不支持退订。 服务监管已完成的订单不支持退订。 否 支持5天无理由全额退订 一次性 是 交易担保期内可协商退订 否 不支持退订 按需/按需套餐包 否 不支持退订 License 包周期 是 交易担保期内可协商退订 支持退订的场景 交易担保期内可按与商家协商的金额退订，上限为实付金额，待商家审批通过后生效。 交易担保期内未生效的续费订单支持全额退订，全额退还实付金额。 不支持退订的场景 超过交易担保期（服务监管已完成）的订单不支持退订。 超过有效期的订单不支持退订。 已生效的续费订单不支持退订。 一次性 是 交易担保期内可协商退订 人工服务 包周期 是 交易担保期内可协商退订 一次性 是 交易担保期内可协商退订 硬件 包周期 是 交易担保期内可协商退订 一次性 是 交易担保期内可协商退订 镜像 包周期 否 支持5天无理由全额退订 支持非5天无理由部分退订 支持退订的场景 1、仅允许同E CS 一起退订： 2、交易担保期（5天）内无理由全额退订，全额退还实付金额。 3、超过10次的5天无理由退订或新购超过5天的资源退订，需扣除已消费金额，不扣除手续费，不退还代金券。 4、未生效的续费包周期订单支持全额退订。 不支持退订的场景 超过交易担保期（服务监管已完成）的订单不支持退订。 按需资源不支持退订。 按需 否 不支持退订 API 一次性（按次套餐包） 否 不支持退订 无 按需/按需套餐包 否 不支持退订 无 AI资产 包周期 否 不支持退订 无 一次性 否 不支持退订 无 容器 包周期 否 不支持退订 无 数据资产 一次性 是 交易担保期内可协商退订 不支持退订的场景 非数据商品本身质量问题导致的不可用或产生任何问题不支持退订。 一次性 否 不支持退订 无

上架流程 成为云商店商家，详见《入驻流程概览》； 发布License类联营商品，具体操作请参见《发布License类联营商品》； 云商店进行商品审核，商家可同步完成联营Kit对接、自动化部署对接、海顿测试，具体操作请参见《联营Kit对接、自动化部署对接、海顿测试》； 如商品审核通过后，商家已完成联营Kit对接、自动化部署对接和海顿测试，进入第6步；如商品审核通过后，商家未完成联营Kit对接、自动化部署对接和海顿测试，则进入第5步； 商家补充材料，进入下一步； 云商店运营经理完成集成与测试审核； 商品上架成功。