云服务器内容精选

  • 请求示例 获取实况地址请求: POST /v2/123456789*****/devices/channels/media/live-connections { "expire_time":30, "use_times":0, "channels": [ { "channel_id": "0", "device_id": "219123456CYP***", "live_protocol":"HOLO", "stream_type": "SECONDARY_STREAM_1" }, { "channel_id": "1", "device_id": "219123456CYP***", "live_protocol":"HOLO", "stream_type": "PRIMARY_STREAM" } ] }
  • 响应示例 状态码: 200 OK { "fail_num": 1, "live_connections": [ { "device_id": "219123456CYP***", "channel_id": "0", "cloud_trans_connections": {}, "p2p_connections": {}, "result": { "code": "IVM.10026004", "msg": "The param stream_type is not support." } }, { "device_id": "210123456SMY***", "channel_id": "0", "cloud_trans_connections": { "live_url": "jvmp://123.123.123.123:7070/live/210123456SMY***?token=content***" }, "p2p_connections": { "token": "content***", "device_state": "ONLINE", "p2p_nodes": [ { "node_type": "COMMON", "address_type": "IPV4", "address": [ "123.123.123.123" ], "tcp_port": 0, "udp_port": 7050 } ] }, "result": { "code": "IVM.0", "msg": "Success" } } ] }
  • 响应参数 状态码: 200 表5 响应Body参数:播放P2P实况需要将响应Body参数中的所有内容输入到播放地址栏 参数 参数类型 描述 fail_num Integer 获取设备url失败的数量 live_connections Array of LiveConnectionResp objects 实况响应信息 表6 LiveConnectionResp 参数 参数类型 描述 device_id String 设备ID:设备唯一标识,长度范围[1,32] channel_id String 通道ID:长度范围[1,20] cloud_trans_connections CloudTransChannelsResp object 转发实况连接结构体 p2p_connections P2PChannelsResp object P2P实况连接结构体:仅支持HOLO媒体播放协议且请求设备为好望设备 result Result object 错误信息 表7 CloudTransChannelsResp 参数 参数类型 描述 live_url String 转发实况播放地址:将此url输入播放地址栏开始播放 表8 P2PChannelsResp 参数 参数类型 描述 token String P2P请求Token device_state String 在线状态:枚举类型 枚举值: OFFLINE 离线 ONLINE 在线 p2p_nodes Array of P2PMTSListResp objects P2P连接可用节点 表9 P2PMTSListResp 参数 参数类型 描述 node_type String 节点类型:枚举类型 枚举值: COMMON 普通:普通的三线(移动,联通,电线)服务器,与地域有关,服务器由运营商托管,网络通信质量低 BETTER 优质:全网通服务器(华为云服务器等),网络通信质量高 address_type String 地址类型:枚举类型 DOMAIN 域地址 IPV4 IPv4地址 IPV6 IPv6地址 address Array of strings 媒体转发服务地址: 协议头在SDK封装 ,根据address_type决定地址类型 DOMAIN: www.huawei.com IPV4: 123.123.123.123 IPV6: fe80::f816:3eff:feed:5821 tcp_port Integer TCP端口:默认值为 0 备注:未使用0端口,tcp_port只作为兼容字段保留 udp_port Integer UDP端口:默认值为 7050 表10 Result 参数 参数类型 描述 code String 错误编码:请参见错误码 msg String 错误信息
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken:从获取用户北向接口认证AccessToken中获取 表3 请求Body参数 参数 是否必选 参数类型 描述 channels 是 Array of ChannelsLiveParamV2 objects 请求信息V2 expire_time 否 Integer 自定义Url过期时间:时间范围[30, 86400],不传默认为 30(单位/秒) 备注:仅对CloudTransChannelsResp中的live_url有效;HTTP_HLS和HTTPS_HLS每次使用会刷新过期时间,每次刷新60秒 use_times 否 Integer 自定义Url使用次数:枚举类型,不填写时默认值为 0,RTSP协议固定为 0 备注:仅对CloudTransChannelsResp中的live_url有效 枚举值: 0 使用一次 1 有效时间内任意使用,此参数对RTSP协议无效 表4 ChannelsLiveParamV2 参数 是否必选 参数类型 描述 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 好望协议 HTTP_HLS 基于HTTP的HLS流媒体传输协议(该协议存在安全风险,建议优先使用其他协议) HTTPS_HLS 基于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
  • Q:告警消息推送APP端的配置以及消息推送常见问题的排查 A:排查步骤: 告警功能分app在线告警和app离线告警(Android和iOS均支持在线告警,Android上支持HMS(华为推送服务)的设备才能收到离线告警,iOS手机均支持离线告警)。 离线告警功能目前还不完善,有支持推送服务的系统才能离线告警,一般大厂手机支持,后续会陆续集成进来,比如小米、OPPO等厂商手机。 告警功能说明: 在线告警:指华为好望APP正在系统中运行,APP在前台(正在使用)或者在后台但还没被系统杀死,这个时候,APP能接收到行业视频管理服务(原 好望云服务 )推送的告警,并进行提示。 离线告警:指华为好望APP没有在系统中运行,这个时候,APP无法感知行业视频管理服务(原好望云服务)的所有推送(因为没有建立连接通道),只能依靠操作系统自身的推送服务来实现告警通知,比如iOS和华为的推送服务。 可配置选项: 告警消息提醒 声音 震动 消息提醒间隔: 默认20秒时间间隔,iOS或部分系统可能会对消息提醒优化,有一些时间偏差。 父主题: 【个人版】
  • Q:设备扫码无法接入? A:排查步骤: 登录设备,查看设备是否显示在线。 若设备不在线,请准备一台PC设备接入交换机中,设置IP地址于同一网段,然后,ping一下行业视频管理服务(原好望云服务) 域名 (device.holosens.huawei.com)。 若ping域名未成功,请检查网络连接是否有问题。 若ping域名成功可检查设备系统时间是否正确,设备证书等配置是否变更过,如有异常修复异常后重新接入即可。 若未排查出异常可提供设备日志找设备维护人员分析,提供设备ID找行业视频管理服务(原好望云服务)运维工程师分析。 父主题: 【个人版】
  • Q:实况/录像播放一直在缓冲中是什么原因? A:最常见问题为设备侧设置为主码流,APP当前默认为子码流。 ( 好望设备请流会带码流参数,默认请求标清,设备侧如果只打开主码流,APP上实况就会一直在缓冲中,无法实况,国标设备APP不支持切换码流,标清还是高清由设备侧设置决定,APP页面显示的都是标清。) 后面的摄像机版本会改成如果收到标清流请求,如果未打开就会自动去打开,解决这个问题,当前需要修改摄像机视频流配置中,“码流类别”中将“主码流”修改为“主码流,子码流1”(如下图所示),修改保存后重新连接实况。 另外实况无法出图还有许多其他原因,如果在缓冲中失败的,多为设备推流异常导致,需要拿到设备侧日志交给技术人员分析。 父主题: 【个人版】
  • Q:SDC硬件支持目标、周界,APP上为什么无法配置使用? A:当前SDC版本不支持。 SDC8.1.1支持过线、热度图、人群密度、排队长队配置。暂不支持目标、周界和告警布防,设备侧在8.2.0版本才做的上报手机APP。 版本节奏: 8.2.0版本支持:越线检测、入侵检测、徘徊检测、区域进入检测、区域离开检测、快速移动检测、过线计数、排队长度、人群密度、口罩告警、目标识别、快速移动、移动侦测、三方算法。 9.0.0版本新增:电瓶车、离岗检测、遗留物品、移走物品。 父主题: 【个人版】
  • Q:同一设备通道实况可以支撑多少人同时在线观看? A:行业视频管理服务(原好望云服务)未做限制,如最多支持分享了100个用户,那么100个用户也可以同时观看,前提是云端资源未消耗完;有一定连接数为P2P连接,不占云端带宽,超过一定连接数之后实况通过行业视频管理服务(原好望云服务)转发消耗行业视频管理服务(原好望云服务)带宽。 P2P支持路数说明: SDC建立总连接数与SDC型号相关,最少的款型只支持四路视频流连接,假设该SDC支持4路视频流,一路连接到NVR,一路连接到监控屏,那么P2P连接到APP就只支持2路,再多的连接就通过行业视频管理服务(原好望云服务)转发。 NVR与APP P2P 支持的路数限制为通道数*2,超过的走行业视频管理服务(原好望云服务)转发。 父主题: 【个人版】
  • Q:国标设备添加以后一直显示“未注册”状态是怎么回事,是由哪些原因导致的? A: “未注册”状态是国标设备未接入到行业视频管理服务(原好望云服务)。 处理步骤: 检查设备所在的网络是否能访问sip服务网关。 检查设备portal页面配置是否按照接入指导正确配置。 断网重启下设备,接入网络后重新按照指导进行正确配置。 如果还有问题可以从以下几个地方进行修改排查。 确认关闭了媒体流保护活开关:因为设备支持但是目前行业视频管理服务(原好望云服务)还不支持。 确认关闭了H.265协议:因为目前只支持H.264协议。 修改心跳到20:默认60,可能导致心跳过长一直离线。 如果是M系列设备,如下图,首先确认配置参数是否正确;端口号是否有勾选,如有取消勾选。 父主题: 【企业版】
  • 高危操作清单 表1 高危操作一览表 危险操作 操作影响 关闭服务 关闭服务后会立即清理该通道下正在使用或者已经存储的相关数据资源,详细说明如下: 管理服务:该通道所有媒体相关服务,如实况播放,录像回放等。 收录服务:停止该通道云端录像计划,删除已存储的云端录像文件。 行业数据流服务:停止该通道行业数据流数据存储及转发能力,删除已存储的行业数据流数据。 删除设备 删除设备后,会自动关闭该设备下所有通道开通的服务,同时将该设备从设备列表(含持有人及被分享人)中删除。 解散企业 解散企业后会将该企业下所有设备进行删除。 用户注销 用户注销后,会将该用户下所有用户数据进行清除,包含个人信息,个人所拥有设备信息,个人与企业权限关系等。 若用户属于某企业,用户注销只会删除用户与企业的权限关系,不影响企业下设备的正常使用。 解绑设备 用户可以选择登录设备页面后进行设备与云服务解绑。 解绑后,该设备在云服务开通的服务会关闭,用户绑定关系会进行删除,该设备可以重新进行添加绑定。 删除aksk 企业开发者删除aksk后,原有企业凭证申请的所有AccessToken均会失效。 申请AccessToken 单个aksk只维护最新两个AccessToken的有效性,申请新的AccessToken会自动覆盖较早AccessToken有效性。 父主题: 参考
  • 图像显示 表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 告警配置功能清单 功能 说明 联动策略总开关 - 支持配置“告警联动策略”启用开关,控制所有事件的“告警联动策略”。 当总开关未开启时,单个告警配置开启时也不会生效。 设置对应的告警联动策略前,必须开启对应的开关。 普通告警 布防计划 配置告警上报计划,相关告警仅在计划时间内生效并上报。 支持自定义计划,支持画框、复制、删除、撤销、恢复、清空等操作。 支持四种通用计划:全天候、工作日、周末、工作时间。 告警联动 配置告警上报的时间间隔与方式。 支持配置告警间隔:针对事件类告警,系统按配置的告警间隔对业务上报的告警进行时间过滤,确保连续上报的告警发生时间不小于告警间隔。 支持配置告警联动策略:仅告警策略的联动状态为“生效”时,告警才会通过该策略上报。