华为云用户手册

使用SSH注册设备 使用SSH注册设备指通过SSH登录HiLens Kit系统，使用Linux命令注册设备。SSH登录设备系统支持操作HiLens Kit的系统文件等配置。 使用SSH注册设备流程如图3所示，详细操作指引请参见表3。 图3 SSH注册设备流程 表3 SSH注册设备流程说明 流程 说明 详细指导 连接PC和HiLens Kit 在注册HiLens Kit至控制台之前，您需要连接PC和HiLens Kit。 连接PC和HiLens Kit SSH登录HiLens Kit 使用SSH连接设备HiLens Kit，用Linux指令进行操作。 SSH登录HiLens Kit设备 组网配置 HiLens Kit有两种组网方式，分为无线和有线两种方式连接路由器，您可以选择其中一种方式进行组网配置。 不能同时使用无线网络和有线网络连接同一个路由器，无线连接会自动删除默认网关，再次使用有线网络时需要配置默认网关。推荐使用无线连接到路由器，以免更新设备IP后遗忘或丢失IP。 无线网络配置（SSH） 有线网络配置（SSH） 注册HiLens Kit 注册设备至控制台上，并在控制台上查看设备状态。 SSH注册HiLens Kit

HiLens Kit简介 HiLens Kit是一款具备AI推理能力的多媒体终端设备，具有强大的计算性能、高清摄像头接入、体积小、接口丰富等特点。硬件集成了Atlas 200 AI加速模块（简称Atlas 200），方便用户快速简捷的接入并使用Ascend 310 AI处理器强大的处理能力，主要应用于AI开发者预研开发和视频监控领域。系统内置HiLens Framework，给运行的技能提供丰富的API接口。 HiLens Kit板载32GB eMMC，提供1个Micro SD卡槽位，可自行扩展Micro SD卡，最高支持速率SDR50，最大容量2TB，外接SD卡操作请见使用SD卡。其具体参数请参见表1。 图1 HiLens Kit

切换设备注册区域至北京一（可选） 设备默认注册至区域北京四，如果希望把设备注册至北京一，请修改设备中配置文件的相关内容。详细步骤如下： 在PuTTY里进入文件 vi /home/hilens/hda/etc/hda.conf 修改设备注册区域：在注释语“#选择注册到华为云的区域，默认为北京4”下方，把region=cn-north-4修改为 region = cn-north-1 并保存。 重启设备，即执行 reboot

前提条件 保证华为云账号处于不欠费状态。在华为HiLens控制台开发技能时，会占用OBS资源，需要收取一定费用，收费规则请参见对象存储服务 OBS。 已订购HiLens Studio版本。 新建技能使用的算法模型已开发完成并导入HiLens中。 当前技能市场购买的技能暂不支持在HiLens Studio中打开，您可以选择在HiLens Studio中选择技能模板新建技能项目，详情请见新建技能项目。

4. 确认信息进入HiLens Studio 确认信息无误后，单击“确定”，进入启动HiLens Studio的界面。 必要信息填写完成后，您可以在界面右侧查看其配置参数值，如果某个字段填写错误，在右侧会显示一个小红叉。 图3 确认信息 确认信息后请务必进入HiLens Studio界面查看所创建的技能项目，否则会创建空项目，造成后续无法在HiLens Studio界面打开技能项目文件。 如果打不开HiLens Studio界面，请检查浏览器是否设置阻止弹出式窗口。如果浏览器设置了阻止弹出式窗口，请添加HiLens Studio网址为允许浏览器弹窗的白名单地址。

3. 运行时配置（可选） 图2 运行时配置-26 部分技能在运行的时候需要用户配置参数，比如人脸判断类的技能需要用户上传人脸库等。运行时配置就像是一个“钩子”，开发者把“钩子”放出去，用户运行技能的时候设置了这些配置项，HiLens就会帮开发者把“钩子”收回来，这时候在代码里面开发者就可以使用这些用户的设置。您可以在界面中单击添加配置标签，参考表2填写您的配置。 您还可以单击“预览JSON格式”查看“钩子”的格式。开发者通过HiLens Framework提供的get_skill_config接口获取技能配置的JSON格式，读取里面字段的值来使用用户的配置。 运行时配置JSON格式如下所示： { //全局配置 "Language": "enum", //视频分路配置 "multi_camera": [ //该字段key值multi_camera固定，值表示摄像头分路配置 { "camera_names": [ //该字段key值camera_names固定，值表示该分组配置里包含了哪些摄像头 "cameraX", "cameraY" ], "FaceLib": { //配置名 "from": "file source", //文件类型值，表示文件来自哪个服务。比如OBS "path": "file path" //文件类型值，表示文件的路径 } } ], } 表2 运行时配置的参数说明 字段名称 说明 配置名 配置的名称，逻辑代码里面可用该字段获取该配置的值。运行时配置指技能在运行的时候，由用户配置的内容。比如人脸判断技能需要用户上传人脸库等。需要说明的是，整个运行时配置是可选的，但如果添加了一条配置，那么“配置名”、“配置说明”是必填项。 值类型 表示该配置项的值是什么类型的数据。 数值类型（int、float）、枚举类型、字符串和文件类型。 值约束 表示该配置可以设置的范围。跟值类型有关。 数值类型：用开闭区间的表示方法。如[1,100)表示大于等于1小于100。 字符串和文件：该项无需输入。 枚举：集合的表示方式，如{a,b}。 配置说明 说明该配置的作用，以及配置方法。该字段非常重要，用户会根据该字段的说明来配置，所以如果有运行时配置，开发者一定要在这里解释清楚。 配置对象 HiLens Kit可以连接多个（个数不大于设备上所安装技能的支持通道数之和）摄像头，所以可以开发支持多路视屏的技能。 选择“视频”，则表示该配置是可以针对设备上每个摄像头视频进行配置的，比如摄像头1和摄像头2采用不同的人脸库。 选择“全局”,则表示设备上所有摄像头都用同一个配置值。

配置要求 针对使用无线网络连接路由器的方式，需要输入无线网络密码，成功连接无线网络。 当前HiLens Kit仅支持2.4G频段的无线网络和常规的加密类型无线网络，且无线网络名称不包含英文的单引号和双引号，长度8-63个字符。 支持的2.4G频段无线网络所使用的协议为IEEE802.11n\IEEE802.11g\IEEE802.11b。 支持的无线网络加密类型有WEP、WPA-PSK/WPA2-PSK和AES。 暂不支持需要验证的无线网络。 暂不支持TKIP加密。 路由器网关不能使用xxx.xxx.0.xxx网段，比如192.168.0.1，也不要和HiLens Kit网口在同一网段，例如，设备IP是192.168.2.111，那么路由器的网关就不能设置成192.168.2.xxx。

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

普通用户使用技能 普通用户是指使用HiLens Kit设备，希望提高家庭、商超、园区或工地等场景下的智能监控能力的用户。 图1 普通用户使用流程 表1 普通用户使用流程说明 主任务 说明 详细指导 购买HiLens Kit 使用技能的前提条件是购买HiLens Kit设备。 订购HiLens Kit 注册HiLens Kit 首先，连接您的HiLens Kit，并将HiLens Kit注册到华为HiLens平台，连接端侧与云测。 HiLens Kit注册流程 智能边缘系统注册设备 使用SSH注册设备 订购技能 定制技能（可选）：技能市场现有的技能无法满足您的需求，您可以提出定制需求。针对HiLens Kit设备，您需要定制用于Ascend芯片的技能。 定制技能 购买技能：在技能市场直接购买所需要的技能，或者在技能市场上购买已定制完成的技能，以便安装在设备上使用，拓展设备的AI能力。在技能市场中，请选择适用于Ascend芯片的技能。 购买技能 安装技能 将购买的技能安装到设备上。 安装技能 查看技能运行效果 查看设备数据以及技能的运行效果。 管理数据

厂商管理产品 针对生产海思35xx系列芯片的摄像头的设备商，华为HiLens提供了一个产品管理的流程。设备厂商可以通过华为HiLens管理设备产品，订购技能，然后将License分发至产品设备，使得厂商的设备具备AI能力。 厂商管理产品的使用流程如图3，流程说明请参见表3。 图3 厂商使用流程 表3 厂商的使用流程说明 流程 说明 详细指导 新建产品 厂商创建一个产品，然后把设备“关联”到这个产品。 新建产品 订购技能 定制技能：技能市场现有的技能无法满足您的需求，您可以提出定制需求。提出需求时，需指定此技能适用于海思35XX系列芯片。 定制技能 购买技能：在技能市场直接购买所需要的技能（适用于海思35XX系列的芯片），或者在技能市场上购买已定制完成的技能，以便分发至用户设备上使用。 购买技能 分发技能 将订购的技能分发到设备上，并下载SDK集成到设备上，供用户使用。 分发技能

开发者控制台开发技能 华为HiLens提供了技能开发的平台，您可以根据自身情况开发可用于Ascend310或者海思35XX系列的技能。适用于Ascend310芯片的技能可直接安装部署在HiLens Kit设备中使用。 由于使用海思35XX系列芯片的设备，其芯片内存和性能偏低，需要对模型进行优化后才能运行，其对应的技能开发难度较大，如果碰到困难，可联系华为HiLens平台工作人员支撑。 技能开发过程中需要将技能部署到设备，以便查看技能运行效果，所以建议开发者购买一个HiLens Kit设备。 开发技能需要模型，所以开发者需要在本地或在ModelArts中训练好AI模型。在ModelArts中训练模型可参见ModelArts训练模型。 使用流程如图2，流程说明请参见表2。 图2 开发者使用流程 表2 开发者使用流程说明 流程 说明 详细指导 准备工作 华为HiLens控制台支持设备管理和技能管理，在使用华为HiLens之前，您可以根据自身业务选择合适的设备。如果您选择HiLens Kit设备，请做好如下准备工作。 购买HiLens Kit 将开发好的技能安装至设备前提条件是购买HiLens Kit设备。 购买HiLens端边云协同平台服务并激活设备 当您注册的设备超过1台时，需购买HiLens端边云协同平台服务，在设备管理页面对指定设备进行权限激活后，该设备即可安装您自行开发的技能。 订购HiLens Kit 订购HiLens端边云协同平台服务 激活设备（购买端边云协同平台服务） 注册设备 首先，将设备注册到华为HiLens平台，连接端侧与云侧。华为HiLens支持HiLens Kit、Atlas500、Atlas 800，IVS 1800以及其他适配中设备。 注册HiLens Kit 开发技能 使用技能模板新建技能：获取华为HiLens提供的技能模板（已经包含了算法模型和逻辑代码），快速新建技能。 获取技能模板 使用技能模板 使用空模板新建技能：为满足更多业务诉求，可以自行开发模型，并将开发好的算法模型导入华为HiLens，根据业务诉求编写逻辑代码，然后基于您自定义的算法模型和逻辑代码新建技能。 如果您的算法模型不符合华为HiLens格式要求，还可以使用模型转换功能满足要求。 开发算法模型 导入（转换）模型 编写逻辑代码 使用空模板 部署技能 将技能部署到设备上，便于调试运行效果。 安装和调试技能 查看技能运行效果 查看设备数据以及技能的运行效果。 管理数据

背景信息 购买技能需要一定的费用，在使用华为HiLens前检查账号状态，账号不能处于欠费或冻结状态。 技能可以分为“适用于Ascend芯片的技能”和“适用于海思35XX系列芯片的技能”，请仔细查看界面中技能的类型，然后根据实际情况进行购买。 当“技能市场”没有您需要的技能，可以向华为HiLens提出定制技能的需求，详情请见定制技能。 当前技能市场购买的技能暂不支持在HiLens Studio中打开，您可以选择在HiLens Studio中选择技能模板新建技能项目，详情请见新建技能项目。

前提条件 依次完成如下操作： 网线连接PC和设备，详细操作请参见连接PC和HiLens Kit。 升级HiLens Kit系统固件版本，详情请参见升级HiLens Kit系统固件版本。 同步设备时区和时间，详情请参见同步时区和时间。 选择如下方式中的一种组网配置： 配置无线网络 配置有线网络 不能同时使用无线网络和有线网络连接同一个路由器，无线连接会自动删除默认网关，再次使用有线网络时需要配置默认网关。推荐使用无线连接到路由器，以免更新设备IP后遗忘或丢失IP。

摄像头部署 客流统计算法根据头肩检测统计客流的大小。摄像头的架设会影响头肩检测模型的准确率。在实际架设中，尽量保证拍摄画面清晰，光照充足，人形较正，无遮挡。监控视频场景下尽量保证拍摄的画面能拍到更多的人形。 摄像头参数基本设置 不同品牌的摄像头都有一些基本的视频设置，例如分辨率、帧率和码率等，具体要求如下： 分辨率：建议1080P，不低于720P，不高于4K（3840*2160）。 帧率：不高于25fps，不低于15fps，建议值20fps。 码率：720P建议设为4096Kbps~6144Kbps，1080P建议设为6144Kpbs~8192Kbps，更高分辨率可设置更高码率。 视频编码：如果支持H.265，设置为H.265。 日夜切换：关闭夜间自动切换红外模式，暂不支持抓取红外模式下的人脸。 宽动态：关闭宽动态。普通摄像头的宽动态无法到达专业相机的效果，人的走动速度较快时存在运动模糊，应关闭宽动态设置。 摄像头拍摄方向 摄像头拍摄方向要正向行人正反面，略成俯视角度，具体要求如下： 保证行人上半身轮廓清晰可见。 架设高度：4m左右。 监控距离：5-10m 。 监控宽度：2-5m 。 俯视角度：左右偏角小于8°；俯仰角10°-20°。 光照要求 光照条件要求需要满足如下要求： 行人区域正面光照强度100lux及以上；防止出现过暗或者噪点。 行人左右侧光照强度差不超过一倍；防止产生阴阳脸。 行人背部光照强度不超过正面强度两倍；防止产生脸部曝光不足，五官细节丢失。 如果现场的光线不满足上述要求，则需要通过强光抑制或补光来优化现场的光照条件。强光抑制可以改善“阴阳脸”、“背光”现象，即通过减弱侧面光照来改善光照条件。补光则可以通过增加额外光源的方式改善光照条件，提高人脸图像的采集效果；主要通过普通射灯、白炽灯等在不影响装修、路人视觉效果的情况下提高人脸的光照度，消除“阴阳脸”。 安装补光灯时需要注意以下几点条件： 避免补光不均匀。 考虑不同时段设置光照。 根据现场情况灵活变通。 避免直射行人眼睛 。 周围环境要求 镜头前方不要有遮挡的障碍物，避免漏检。 不要将摄像头架在房子遮阴的挡板下，会造成光照过暗，人形模糊。 室外安装摄像头，避免在露天下布置，以免雨水或者雪将摄像头的镜头盖住，造成拍摄画面模糊不清。 室内安装摄像头，当部署楼道时需要注意光照，楼道里灯光明暗交替变化过快，摄像头拍摄时获取的画面可能会偏暗。

技能结果上传接口 请求消息 技能推理结果将以HTTPS POST请求方法推送到应用系统server的指定URL地址。 POST {sendUrl}/ 其中sendUrl在技能运行时配置中为每个设备设置的推理结果上传地址。 请求消息头 技能以json形式返回推理结果，因此消息头Content-Type类型为“application/json”。 表4 请求消息头参数说明 参数 是否必选 说明 示例 Content-Type 是 消息体的类型（格式）。 application/json 公共消息体 华为HiLens 公共消息体包含了技能的公共消息内容，如表5所示。 表5 公共消息体参数说明 参数 类型 说明 msg_type Enum 技能类型，如“flow_count_result”。 cam_name String 摄像头名称。 skill_id String 技能ID。 技能消息体 过线统计的json消息体如表6所示。 表6 过线统计消息体参数说明 参数 类型 说明 event_type Int 事件类型，过线统计的事件类型为0，区域统计为1。 start_time Uint64 过线统计开始的时间戳。 end_time Uint64 过线统计结束的时间戳。 counter List 输出结果列表。每组数据对应一条自定义直线，包含： x、y：直线两个点的x、y坐标。 id：直线的ID。 side1_name、side2_name：直线两侧的标识名。 side1、side2：人流穿过直线到side1_name与side2_name侧的统计量。 过线统计的消息体示例如下： { "msg_type": "flow_count_result", "cam_name": "store001_pos2", "skill_id": "f5c526eb6c51440c8a0ee5e3cc65f23c", "event_type": 0, "start_time": 1535546730, "end_time": 1535546732, "counter": [{ "x": [480, 1440], "y": [540, 540], "id": 0, "side1": 0, "side2": 0, "side1_name": "side1", "side2_name": "side2" }, { "x": [490, 1500], "y": [640, 340], "id": 0, "side1": 7, "side2": 3, "side1_name": "in", "side2_name": "out" }] } 区域统计的json消息体如表7所示。 表7 区域统计消息体参数说明 参数 类型 说明 event_type Int 事件类型，过线统计的事件类型为0，区域统计为1。 time Uint64 进行区域统计的时间戳。 occupy List 输出结果列表。每组数据对应一个自定义的封闭区域，包含： x、y：封闭区域所有点x，y坐标。 person_list：客流位置信息。详细的位置参数说明请参见表8。 counter：当前时刻，区域的人流统计量。 表8 person_list参数说明 参数 类型 说明 x Int 客流头肩区域的中心点x坐标。 y Int 客流头肩区域的中心点y坐标。 区域统计的消息体示例如下所示： { 'time': 1588927220, 'msg_type': 'flow_count_result', 'event_type': 1, 'cam_name': 'store001_pos2', 'skill_id': 'ff8080826dd4b10d016e20fbb8ae0405', 'device_id': '8366e510ed8b4f94bb9a567e9cc21d23', 'occupy': [{ 'x': [0, 1920, 1920, 0], 'y': [0, 0, 1080, 1080], 'person_list': { 'x': [1155], 'y': [217] }, 'counter': 1 }] }

技能描述 面向智慧商超的客流统计技能。本技能使用深度学习算法，实时分析视频流，自动统计固定时间间隔的客流信息。 本技能支持： 根据业务需求划定区域，只统计固定区域内的客流，技能返回区域内客流的统计信息和坐标信息。 绘制客流统计线，对人形经过该线的人数进行统计，返回客流统计信息。 区域客流统计还可以根据客流坐标生成人流热力图。 使用时需要提供您的业务RESTful接口和RTSP视频地址，最大支持8路网络摄像头接入，并按照接入的路数进行收费。 摄像头部署建议请参考摄像头部署。 技能配置项请参见运行时配置参数。 技能接口设计请参见技能结果上传接口。

运行时配置参数 技能在运行时，需要添加运行时配置。配置完成后，参数会从华为HiLens云侧下发到端侧设备。 技能相关配置参数说明如表2所示。 表2 运行时配置参数 参数 是否必选 参数类型 说明 multi_camera 是 List 一个设备上多路视频的技能参数，详细的参数说明请参见表3。 表3 mul_input_parameter参数说明 名称 是否必选 参数类型 说明 camera_names 是 List 摄像头名称。摄像头名称与设备的rtsp流配置的名称对应。可配置多个名称，表示多个摄像头采用同样的配置。 lineCountCycle 是 Int 过线人流量统计周期，单位为秒。取值范围为(0, +∞)，默认值为10。 regionCountCycle 是 Int 区域人流量统计周期，单位为秒。取值范围为(0, +∞)，默认值为10 enableLine 是 Bool 是否开启过线人流量统计，默认值为1。 0：表示不开启 1：表示开启 enableRegion 是 Bool 是否开启区域人流量统计,支持矩形区域统计，默认值为1。 0：表示不开启 1：表示开启 countSetting 否 String 自定义线与区域列表。采用竖线（|）分隔封闭或直线区域，例如：“Polygon 0 0 0 1000 1000 1000 1000 0|Line 500 0 500 1000 side1 side2”。 封闭区域：由Polygon开头，其后接的依次为区域的端点的坐标。其中端点坐标由x坐标与y坐标组成。 直线区域：位置由Line开头，其后接的四个整型分别为线两端点坐标，最后以side1与side2结尾。side1与side2标志着直线两侧，对于非水平线，左侧为side1，右侧为side2，对于水平线上侧为side1，下侧为side2，其名称可自定义。 sendUrl 是 String 发送技能消息POST请求的URL地址。

使用预置视频流调试代码 HiLens Studio的调试器允许使用断点、单步调试等，与编辑器配合使用。 在HiLens Studio编辑区代码左侧单击鼠标，出现断点。 图14 设置断点-28 调试代码。 方式一：单击HiLens Studio界面上方导航栏的，选择“Read Stream from File”。 图15 预置视频流调试代码 方式二：单击HiLens Studio界面左侧的，弹出“Debug”区，单击开始调试代码。 图16 调试区 方式三：快捷键“F5”，开始调试代码。 在HiLens Studio界面下方“Debug Console” 查看代码调试信息。 图17 Debug Console-29 运行代码 代码调试完成后，可运行代码，查看技能输出。 单击HiLens Studio界面上方导航栏的。 HDMI技能在运行完技能代码后，可在HiLens Studio界面右侧单击，在“Video Output”区查看技能输出。 如果视频流获取失败，可在“Video Output”区右上角单击刷新按钮重新获取。 图18 技能输出-30

使用手机实时视频流调试代码 HiLens Studio的调试器允许使用断点、单步调试等，与编辑器配合使用。在调试代码的过程中，可以使用手机登录HiLens Studio，以手机摄像头实时的视频流作为技能输入，查看技能输出。 步骤一：绑定手机与HiLens Studio账号 在HiLens Studio界面右上角单击用户名，选择“接入手机摄像头（Beta）”。 弹出“接入手机摄像头（Beta）”对话框。 图4 手机登录HiLens Studio 按照“接入手机摄像头（Beta）”对话框的指引，打开手机微信，扫描对话框中的二维码。 手机微信进入“EI体验空间”小程序。 图5 扫描小程序二维码 在手机微信小程序中，选择“HiLens Studio”。 进入HiLens Studio手机小程序界面。 图6 HiLens Studio小程序 单击HiLens Studio界面“接入手机摄像头（Beta）”对话框的“下一步”。 对话框显示摄像头推流二维码。 图7 摄像头推流二维码 在HiLens Studio手机小程序界面勾选“用户协议”，然后单击“扫一扫”，用手机扫描步骤4中的二维码。 进入手机调试界面，功能介绍如表2所示。此时手机与HiLens Studio账号绑定，可以使用手机摄像头在线调试技能。 图8 手机调试界面 表2 手机调试功能说明 序号 说明 1 当前手机摄像头调试的技能名称以及实时输入的视频流。 单击技能名称，可切换技能，在手机弹出的新界面选择新的技能，然后单击“确定”，即可切换技能。 2 当前调试的技能输出视频流。 3 操作列，可进行如下操作： 前置摄像头:切换手机摄像头为前置摄像头。 后置摄像头：切换手机摄像头为后置摄像头。 暂停：暂停当前技能的调试或运行。 返回：退出当前手机调试技能界面，返回至HiLens Studio手机小程序界面。 步骤二：调试和运行技能代码 在HiLens Studio编辑区代码左侧单击鼠标，出现断点。 图9 设置断点 调试代码。 单击HiLens Studio界面上方导航栏的，选择“Read Stream from Mobile Phone”。 图10 实时推流调试代码 在HiLens Studio界面下方“Debug Console” 查看代码调试信息。 图11 Debug Console 运行代码 代码调试完成后，可运行代码，查看技能输出。 单击HiLens Studio界面上方导航栏的运行按钮。 HDMI技能在运行完技能代码后，可在HiLens Studio小程序界面查看技能输出。 图12 手机调试界面-27 同时，也可在HiLens Studio界面右侧单击，在“Video Output”区查看技能输出。 图13 技能输出

项目文件说明 在HiLens Studio界面单击左上角，左侧将展示开发项目的文件目录。打开项目源代码文件“src”，详细代码内容将呈现在HiLens Studio界面的编辑区，您可以直接编辑项目逻辑代码。 文件目录的详细说明如下所示： 开发项目名/ |── .hilens ├── rtmp_source 生成的uuid，用于构成技能rtmp手机推流临时地址。 ├── rtmp.txt 生成的uuid，用于构成技能rtmp推流临时地址。 ├── skill_info.json 项目的元信息。 |── .theia ├── launch.json 项目启动配置。 ├── tasks.json 任务配置。 ├── setting.json C/C++ 配置。目前配置了cpp编译路径，是c++代码跳转非常重要的部分。 |── build ├── CMakeLists.txt 文件。 ├── kit_package_install.sh 技能部署至HiLens Kit打包脚本，此脚本可支持自定义，定制化部署技能至HiLens Kit。 ├── build.sh 项目编译脚本。 ├── clean.sh 项目清理脚本。 ├── prebuild.sh 项目启动预处理脚本。 ├── postbuild.sh 项目运行结束后处理脚本。 ├── output 编译产物。 ├── kit HiLens Kit编译产物。 ├── studio HiLens Studio编译产物。 ├── lib c++项目第三方库。 ├── data 工程需要使用的数据。 ├── model 模型文件。 ├── src 项目源代码。 ├── test 测试数据。 ├── cameras0.mp4 HiLens Studio中Video Capture 默认读取的视频文件。

前提条件 已在华为HiLens控制台选择“HiLens安全帽检测”技能模板新建技能，并评估模型，详情请见评估模型。 由于部署在线应用涉及ModelArts功能，需消耗资源，要确保账户未欠费。 安装技能至设备，需要提前在华为HiLens控制台注册HiLens Kit设备，详细操作指导请见注册HiLens Kit。 在华为HiLens控制台自动创建的技能只能安装至同一账号同一区域下注册的HiLens Kit设备。

上传数据至OBS 使用ModelArts Pro进行应用开发时，您需要将数据上传至OBS桶中。 首先需要获取访问OBS权限，在未进行委托授权之前，无法使用此功能。您需要提前获得OBS授权，详情请见配置访问权限。 已创建用于存储数据的OBS桶及文件夹，且数据存储的OBS桶与ModelArts Pro在同一区域（目前仅支持华为-北京四），详情请见创建OBS桶。 上传数据至OBS，OBS上传数据的详细操作请参见《对象存储服务快速入门》。 您在创建OBS桶时，需保证您的OBS桶与ModelArts Pro在同一个区域。 建议根据业务情况及使用习惯，选择OBS使用方法。 如果您的数据量较小（小于100MB）或数据文件较少（少于100个），建议您使用控制台上传数据。控制台上传无需工具下载或多余配置，在少量数据上传时，更加便捷高效。 如果您的数据量较大或数据文件较多，建议选择OBS Browser+或obsutil工具上传。OBS Browser+是一个比较常用的图形化工具，支持完善的桶管理和对象管理操作。推荐使用此工具创建桶或上传对象。obsutil是一款用于访问管理OBS的命令行工具，对于熟悉命令行程序的用户，obsutil是执行批量处理、自动化任务较好的选择。 如果您的业务环境需要通过API或SDK执行数据上传操作，或者您习惯于使用API和SDK，推荐选择OBS的API或SDK方法创建桶和上传对象。 上述说明仅罗列OBS常用的使用方式和工具，更多OBS工具说明，请参见《OBS工具指南》。

支持的授权项 策略包含系统策略和自定义策略，如果系统策略不满足授权要求，管理员可以创建自定义策略，并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应，授权项列表说明如下： 权限：允许或拒绝某项操作。 授权项：自定义策略中支持的Action，在自定义策略中的Action中写入授权项，可以实现授权项对应的权限功能。 授权范围：自定义策略的授权范围，包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目，表示此授权项对应的自定义策略，可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目，不支持企业项目，表示仅能在IAM中给用户组授权并生效，如果在企业管理中授权，则该自定义策略不生效。关于IAM项目与企业项目的区别，详情请参见：IAM与企业管理的区别。 对应API接口：自定义策略实际调用的API接口。 华为HiLens服务的支持自定义策略授权项如下所示： 设备管理权限 技能开发权限 技能市场权限 管理产品权限

配置要求 针对使用无线网络连接路由器的方式，需要输入无线网络密码，成功连接无线网络。 当前HiLens Kit仅支持2.4G频段的无线网络和常规的加密类型无线网络，且无线网络名称不包含英文的单引号和双引号，长度8-63个字符。 支持的2.4G频段无线网络所使用的协议为IEEE802.11n\IEEE802.11g\IEEE802.11b。 支持的无线网络加密类型有WEP、WPA-PSK/WPA2-PSK和AES。 暂不支持需要验证的无线网络。 暂不支持TKIP加密。 路由器网关不能使用xxx.xxx.0.xxx网段，比如192.168.0.1，也不要和HiLens Kit网口在同一网段，例如，设备IP是192.168.2.111，那么路由器的网关就不能设置成192.168.2.xxx。

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

基本信息 人脸客流统计技能的基本信息如表1所示。 表1 技能参数说明 参数 说明 技能名称 人脸客流统计 应用场景 智慧门店 支持固件版本 HiLens Framework 1.1.2及以上，升级操作请见升级HiLens_Device_Agent固件版本 系统固件要求为2.2.200.011（TR6），升级操作请见升级HiLens Kit系统固件版本 最大路数 最多2路 视频流传输协议 RTSP 输入方式 外接IPC摄像头 输出方式 POST

运行时配置参数 技能在运行时，需要添加运行时配置。配置完成后，参数会从华为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", }] }

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

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

使用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固件版本。