华为云用户手册

运行时配置参数 技能在运行时，需要添加运行时配置。配置完成后，参数会从华为HiLens云侧下发到端侧设备。 配置参数说明 技能相关配置参数设计如表3所示。 表3 运行时配置参数 名称 是否必选 参数类型 说明 logLevel 是 Enum 日志级别，包括INFO，DEBUG，WARNING和ERROR。建议设置为INFO。 keep_running 是 Int 当技能崩溃是否自动拉起技能并持续运行。此项配置在1.1.0及以后版本起作用。 multi_camera 是 List 一个设备上多路视频的技能参数，详情请参见表4。 表4 视频参数说明 名称 是否必选 参数类型 说明 camera_names 是 List 摄像头名称。可配置多个名称，表示多个摄像头采用同样的技能配置。 sendOriImgFlag 否 Int 是否发送人脸背景原始图,默认值：0。 0：表示不发送 1：表示发送 sendOriImgCompressionRatio 否 Int 原始图jpeg压缩百分比，默认值为90,表示图片压缩比90%，取值范围[1 100]。 cropSizeMax 否 Int 发送人脸图片长宽的最大像素，默认值400。 cropSizeMin 否 Int 发送人脸图片长宽的最小像素，默认值80。 faceQualityThreshold 否 Float 人脸质量总分阈值，质量分大于此值的人脸才会抓拍，默认值0.25。 facePoseThreshold 否 Float 人脸姿态分阈值，质量分小于此值的人脸才会抓拍，默认值0.45。 faceBlurThreshold 否 Float 人脸模糊度阈值，质量分小于此值的人脸才会抓拍，默认值0.55。 faceMargin 是 Float 上报人脸时人脸框的外扩比例，默认值2.0。 passLineThreshold 否 Float 进店统计时判断过线的Y轴坐标比值，默认为0.9。例如分辨率为1920x1080，比值0.75即1080*0.75=810。 sendUrl 是 String 发送技能消息POST请求的URL地址。 示例 HiLens Kit设备支持多路摄像头接入，如果要为不同的摄像头设置不同的技能配置，或者几个摄像头共用同一技能配置，则可在配置列表中给出相应的配置信息，示例如下： //Store001的两个摄像头pos1和pos2配置不同参数： { "logLevel": "INFO", "keep_running": 1, "multi_camera": [{ "camera_names": ["store001_pos1"], "sendOriImgFlag": 0, "sendOriImgCompressionRatio": 90, "cropSizeMax": 400, "cropSizeMin": 100, "faceQualityThreshold": 0.25, "facePoseThreshold": 0.45, "faceBlurThreshold": 0.55, "faceMargin": 2.0, "passLineThreshold": 0.9, "sendUrl": "https://abc.company.com/face", }, { "camera_names": ["store001_pos2"], "sendOriImgFlag": 1, "sendOriImgCompressionRatio": 100, "cropSizeMax": 300, "cropSizeMin": 80, "faceQualityThreshold": 0.25, "facePoseThreshold": 0.45, "faceBlurThreshold": 0.55, "faceMargin": 2.0, "passLineThreshold": 0.9, "sendUrl": "https://abc.company.com/face", }] } //Store002的两个摄像头pos1和pos2配置相同参数： { "logLevel": "INFO", "keep_running": 1, "multi_camera": [{ "camera_names": ["store002_pos1","store002_pos2"], "sendOriImgFlag": 0, "sendOriImgCompressionRatio": 90, "cropSizeMax": 400, "cropSizeMin": 120, "faceQualityThreshold": 0.25, "facePoseThreshold": 0.45, "faceBlurThreshold": 0.55, "faceMargin": 2.0, "passLineThreshold": 0.9, "sendUrl": "https://abc.company.com/face", }] }

技能描述 智慧门店的人脸抓拍和客流统计技能。本技能使用多个深度学习算法，实时分析视频流，对进入门店的人形进行抓拍，并自动筛选出此人进店过程中尺寸、清晰度、角度最佳的人脸和对应的原图上传至您的后台系统。 结合云上 人脸识别服务 （Face Recognition，简称FRS）还可以进一步做VIP客户统计、回头客统计等应用。使用时需要提供您的业务RESTful接口和RTSP视频地址，当前最大支持两路网络摄像头接入。 人流较密集、互相遮挡或者全程看不清顾客的脸时，可能存在抓取到的人形找不到对应人脸的情况。 摄像头部署建议请参见摄像头部署。 技能配置项请参见运行时配置参数。 技能接口设计请参见技能结果上传接口。

激活方式 30天免费试用激活 超过1台的设备，每种设备类型每台可享受一次30天免费试用。操作步骤请见30天免费试用激活。 订单号激活 激活需购买HiLens端边云协同平台服务，在订单有效期内激活。激活时长与订单购买时长一致。激活前，请仔细阅读订单激活说明。 自购：使用自己账号的订单激活设备，操作步骤请见自购订单号激活。 他购：使用他人账号下的订单激活自己账号下的设备，首先需要使用他人账号进行激活权限转移，然后使用自己账号激活设备，操作步骤请见他人订单号激活。 测试样机激活 非华为云官网购买的测试样机，可选择SN码激活。仅HiLens Kit支持该方式。操作步骤请见测试样机激活。

订单激活说明 首次激活，需要在购买HiLens端边云协同平台服务订单到期时间之前，否则过期失效。 对于老设备，保留其激活状态。但若注销后再注册，则需重新激活。 首次激活后，可在包周期时长内使用服务，第2次、第3次...激活设备，激活到期时间一样。即无论激活多少次，自行开发的技能安装权限使用期限仅从首次激活时间开始计算，直到包周期时间结束。 必须在订单到期前进行激活，否则订单到期后会激活失败。 使用自行开发的技能安装权限到期后，需要重新购买HiLens端边云协同平台服务，重新激活设备。

使用SSH查看日志 SSH连接到HiLens Kit设备，详细操作指导请参见连接PC和HiLens Kit。 根据固件版本号，执行查看日志命令： 固件版本1.0.4前（不包含固件版本1.0.4）： 查看设备agent日志 tail -f /home/hilens/hda/log/hdad.log 查看技能日志 tail -f /home/hilens/hda/log/开发者.技能名.技能ID.log 固件版本1.0.4至1.1.1： 查看设备agent日志 tail -f /home/log/alog/hilens/hda/hdad.log 查看技能日志 tail -f /home/log/alog/hilens/hda/开发者.技能名.技能ID.log 固件版本1.1.2及以后： 查看设备agent日志 tail -f /home/log/alog/hilens/hda/hdad.log 查看技能日志 tail -f /home/log/alog/hilens/skills/开发者.技能名.技能ID/开发者.技能名.技能ID.log 为保证您的设备可以运行更新更好的技能，建议及时升级固件版本。升级固件版本请参见升级HiLens_Device_Agent固件版本。

使用场景 当您注册的设备超过1台时，在该设备上安装您自行开发的基础技能类型技能，包括在控制台开发的技能、使用可训练技能模板开发的技能，需要购买HiLens端边云协同平台服务，在设备管理页面对指定设备进行权限激活。 安装来自技能市场的技能，其安装权限不受限制，无需购买HiLens端边云协同平台服务，也无需激活权限。 首台注册的设备，其技能安装权限不受限制，无需购买HiLens端边云协同平台服务，也无需激活权限。

运行时配置参数 技能在运行时，需要添加运行时配置。配置完成后，参数会从华为HiLens云侧下发到端侧设备。 配置参数说明 技能相关配置参数说明如表3所示。 表3 运行时配置参数说明 名称 是否必选 参数类型 说明 logLevel 是 String 日志级别，默认为“INFO”；如果设置较低级别，如“DEBUG”，可在日志中打印更多信息。 keep_running 是 Int 当技能崩溃是否强制自动拉起技能并持续运行，HiLens Framework 1.1.0版本以上才会生效，升级操作请见升级HiLens_Device_Agent固件版本。 multi_camera 是 List 一个设备上多路视频的技能参数，详情请参见表4。 表4 视频参数说明 名称 是否必选 参数类型 说明 camera_names 是 List 运行技能的IP摄像头名称，需要事先在摄像头管理中配置。可配置多个名称，表示多个摄像头采用同样的技能配置。 sendCarImgFlag 否 Int 是否发送检测到的汽车图，默认值为“0”。 “0”：表示不发送 “1”：表示发送 roi 否 String 检测区域配置。区域的设置由“Polygon”开头，其后依次为区域的坐标(按顺时针排列的x，y坐标)。默认值为“Polygon 0 0 0 0”，表示检测整个画面。 sendUrl 是 String 发送技能消息POST请求的URL地址。 示例 HiLens Kit设备支持多路摄像头接入，如果要为不同的摄像头设置不同的技能配置，或者几个摄像头共用同一技能配置，则可在配置列表中给出相应的配置信息，示例如下： //Store001的两个摄像头pos1和pos2配置不同参数： { "logLevel": "INFO", "keep_running": 1, "multi_camera": [{ "camera_names": ["store001_pos1"], "sendCarImgFlag": 0, "roi": "Polygon 0 0 0 0", "sendUrl": "https://abc.company.com/car" }, { "camera_names": ["store001_pos2"], "sendCarImgFlag": 1, "roi": "Polygon 0 0 0 0", "sendUrl": "https://abc.company.com/car" }] } //Store002的两个摄像头pos1和pos2配置相同参数： { "logLevel": "INFO", "keep_running": 1, "multi_camera": [{ "camera_names": ["store002_pos1","store002_pos2"], "sendCarImgFlag": 0, "roi": "Polygon 0 0 0 0", "sendUrl": "https://abc.company.com/car" }] }

摄像头部署 摄像头的架设会影响车型车标模型的准确率。在实际架设中，尽量保证拍摄画面清晰，光照充足，汽车角度较正，无遮挡，比如前边的车容易挡住后边的车。 摄像头参数基本设置 不同品牌的摄像头都有一些基本的视频设置，例如分辨率、帧率和码率等，参数要求如表2所示。 表2 摄像头参数设置要求 参数 要求 分辨率 不低于720P，不高于4K（3840*2160），建议1080P。 帧率 不高于25fps，不低于15fps，建议值20fps。 码率 720P建议设为4096Kbps~6144Kbps左右，1080P建议设为6144Kpbs~8192Kbps，更高分辨率可设置更高码率。 视频编码 如果支持H.265，设置为H.265。 日夜切换 关闭夜间自动切换红外模式。 宽动态 关闭宽动态。普通摄像头的宽动态无法到达专业相机的效果，运动速度较快时存在运动模糊，应关闭宽动态设置。 摄像头架设要求 镜头前方不要有遮挡的障碍物，容易挡住汽车，造成漏检。 不要将摄像头架在房子遮阴的挡板下，会造成光照过暗。 室外安装摄像头，需要注意雨雪的影响，避免在露天下布置，雨水或者雪将摄像头的镜头盖住，造成拍摄画面模糊不清。 摄像头俯视角度尽量保持在15°左右。

升级风险 升级前请仔细阅读以下风险，谨慎升级。 HiLens Kit处于注册使用状态时，升级HiLens Kit系统固件版本前，请先联系接口人评估升级操作对业务连续性的风险。 升级HiLens Kit系统固件版本会重装整个系统目录，将导致系统目录下安装的软件会丢失。可采用如下方法确定系统目录的位置，用df -h命令可查看当前分区信息，“/dev/mmcblk0p2”对应根目录即是系统目录。此目录为软件默认安装目录，升级时该目录下安装的软件会丢失。其他非系统目录中的文件在升级过程中不受影响，如：“/dev/mmcblk0p*”对应的目录。 攻略：为了后面系统升级不受系统目录的影响，对于支持重定向安装的软件包，可以通过重定向安装到HiLens Kit设备系统“/opt”目录，规避以后系统升级，文件丢失问题。例如yum重定向安装软件包“XXX”，执行命令yum --installroot=/opt install xxx。对于不支持重定向安装的软件包，如yum安装、ROS安装涉及的rpm包，只能部署在系统目录，升级后会丢失。 升级HiLens Kit系统固件版本后可能会导致部分原有技能无法运行，请谨慎升级。

升级优势 支持智能边缘系统注册设备，注册流程请参见智能边缘系统注册设备。 支持端侧通过admin登录最长1个小时不掉线。 升级后，在admin用户模式下，通过命令timeout设置超时时间，最长1小时，例如设置超时时间为1小时，则执行命令timeout 3600。 首次登录智能边缘系统必须修改默认用户名、密码，防止使用默认用户名、密码带来的安全问题。 增加硬件设备和资源监测，当硬件异常或资源使用超过告警线，会上报告警提示您。 对第三方组件进行相关的安全升级。

后续操作 如果升级前HiLens_Device_Agent固件版本高于1.0.7，升级HiLens Kit系统固件版本后升级一次HiLens_Device_Agent固件，详细操作请参考升级HiLens_Device_Agent固件版本（如果HiLens_Device_Agent固件已经是最新版本，需要重新升级一次最新版本的HiLens_Device_Agent固件）。 升级HiLens Kit系统固件版本和HiLens_Device_Agent固件版本后，注册设备需要同步时区和时间，详情请参见同步时区和时间。

技能结果上传接口 请求消息 推理结果将以HTTPS POST请求方法推送到应用系统server的指定URL地址。 POST {sendUrl} 其中sendUrl在技能运行时配置中设置。 请求消息头 技能以json形式返回推理结果，因此消息头“Content-Type”类型为“application/json”。消息头其它部分，用户可根据自身的业务需求设定，如鉴权等。 表4 请求消息头参数说明 名称 描述 是否必选 示例 Content-Type 消息体的类型（格式） 是 application/json 公共消息体 HiLens公共消息体包含了技能的公共消息内容，如表5所示。 表5 公共消息体参数说明 名称 类型 说明 msg_type Enum 消息类型，包括“no_helmet_alert”和“heatbeat”两种。 skill_id String 技能ID。 技能心跳消息体 技能心跳的json消息体包含一个时间戳信息： 表6 技能心跳消息体参数说明 名称 类型 说明 time Uint64 心跳时间戳。 公共消息体示例 { "msg_type": "heartbeat", "skill_id": "f5c526eb6c51440c8a0ee5e3cc65f23c", "time": 1527603463 } 技能消息体 安全帽检测的json消息体如表7所示： 表7 技能消息体参数说明 名称 类型 说明 camera_name String 摄像头名称。 image_id String 摄像头原始图UUID。 time Uint64 检测到未戴安全帽人头时的时间戳。 bounding_box Array 未戴安全帽人头在背景图中的位置信息，其参数说明如表8所示。 image String 原始图BASE64编码结果，如果配置不发送原始图，则为空字符串。 表8 “bounding_box”参数说明 字段 类型 说明 x Int 人头图左上角顶点x坐标值。 y Int 人头图左上角顶点y坐标值。 h Int 人头图高。 w Int 人头图宽。 安全帽检测的消息体示例： { "msg_type": "no_helmet_alert", "camera_name": "constructsite01_pos02", "skill_id": "f5c526eb6c51440c8a0ee5e3cc65f23c", "image_id": "0DD1BF0A-634B-11E8-8B0B-407D0FAD9218", "time": 1527603463, "bounding_box ": [{ "x": 32, "y": 379, "w": 49, "h": 65 }, { "x": 54, "y": 632, "w": 36, "h": 95 } ], "image": "4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQE...", } 响应消息 响应消息头 响应消息头由服务器端(应用系统)收到请求消息后返回。 响应消息头可包含如下两部分。 一个HTTP状态代码，从2xx成功代码到4xx或5xx错误代码。或者可以返回服务定义的状态码。 附加响应头字段，如支持请求的响应所需，如Content-type响应消息头。 详细的公共响应消息头字段如表9所示。 表9 公共响应消息头参数说明 名称 描述 示例 Date HTTP协议标准报头。表示消息发送的时间，时间的描述格式由rfc822定义。 Mon, 12 Nov 2007 15:55:01 GMT Server HTTP协议标准报头。包含了服务器用来处理请求的软件信息。 Apache Content-Length HTTP协议标准报头。用于指明实体正文的长度，以字节方式存储的十进制数字来表示。 xxx Content-Type HTTP协议标准报头。用于指明发送给接收者的实体正文的媒体类型。 application/json 响应消息体 响应消息体通常以结构化格式（如JSON或XML）返回，与响应消息头中“Content-type”对应，传递除响应消息头之外的内容。

摄像头部署 摄像头的架设会影响安全帽检测模型的准确率。在实际架设中，尽量保证拍摄画面清晰，光照充足，人形较正，无遮挡。监控视频场景下尽量保证拍摄的画面能拍到更多的人形。 目前安全帽检测模型的训练场景主要针对工地入口。具体为摄像头距离地面三到四米左右，在安全帽检测的区域，人形不会有太严重的遮挡。为了保证检测算法的准确率，需要确保画面图像中安全帽清晰可辩。同时，摄像头画面中场景尽量干净简单、空旷，避免场景复杂造成误检。 摄像头参数基本设置 不同品牌的摄像头都有一些基本的视频设置，例如分辨率、帧率和码率等。 分辨率：建议1080P，不低于720P且不高于1080P。 帧率：不高于25fps，不低于15fps，建议值20fps。 码率：720P建议设为4096Kbps~6144Kbps左右，1080P建议设为6144Kpbs~8192Kbps。 视频编码：如果支持H.265，设置为H.265。 日夜切换：关闭夜间自动切换红外模式。 宽动态：关闭宽动态。普通摄像头的宽动态无法到达专业相机的效果，人的走动速度较快时存在运动模糊，应关闭宽动态设置。 摄像头拍摄方向 摄像头拍摄方向要正向行人正反面，略成俯视角度。保证行人上半身轮廓清晰可见。 架设高度：4m左右 监控距离：2-10m 监控宽度：2-5m 俯视角度：左右偏角小于8°；俯仰角10°-20° 光照要求 光照条件要求需要满足以下几项： 行人区域正面光照强度100lux及以上，防止出现过暗或者噪点。 行人左右侧光照强度差不超过一倍，防止产生阴阳脸。 如果现场的光线不满足上述要求，则需要通过强光抑制或补光来优化现场的光照条件。强光抑制可以改善“背光”现象，即通过减弱侧面光照来改善光照条件。补光则可以通过增加额外光源的方式改善光照条件，提高图像的采集效果。 周围环境要求 镜头前方不要有遮挡的障碍物，避免漏检。 不要将摄像头架在房子遮阴的挡板下，会造成光照过暗，人形和安全帽模糊。

运行时配置参数 技能在运行时，需要添加运行时配置。配置完成后，参数会从华为HiLens云侧下发到端侧设备。 配置参数说明 技能相关配置参数说明如表2所示。 表2 运行时配置参数说明 名称 是否必选 参数类型 说明 heartbeat_interval 是 Int 技能心跳消息发送间隔。单位为秒，0表示不发送。技能心跳消息判断技能是否离线。 post_url 是 String 技能消息POST请求的URL地址。心跳和技能的输出发送到指定的URL。 multi_camera 是 Array 一个设备上多路视频的技能参数，其技能参数说明请见表3。 表3 “multi_camera”参数说明 名称 是否必选 参数类型 说明 camera_names 是 Array 摄像头名称。摄像头名称与设备的rtsp流配置的名称对应。可配置多个名称，表示多个摄像头采用同样的配置。 send_image 是 Int 是否发送原始图,默认值为0。 0：表示不发送 1：表示发送 image_compression_ratio 是 Int “jpeg”格式原始图压缩百分比，默认值为90,表示图片压缩比90%，取值范围[1,100]。 use_tracking 是 Int 是否启用跟踪去重。 0：表示不启用 1：表示启用 draw_rectangle 否 Int 是否对技能显示出的不戴安全帽行人画框，默认值为0，即默认不画框。 0：表示不画框 1：表示画框 roi 否 String 检测区域配置。区域的设置由“Polygon”开头，其后依次为区域的坐标（按顺时针排列的x，y坐标）。默认值为“Polygon 0 0 0 0”，表示检测整个画面。 示例 HiLens Kit设备支持多路摄像头接入，如果要为不同的摄像头设置不同的技能配置，或者几个摄像头共用同一技能配置，则可在配置列表中给出相应的配置信息，示例如下： //constructionsite01的两个摄像头pos1和pos2配置不同参数： { "heartbeat_interval": 30, "post_url": "https://abc.company.com/webhook", "multi_camera": [{ "camera_names": ["constructionsite01_pos01"], "send_image": 1, "image_compression_ratio": 90, "use_tracking": 1, "roi": "Polygon 0 0 0 0" }, { "camera_names": ["constructionsite01_pos02"], "send_image": 1, "image_compression_ratio": 80, "use_tracking": 0, "roi": "Polygon 0 0 1920 0 1920 1080 0 1080" }] } //constructionsite02的两个摄像头pos1和pos2配置相同参数： { "heartbeat_interval": 60, "post_url": "https://abc.company.com/standard", "multi_camera": [{ "camera_names": ["constructionsite02_pos01"," constructionsite02_pos02"], "send_image": 1, "image_compression_ratio": 90, "use_tracking": 1, "roi": "Polygon 0 0 0 0" }] }

技能结果上传接口 请求消息 推理结果将以HTTPS POST请求方法推送到应用系统server的指定URL地址。 POST {sendUrl} 其中sendUrl在技能运行时配置中设置。 请求消息头 技能以json形式返回推理结果，因此消息头Content-Type类型为“application/json”，参数说明如表5所示。 表5 请求消息头参数说明 名称 描述 是否必选 示例 Content-Type 消息体的类型（格式） 是 application/json。 公共消息体 华为HiLens 公共消息体包含了技能的公共消息内容，如表6所示。 表6 公共消息体参数说明 名称 类型 说明 msg_type String 技能类型，为face_detection_result。 cam_name String 摄像头名称。 skill_id String 技能ID。 技能消息体 人脸检测的json消息体如表7所示： 表7 技能消息体参数说明 名称 类型 说明 face_id String 人脸图UUID。 track_id Uint64 人脸的跟踪标记，相同的track_id表示同一个人脸。 ori_img_id String 人脸背景原始图UUID。 time Uint64 图片解码时间的时间戳，单位为秒。 bbox Object 人脸图在背景图中的位置信息。位置信息参数请参见表8。 clarity Float 人脸清晰度，范围[0,1]。 face_image String 人脸图BASE64编码结果。 ori_image String 原始图BASE64编码结果，如果配置不发送原始图，则无该字段。 表8 bbox位置信息参数说明 字段 类型 说明 x Int 人脸图左上角顶点x坐标值。 y Int 人脸图左上角顶点y坐标值。 h Int 人脸图高。 w Int 人脸图宽。 人脸检测的json消息体示例如下： { "msg_type": "face_detection_result", "cam_name": "store001_pos2", "skill_id": "f5c526eb6c51440c8a0ee5e3cc65f23c", "face_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9218", "track_id": 1, "ori_img_id": "0DD1BF0A-634B-11E8-8B0B-407D0FAD9218", "time": 1527603463, "bbox ": { "x": 32, "y": 379, "w": 49, "h": 65 }, "clarity": 0.55, "face_image": "4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQE...", "ori_image": "4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQE...", } 响应消息 响应消息头 响应消息头由服务器端(应用系统)收到请求消息后返回。 响应消息头可包含如下两部分。 一个HTTP状态代码，从2xx成功代码到4xx或5xx错误代码。或者可以返回服务定义的状态码。 附加响应头字段，如支持请求的响应所需，如Content-type响应消息头。 详细的公共响应消息头参数说明如表9所示。 表9 公共响应消息头参数说明 名称 描述 示例 Date HTTP协议标准报头。表示消息发送的时间，时间的描述格式由rfc822定义。 Mon, 12 Nov 2007 15:55:01 GMT Server HTTP协议标准报头。包含了服务器用来处理请求的软件信息。 Apache Content-Length HTTP协议标准报头。用于指明实体正文的长度，以字节方式存储的十进制数字来表示。 xxx Content-Type HTTP协议标准报头。用于指明发送给接收者的实体正文的媒体类型。 application/json 响应消息体（可选） 响应消息体通常以结构化格式（如json或xml）返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。

技能描述 面向智慧商超的人脸采集技能。本技能使用多个深度学习算法，实时分析视频流，自动抓取画面中的清晰人脸上传至您的后台系统，用于后续实现其他业务。 本技能支持： 判断并过滤尺寸过小、清晰度较差、角度过大等无法判断的人脸。 同时检测多张人脸。 人脸跟踪。对同一个人抓拍的人脸做去重，避免大量的重复上报。 根据业务需求划定区域，只抓取固定区域内的人脸。 使用时需要提供您的业务RESTful接口和RTSP视频地址，最大支持10路网络摄像头接入，并按照接入的路数进行收费。 摄像头部署建议请参见摄像头部署。 技能配置项请参见运行时配置参数。 技能接口设计请参见技能结果上传接口。

运行时配置参数 技能在运行时，需要添加运行时配置。配置完成后，参数会从华为HiLens云侧下发到端侧设备。 配置参数说明 技能相关配置参数设计如表3所示。 表3 运行时配置参数 名称 是否必选 参数类型 说明 logLevel 是 Enum 日志级别，包括INFO，DEBUG，WARNING和ERROR。建议设置为INFO。 keep_running 是 Int 当技能崩溃是否自动拉起技能并持续运行。此项配置在1.1.0及以后版本起作用。 multi_camera 是 List 一个设备上多路视频的技能参数，详情请参见表4。 表4 视频参数说明 名称 是否必选 参数类型 说明 camera_names 是 List 摄像头名称。可配置多个名称，表示多个摄像头采用同样的技能配置。 sendOriImgFlag 是 Int 是否发送人脸背景原始图,默认值：0。 0：表示不发送 1：表示发送 sendRepeatFaceFlag 是 Int 是否重复发送清晰人脸图，开关打开后，同一个人只要显示更清晰的人脸会重复发送, 默认值：0。 0：表示不发送 1：表示发送 sendOriImgCompressionRatio 否 Int 原始图jpeg压缩百分比，默认值为90,表示图片压缩比90%，取值范围[1 100]。 cropSizeMax 否 Int 发送人脸图片长宽的最大像素，默认值400。 cropSizeMin 否 Int 发送人脸图片长宽的最小像素，默认值80。 roi 否 String 检测区域配置。区域的设置由Polygon开头，其后依次为区域的坐标(按顺时针排列的x，y坐标)。默认值为Polygon 0 0 0 0，表示检测整个画面。 sendUrl 是 String 发送技能消息POST请求的URL地址。 faceQualityThreshold 是 Float 人脸清晰度阈值。清晰度大于此值的人脸才发送。取值范围[0.0, 1.0]，默认值0.38。 centerMode 否 Int 是否只检测roi区域中的最大人脸，默认值0。 0：返回所有人脸。 1：只返回roi中最大的人脸。 示例 HiLens Kit设备支持多路摄像头接入，如果要为不同的摄像头设置不同的技能配置，或者几个摄像头共用同一技能配置，则可在配置列表中给出相应的配置信息，示例如下： //Store001的两个摄像头pos1和pos2配置不同参数： { "logLevel": "INFO", "keep_running": 1, "multi_camera": [{ "camera_names": ["store001_pos1"], "sendOriImgFlag": 0, "sendRepeatFaceFlag": 0, "sendOriImgCompressionRatio": 90, "cropSizeMax": 400, "cropSizeMin": 120, "roi": "Polygon 0 0 0 0", "sendUrl": "https://abc.company.com/face", "faceQualityThreshold": 0.45, "centerMode": 0 }, { "camera_names": ["store001_pos2"], "sendOriImgFlag": 1, "sendRepeatFaceFlag": 1, "sendOriImgCompressionRatio": 100, "cropSizeMax": 300, "cropSizeMin": 80, "roi": "Polygon 0 0 0 0", "sendUrl": "https://abc.company.com/face", "faceQualityThreshold": 0.55, "centerMode": 0 }] } //Store002的两个摄像头pos1和pos2配置相同参数： { "logLevel": "INFO", "keep_running": 1, "multi_camera": [{ "camera_names": ["store002_pos1","store002_pos2"], "sendOriImgFlag": 0, "sendRepeatFaceFlag": 0, "sendOriImgCompressionRatio": 90, "cropSizeMax": 400, "cropSizeMin": 120, "roi": "Polygon 0 0 0 0", "sendUrl": "https://abc.company.com/face" "faceQualityThreshold": 0.55, "centerMode": 0 }] }

2.填写基础信息 在新建技能页面填写基本信息，参数说明请见表1，填完基本信息后单击右下角的“下一步”，配置启动参数。其中，“技能版本”的版本号应该高于之前的版本号。 表1 技能基本信息参数说明 参数 说明 技能名称 技能的名称，下发到端侧也使用该名称作为根目录，默认为技能新建时的名称，不可修改。 可输入中文、字母、数字、下划线或中划线，必须以中文、字母开头，以中文、字母或数字结尾，长度3~60个字符。 说明： 由于技能市场不允许存在同名技能，所以如果想发布到技能市场，请使用全局唯一的名称对您的技能进行命名。 技能版本 技能的版本。版本号格式为“A.A.A”，“A”为不超过3位的自然数。例如“1.0.0”。 当“A”超过一位时，不允许以“0”开头，比如禁止输入“01.0.0”。 版本号应当高于之前的版本号。 适用设备类型 技能适用的设备类型，包括Windows、Atlas 500、通用x86设备、通用ARM设备、SDC等设备类型。 应用场景 技能适用的场景，例如“园区”、“工业”、“零售”、“金融”等场景。 技能图标 技能的头像。 标签 待创建技能的标签。 单击“添加标签”，填写标签键和标签值。 只允许大小写字母、数字、下划线和中划线，不允许为空。标签名不允许重复，最大长度为36个字符；标签值最大长度为43个字符。 如果删除标签，可单击“操作”列的“删除”。 简介 对技能的简单介绍。 最大长度512，不允许输入~^$%&等特殊字符。 描述 对技能的详细介绍。 技能格式 支持“技能包”和“容器镜像”两种格式，具体格式要求请见技能包和容器镜像。 技能格式选择“技能包” 技能包路径：单击“选择OBS地址”，选择RPM技能包在OBS的存储路径。 技能格式选择“容器镜像” 镜像类型：支持镜像类型为“ModelBox镜像”和“普通镜像”。 镜像路径：单击“选择SWR地址”，选择容器镜像在OBS的存储路径。 RootKey 使用ModelBox开发框架的加密工具ModelBox Tool加密模型后，可获取Root Key。 模型密钥 使用ModelBox开发框架的加密工具ModelBox Tool加密模型后，可获取模型密钥。

单设备部署技能流程 单设备技能部署流程如图1所示，操作指引如设备管理及部署流程简介所示。 图1 技能部署流程 表1 单设备部署技能流程 任务 说明 详细指导 注册设备 在使用专业版HiLens管理控制台之前，您需要将计算设备注册至控制台。 目前支持HiLens设备（Windows、Atlas 500、通用x86设备、通用ARM设备、SDC等设备类型）和HiLens Kit的注册、管理和注销。 注册HiLens设备 激活设备 注册设备后，需购买HiLens端云协同AI运行服务，并在设备管理页面对设备进行权限激活，该设备方能部署技能。 订购HiLens端云协同AI运行服务 激活设备（购买端云协同AI运行服务） 准备技能 购买技能：在技能市场购买符合设备规范的技能。 技能市场 自定义技能：专业版HiLens管理控制台支持RPM格式的技能包和容器镜像两种技能，本地按技能规范准备技能。 技能介绍 部署技能 将技能部署到设备上，运行技能。 创建部署工程 添加作业 查看技能运行效果 查看技能日志，观察技能运行效果。 管理设备日志

设备管理相关操作及说明 激活设备（购买端云协同AI运行服务）：注册设备后，需购买HiLens端云协同AI运行服务，并在设备管理页面对设备进行权限激活，该设备方能部署技能。 部署技能：可在已注册的设备上部署技能、查看部署信息、升级部署、删除部署、添加作业等。 添加标签：可对已注册的设备添加标签。 管理设备日志：在部署并添加作业后，可查看技能日志。 升级HiLens_Device_Agent固件版本：当设备厂商有新的固件版本时，您可以选择升级固件版本。 添加摄像头：为已注册的设备连接管理更多的IP摄像头。 注销设备：在设备不再使用时，注销设备以释放资源。

容器镜像 容器镜像格式是一个包含应用运行需要的各种组件和应用本身的镜像。可以使用ModelBox提供的软件包打包工具或者是镜像打包工具，也可以按照下面的格式手动打包。 应用容器镜像包含三层：基础镜像层、ModelBox框架层和应用层。 基础镜像层：提供下层设备的驱动，以及其中ModelBox框架和基础功能单元依赖的一些第三方库如FFmpeg，TensorRT，OpenCV等。 ModelBox框架层：包括ModelBox基础框架包和ModelBox基础功能单元包。 应用层：包含用户自定义的一些功能单元，以及功能单元需要的一些第三方库，以及业务流程图等。

控制台新建技能流程 当前专业版HiLens控制台支持新建技能包和容器镜像两种格式的技能。在准备新建技能前，请明确您需要开发一个什么类型的技能。 图1 控制台开发技能流程 表2 控制台开发技能流程说明 流程 说明 详细指导 准备工作 如果希望新建的技能部署至端侧设备，需要提前注册设备至专业版HiLens控制台。 当注册的设备超过1台时，需购买HiLens端云协同AI运行服务，并激活设备，才能安装自行开发的技能至设备上。 注册HiLens设备 订购HiLens端云协同AI运行服务 激活设备（购买端云协同AI运行服务） 新建技能 在专业版HiLens控制台基于业务需求新建技能。 新建技能 部署技能 将新建的技能部署至端侧设备，调试技能。 创建部署工程 查看技能运行效果 查看技能日志，观察技能运行效果。 管理设备日志

2.填写基础信息 在新建技能页面填写基本信息，参数说明请见表1，填完基本信息后单击右下角的“下一步”，配置启动参数。 表1 技能基本信息参数说明 参数 说明 技能名称 技能的名称，下发到端侧也使用该名称作为根目录。 只允许英文小写字母、数字、中划线、最大长度32的字符，必须以英文小写字母、数字开头和结尾。 说明： 由于技能市场不允许存在同名技能，所以如果想发布到技能市场，请使用全局唯一的名称对您的技能进行命名。 技能版本 技能的版本。版本号格式为“A.A.A”，“A”为不超过3位的自然数。例如“1.0.0”。 当“A”超过一位时，不允许以“0”开头，比如禁止输入“01.0.0”。 适用设备类型 技能适用的设备类型，包括Windows、Atlas 500、通用x86设备、通用ARM设备、SDC等设备类型。 应用场景 技能适用的场景，例如“园区”、“工业”、“零售”、“金融”等场景。 技能图标 技能的头像。 标签 待创建技能的标签。 单击“添加标签”，填写标签键和标签值。 只允许大小写字母、数字、下划线和中划线，不允许为空。标签名不允许重复，最大长度为36个字符；标签值最大长度为43个字符。 最多可添加20组标签。 如果删除标签，可单击“操作”列的“删除”。 简介 对技能的简单介绍。 描述 对技能的详细介绍。 技能格式 支持“技能包”和“容器镜像”两种格式，具体格式要求请见技能包和容器镜像。 技能格式选择“技能包” 技能包路径：单击“选择OBS地址”，选择RPM技能包在OBS的存储路径。 技能格式选择“容器镜像” 镜像类型：支持镜像类型为“ModelBox镜像”和“普通镜像”。 镜像路径：单击“选择SWR地址”，选择容器镜像在OBS的存储路径。 RootKey 使用ModelBox开发框架的加密工具ModelBox Tool加密模型后，可获取Root Key。 模型密钥 使用ModelBox开发框架的加密工具ModelBox Tool加密模型后，可获取模型密钥。 校验配置文件 对校验配置文件中的文件和路径进行校验，防止技能中的文件被篡改。使用该功能，需要使用modelbox-tool在技能包或容器镜像中增加校验配置文件。

容器镜像 容器镜像格式是一个包含应用运行需要的各种组件和应用本身的镜像。可以使用ModelBox提供的软件包打包工具或者是镜像打包工具，也可以按照下面的格式手动打包。 应用容器镜像包含三层：基础镜像层、ModelBox框架层和应用层。 基础镜像层：提供下层设备的驱动，以及其中ModelBox框架和基础功能单元依赖的一些第三方库如FFmpeg，TensorRT，OpenCV等。 ModelBox框架层：包括ModelBox基础框架包和ModelBox基础功能单元包。 应用层：包含用户自定义的一些功能单元，以及功能单元需要的一些第三方库，以及业务流程图等。

开发者控制台开发技能 专业版华为HiLens对接开源框架ModelBox，提供了技能开发的平台。AI应用开发者可以在专业版HiLens控制台开发AI应用，并可以方便地部署应用到设备上实时查看应用的运行效果。 使用流程如图1，流程说明请参见表2。 图1 开发者使用流程 表2 控制台开发技能流程说明 流程 说明 详细指导 注册设备 如果希望新建的技能部署至端侧设备，需要提前注册设备至专业版HiLens控制台。 注册HiLens设备 新建技能 在专业版HiLens控制台基于业务需求新建技能。 新建技能 部署技能 将新建的技能部署至端侧设备，调试技能。 创建部署工程 查看技能运行效果 查看技能日志，观察技能运行效果。 管理设备日志

华为HiLens功能导读 表3 文档导读 章节 面向角色 说明 注册帐号 ALL 首先，作为任意一种角色，您需要申请华为云帐号并进行实名认证。通过此帐号，您可以使用所有华为云服务，并且只需为您所使用的服务付费。在开始使用华为HiLens前获得其他相关服务的授权，然后再进入专业版HiLens管理控制台相关功能。 注册HiLens设备 普通用户 开发者 针对普通使用者或开发者，在使用技能或开发技能前，需先购买端侧设备，并且参考操作指导完成连接，将端侧设备与云侧HiLens管理控制台完成连接。 管理设备 普通用户 开发者 您可以通过专业版华为HiLens管理控制台管理已注册的端侧设备。包括设备上的技能管理、升级固件、配置摄像头等操作。对于拥有端侧设备的用户（包括普通使用者和开发者），您都可以通过设备管理的操作，管理您的设备。 控制台开发技能 开发者 对于开发者，您可以在华为HiLens平台新建您的技能，自行开发算法模型和逻辑代码，再用于新建技能。另外，还支持将您开发的技能安装部署至设备进行调试。 最后，针对调试完成的技能，您可以将其发布至技能市场，供更多用户获取使用，同时您还能获得相应的报酬。 技能市场 ALL 技能市场是一个开放的平台，提供了适用于不同应用场景的技能。您可以在技能市场购买技能。如果您是开发者，也可以将自己开发的技能发布至技能市场，收取相应的报酬。

设备部署技能流程 专业版HiLens管理控制台目前支持HiLens设备（Windows、Atlas 500、通用x86设备、通用ARM设备、SDC等设备类型）和HiLens Kit的注册、云上管理和技能部署。AI应用使用者可以直接注册端侧设备，在技能市场选购合适的AI应用部署至端侧设备。单设备部署技能流程指导请参见表1。 表1 单设备部署技能流程 任务 说明 详细指导 注册设备 在使用专业版HiLens管理控制台之前，您需要将计算设备注册至控制台。 目前支持HiLens设备（Windows、Atlas 500、通用x86设备、通用ARM设备、SDC等设备类型）和HiLens Kit的注册、管理和注销。 注册HiLens设备 激活设备 注册设备后，需购买HiLens端云协同AI运行服务，并在设备管理页面对设备进行权限激活，该设备方能部署技能。 订购HiLens端云协同AI运行服务 激活设备（购买端云协同AI运行服务） 准备技能 购买技能：在技能市场购买符合设备规范的技能。 技能市场 自定义技能：专业版HiLens管理控制台支持RPM格式的技能包和容器镜像两种技能，本地按技能规范准备技能。 技能介绍 部署技能 将技能部署到设备上，运行技能。 创建部署工程 添加作业 查看技能运行效果 查看技能日志，观察技能运行效果。 管理设备日志

创建工作空间 登录专业版华为HiLens管理控制台，在左侧导航栏中“当前工作空间”下方的下拉框中选择“创建工作空间”。 进入“创建工作空间”页面。 图1 创建工作空间 也可以在左侧导航栏选择“工作空间”，在工作空间页面单击“创建工作空间”。 填写工作空间名称和描述，填完之后单击右下角的“立即创建”，跳到“工作空间”页面，可查看所创建的新工作空间。 填写工作空间描述时，请以中文、字母开头，以中文、字母、数字结尾，字符长度范围为4-48的字符，仅允许输入中文、字母、数字、中划线、下划线。 图2 创建工作空间-0

订单激活 使用订单号激活设备，需要先购买HiLens端云协同AI运行服务，详情请见订购HiLens端云协同AI运行服务。 登录专业版华为HiLens管理控制台，在左侧导航栏选择“设备管理”。 进入“设备列表”页面。 选择“设备状态”处于“运行中”，且“激活状态”处于“未激活”的设备，单击激活状态列的“立即激活”。 进入设备激活页面。 图1 激活设备 勾选订单，然后单击右下角的“确定”。 调至设备列表页面，设备激活成功后，设备的激活状态变成“已激活”。 图2 订单号激活

单个设备添加标签 在HiLens专业版管理控制台左侧菜单栏选择“设备管理”，然后在设备列表中，选择需要进行管理的某一设备，单击设备名称进入设备详情页面。 “设备详情”页面默认展示“部署列表”页签。 单击“标签”，切换至“标签”页签。 在“标签”页签，单击“添加标签”。 弹出“添加标签”对话框。 图2 添加标签 在“添加标签”对话框中填写“标签名”和“标签值”，单击“确定”。 只允许大小写字母、数字、下划线和中划线，不允许为空。标签名不允许重复，最大长度为36个字符，标签值最大长度为43个字符。最多可添加10组标签。 在“标签”页签可查看已添加的标签。