华为云用户手册

什么是区域、可用区？ 用户用区域和可用区来描述数据中心的位置，您可以在特定的区域、可用区创建资源。 区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 可用区（AZ，Availability Zone）：一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 图1阐明了区域和可用区之间的关系。 图1 区域和可用区 目前，华为云已在全球多个地域开放云服务，您可以根据需求选择适合自己的区域和可用区。更多信息参考华为云全球站点。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 service_id String 服务ID service_name String 服务名称 logo String 算法图标，Base64编码格式的字符串，非空时返回 function_version String 功能版本 release_flag Boolean 是否已发布，取值为“true”或者“false” description String 算法描述，非空时返回 created_at Long 创建时间 updated_at Long 更新时间 release_at Long 发布时间 api String API pool_id String 资源池ID alg_name String 算法名称 alg_id String 算法ID request_mode String 请求模式，取值为“sync”或者“async” package_name String 算法包名称 package_id String 算法包ID alg_version String 算法版本 alg_versions Array of strings 算法历史版本 diagram String 算法场景图，Base64编码格式的字符串，非空时返回 service_api_list Array of ServiceApiDto objects 服务API列表 deployment_constraints DeploymentConstraintsDto object 模型部署约束 company String 厂商名称 tags Array of strings 应用场景标签 deploy_type String 部署类型，取值为“cloud”或者“edge” alg_class String 算法类别，取值为“self”或者“partner” alg_status String 算法状态，取值为“service_running”、“service_deploying”、“service_failed”、“service_stopping”、“service_stopped”、“service_upgrading”、“service_finished”、“service_concerning”或者“not_deployed” error_msg String 服务异常信息，非空时返回 表4 ServiceApiDto 参数 参数类型 描述 request_type String 请求类型，get, post zh String 中文描述 en String 英文描述 request_url String 请求url 表5 DeploymentConstraintsDto 参数 参数类型 描述 request_mode String 请求模式，取值为“sync”或者“async” cpu_type String CPU类型，取值为“x86_64”或者“aarch64” accelerators Array of AcceleratorsDto objects 推理加速卡 input_types Array of strings 支持的输入类型，列表元素取值为“OBS”、“URL”、“Restful”、“VCN”、“EdgeCamera” output_types Array of strings 支持的输出类型，列表元素取值为“OBS”、“DIS”或者“Webhook” service_config String 服务启动参数 task_config String 作业配置参数 表6 AcceleratorsDto 参数 参数类型 描述 type String 加速卡类型 最小长度：1 最大长度：256 name String 加速卡名称 最小长度：1 最大长度：256 cuda_version String CUDA版本 最小长度：1 最大长度：256 driver_version_section String 昇腾驱动版本 最小长度：1 最大长度：256

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 id String 边缘池ID name String 边缘池名称 description String 描述信息 state String 边缘池状态 project_id String 用户项目ID workspace_id String 工作空间ID created_at Long 创建时间 updated_at Long 更新时间 nodes Array of EdgeNodeInfoDto objects 边缘节点列表 表4 EdgeNodeInfoDto 参数 参数类型 描述 id String 边缘节点ID。 name String 边缘池名称。 description String 描述信息。描述为空则不返回该字段。 state String 边缘池状态 cpu Integer CPU核心数量。 arch String 计算机架构。 enable_gpu Boolean 是否使用GPU。 enable_npu Boolean 是否使用NPU。 memory Integer 内存大小。 gpu_info Array of GpuInfo objects GPU信息。 npu_info Array of NpuInfo objects NPU信息。 表5 GpuInfo 参数 参数类型 描述 name String GPU卡名称 driver_version String GPU卡驱动版本 type String GPU卡类型 capacity String GPU卡容量 表6 NpuInfo 参数 参数类型 描述 name String NPU卡名称 driver_version String NPU卡驱动版本 type String NPU卡类型 capacity String NPU卡容量 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息描述 detail String 错误详情 params Array of strings 错误参数列举 数组长度：0 - 1 reason String 错误原因 advice String 建议 状态码： 500 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息描述 detail String 错误详情 params Array of strings 错误参数列举 数组长度：0 - 1 reason String 错误原因 advice String 建议

响应示例 状态码： 200 边缘资源池详情响应体 { "id" : "xxx", "name" : "yundao2", "state" : "Running", "project_id" : "xxx", "workspace_id" : "0", "created_at" : 1683344661036, "updated_at" : 1683344661036, "nodes" : [ { "id" : "xxx", "name" : "测试边缘节点-2", "state" : "Running", "cpu" : 16, "arch" : "x86_64", "enable_gpu" : true, "enable_npu" : false, "memory" : 64263, "gpu_info" : [ { "name" : "nvidia0", "driver_version" : "418.67", "type" : " Tesla T4 ", "capacity" : "15079Mi" } ], "npu_info" : [ ] } ] }

如何查看边缘节点的驱动版本 视频智能分析服务视频子服务支持x86+GP Tnt004类型服务器。使用Tnt004类型服务器请下载推荐的Tnt004驱动版本。 命令执行成功后回显信息如图1所示。 图1 GP Tnt004显卡驱动信息 视频智能分析服务视频子服务支持Kunpeng+D310类型服务器。D310推理芯片的驱动分为c82等版本，当前服务支持c82版本驱动。若当前服务器D310芯片驱动非c82版本时，需重新安装c82版本驱动。 查看D310芯片驱动的命令为：npu-smi info 安装c82版本驱动的命令为：./A300-3000-npu-driver_5.1.rc2_linux-aarch64.run --full 若安装时提示缺少用户，则添加一个用户；安装完驱动之后需确保HwHiAiUser的用户组id为1001（id HwHiAiUser命令即可查看）。 当服务器安装的D310芯片驱动是c82版本时，命令执行成功后回显信息如图2所示，c82版本驱动对应的version号为22.0.2。 图2 D310芯片c82版本驱动信息 视频智能分析服务视频子服务支持Kunpeng+D710类型服务器。D710推理芯片的驱动分为c82等版本，当前服务支持c82版本驱动。若当前服务器D710芯片驱动非c82版本时，需重新安装c82版本驱动。 查看D710芯片驱动的命令为：npu-smi info 安装c82版本驱动的命令为：./Atlas-300i-pro-npu-driver_5.1.rc2_linux-aarch64.run --full 若安装时提示缺少用户，则添加一个用户；安装完驱动之后需确保HwHiAiUser的用户组id为1001（id HwHiAiUser命令即可查看）。 当服务器安装的D710芯片驱动是c82版本时，命令执行成功后回显信息如图3所示，c82版本驱动对应的version号为22.0.2。 图3 D710芯片c82版本驱动信息

操作步骤 打开客户端设备的命令行窗口。 执行命令：ping 192.168.1.10，验证连通性。 其中，192.168.1.10为客户端需要访问的弹性云服务器的IP地址，请根据实际替换。 回显如下信息，表示网络已通。 来自 xx.xx.xx.xx 的回复: 字节=32 时间=28ms TTL=245 来自 xx.xx.xx.xx 的回复: 字节=32 时间=28ms TTL=245 来自 xx.xx.xx.xx 的回复: 字节=32 时间=28ms TTL=245 来自 xx.xx.xx.xx 的回复: 字节=32 时间=27ms TTL=245

操作步骤 在“终端入云VPN网关”页面，单击目标VPN网关操作列的“配置服务端”。 根据界面提示配置参数，然后单击“确定”。 本示例仅对关键参数进行说明，全量参数请参见配置服务端。 表1 服务端参数说明 区域 参数 说明 取值样例 基本信息 本端网段 客户端需要访问的目标网段。 支持“选择子网”和“输入网段”两种方式。 192.168.1.0/24 客户端网段 分配给客户端虚拟网卡地址的网段。 172.16.0.0/16 认证信息 服务端证书 选择服务端证书。 cert-scsxxxxxxxxxxxxx 客户端CA证书 需要先单击“上传CA证书”进行上传操作。 如果存在多级CA证书，需要将证书链的所有CA证书都上传。 ca-cert-xxxx 高级配置 协议 保持默认。 UDP 端口 保持默认。 443 加密算法 保持默认 AES-128-GCM

数据规划 表1 规划数据 类别 规划项 规划值 VPC 待互通子网 192.168.0.0/16 VPN网关 互联子网 用于VPN网关和VPC通信，请确保选择的互联子网存在3个及以上可分配的IP地址。 192.168.2.0/24 EIP地址 EIP地址在购买EIP时由系统自动生成 本示例假设EIP地址生成如下：11.xx.xx.11 服务端 本端网段 192.168.1.0/24 服务端证书 cert-scsxxxxxxxxxxxxx（使用 云证书管理服务 托管的服务端证书名称） SSL参数 协议：UDP 端口：443 加密算法：AES-128-GCM 认证算法：SHA256 是否压缩：否 客户端 客户端网段 172.16.0.0/16 客户端CA证书 ca-cert-xxxx（上传CA证书时自定义证书名称）

操作流程 通过VPN实现客户端远程接入VPC的操作流程如图1所示。 图1 操作流程 表2 操作流程说明 序号 步骤 说明 1 步骤1：创建VPN网关 VPN网关需要绑定EIP作为出口公网IP。 如果您已经购买EIP，则此处可以直接绑定使用。 2 步骤2：配置服务端 指定客户端需要访问的网段（本端网段）和客户端访问时使用的网段（客户端网段）。 选择服务端证书和客户端CA证书，用于建立VPN连接时的身份认证。 配置VPN连接的SSL参数（协议、端口、认证算法、加密算法等）。 3 步骤3：配置客户端 从控制台下载客户端配置，对配置文件进行修改后导入对应的VPN客户端软件。 4 步骤4：验证连通性 打开客户端设备的命令行窗口，执行ping命令，验证连通性。

安装客户端软件并导入配置文件 本示例为您介绍如何配置Windows客户端，不同类型VPN客户端软件及版本可能存在差异，配置时请以实际为准。 操作系统：Windows 10 客户端软件：OpenVPN Connect 3.3.4（2600） 更多客户端配置案例，请参见配置客户端。 在OpenVPN官方网站下载OpenVPN Connect，根据界面提示进行安装。 启动OpenVPN Connect客户端，在“FILE”页签下单击“BROWSE”，上传客户端配置文件。 图1 上传配置文件 单击“CONNECT”尝试建立VPN连接，若出现类似下图所示界面，代表连接成功。 图2 连接成功

符号库转换支持的文件类型 表1 格式转换支持的文件类型 支持的转换类型 支持的文件类型 Altium Designer符号库 仅支持的上传文件类型为.SchLib后缀的文件进行转换。 仅支持单次上传的符号库文件数量不超过10个，单次转换任务文件总大小不超过15MB，且压缩前的文件总大小不超过100MB。 OrCAD符号库 仅支持的上传文件类型为xml的文件进行转换。 仅支持单次上传文件数量不超过10个，单次转换任务文件总大小不超过15MB，且压缩前的文件总大小不超过100MB。 支持转换的OrCAD符号文件名称仅支持中文、大小写英文字母、数字、空格、中划线（-）、下划线（_）和英文句号（.）的组合。 父主题： 符号库转换

工程转换支持的文件类型 表1 工程转换支持的文件类型 支持的转换类型 支持的文件类型 Altium Designer原理图工程 仅支持转换单board类型的原理图工程。 仅支持.zip类型的压缩文件转换，单次转换支持的压缩文件总数量不超过10个，单次转换支持的压缩文件总大小不超过15MB，且压缩前的文件总大小不超过100MB。 转换的原理图工程压缩文件中必须包含 .PrjPcb和.SchDoc两种后缀的文件，否则会导致转换失败。 图1 Altium Designer格式转换压缩包内文件要求 OrCAD原理图工程 仅支持转换单board类型的原理图工程。 仅支持上传文件类型为xml的文件进行转换，支持单次上传文件数量不超过10个，单次转换任务文件总大小不超过15MB。 支持转换的OrCAD原理图工程文件名称仅支持中文、大小写英文字母、数字、空格、中划线（-）、下划线（_）和英文句号（.）的组合。 父主题： 工程转换

操作步骤 登录pEDA-Schematic并进入主页。 在“主页”中的“服务”区域，单击“原理图格式转换”。 图1 原理图格式转换入口 在“原理图格式转换”页面，选择“符号库转换”页签。 在“符号库转换”页面，“原文件格式”选择“OrCAD(.xml)”，“目标文件格式”选择“pEDA符号库(.zip)”。 图2 选择转换格式 单击“添加文件”，添加本地需要转换的OrCAD符号库文件，可同时选择并添加多个文件。 若需要删除已上传的待转换文件，可单击文件列表后的，单个删除文件。也可单击“添加文件”后的清空文件列表。 待转换的OrCAD符号库文件名称仅支持中文、大小写英文字母、数字、空格、中划线（-）、下划线（_）和英文句号（.）的组合。 图3 待转换文件管理 单击“开始转换”，系统自动开始转换文件。转换完成后，文件列表可查看转换结果。 文件列表的文件名称显示为绿色，则表示文件转换成功。 文件列表的文件名称显示为红色，则表示文件转换失败。鼠标悬浮在转换失败文件所在的行，提示转换失败的原因。 图4 格式转换结果 单击“下载转换文件”，下载转换后的文件到本地。 下载到本地的转换文件，需要解压得到符号库的json文件后才能导入pEDA-Schematic。

操作步骤 在pEDA-Schematic建立协同连接后，切换至Allegro版图设计软件，界面显示同步控制窗口， 如图1所示。 图1 同步控制窗口 单击“启动”可进入同步模式， 同时“启动”按钮置灰，“暂停”按钮可用， 如图2所示。 图2 开启同步控制窗口 同步模式下，Find过滤器被设置为支持的三种对象类型Comps、Symbols和Nets，且默认全选，可根据需要对这三种类型进行勾选。 图3 设置Find过滤器对象类型 在Allegro版图设计软件画布中，选中单个器件或网络，如图4所示。 图4 Allegro版图设计中选中对象 pEDA-Schematic画布中高亮显示在Allegro版图设计软件中选中的器件和网络。 图5 pEDA-Schematic器件协同 协同操作完成后，可暂停同步模式或断开协同连接。 在Allegro版图设计软件的“协同”弹窗中，单击“暂停”可暂停同步模式回到正常编辑模式。 在Allegro版图设计软件的“协同”弹窗中，单击“Unlink”可断开协同连接。 图6 暂停和断开连接

操作步骤 登录pEDA-Schematic并进入主页。 在“主页”中的“服务”区域，单击“原理图格式转换”。 图1 原理图格式转换入口 在“原理图格式转换”页面，选择“工程转换”页签。 在“工程转换”页面，“原文件格式”选择“OrCAD(.xml)”，“目标文件格式”选择“pEDA原理图工程(.zip)”。 图2 选择转换格式 单击“添加文件”，添加本地需要转换的OrCAD原理图工程文件，可同时选择并添加多个文件。 若需要删除已上传的待转换文件，可单击文件列表后的，单个删除文件。也可单击“添加文件”后的清空文件列表。 待转换的OrCAD原理图工程文件名称仅支持中文、大小写英文字母、数字、空格、中划线（-）、下划线（_）和英文句号（.）的组合。 图3 待转换文件管理 单击“开始转换”，系统自动开始转换文件。转换完成后，文件列表可查看转换结果。 文件列表的文件名称显示为绿色，则表示文件转换成功。 文件列表的文件名称显示为红色，则表示文件转换失败。鼠标悬浮在转换失败文件所在的行，提示转换失败的原因。 图4 格式转换结果 单击“下载转换文件”，下载转换后的文件到本地。 下载到本地的转换文件，需要解压得到工程的zip压缩包后才能导入pEDA-Schematic。

准备工作 已注册华为云帐号，且在使用华为HiLens前检查帐号状态，帐号不能处于欠费或冻结状态。 已购买HiLens Kit设备，并准备好网线，电脑，路由器，HDMI线，显示屏。 成功注册设备HiLens Kit设备至华为HiLens控制台，详情请参见注册HiLens Kit。 登录OBS服务，创建桶和文件夹，用于存放样例的训练数据。创建名称为“mask”OBS桶，区域选择“华北-北京四”，创建如下文件夹： “dataset-in”：用于存放训练模型的数据。 “model-output”：用于存放模型输出数据。 “log”：用于存放日志。 创建OBS桶和文件夹的操作指导请参见创建桶和新建文件夹。为保证模型数据能正常访问，请务必保证创建的OBS桶与华为HiLens在同一区域。 占用OBS资源的操作均会收取一定费用，收费规则请参见 对象存储服务 OBS。

配置软件防火墙 网线连接电脑和设备，使用SSH登录HiLens Kit设备，详细操作指导请参见连接PC和HiLens Kit。 在PuTTY里执行命令 iptables -I INPUT -p tcp --dport 443 -j DROP 禁止所有用户通过443端口，访问HiLens Kit智能边缘系统。 根据自身所需，配置允许通过443端口访问HiLens Kit智能边缘系统的IP地址。 配置HiLens Kit设备IP访问HiLens Kit智能边缘系统，以设备IP是192.168.2.111为例，在PuTTY里执行命令 iptables -I INPUT -s 192.168.2.111 -p tcp --dport 443 -j ACCEPT 配置单个IP地址访问HiLens Kit智能边缘系统，以允许访问的IP地址是10.61.120.127为例，在PuTTY里执行命令 iptables -I INPUT -s 10.61.120.127 -p tcp --dport 443 -j ACCEPT 配置某一网段IP访问HiLens Kit智能边缘系统，以网段IP地址是10.61.120.*（*为0-255中任意整数）为例，在PuTTY里执行命令 iptables -I INPUT -s 10.61.120.0/24 -p tcp --dport 443 -j ACCEPT 在PuTTY里进入目录/home/data/user，将步骤2和步骤3的配置命令写入user_init.sh文件，防止重启HiLens Kit设备后步骤2和步骤3的配置失效。 如果目录/home/data/user下没有user_init.sh文件，请重新创建user_init.sh文件。

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

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

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

摄像头部署 客流统计算法根据头肩检测统计客流的大小。摄像头的架设会影响头肩检测模型的准确率。在实际架设中，尽量保证拍摄画面清晰，光照充足，人形较正，无遮挡。监控视频场景下尽量保证拍摄的画面能拍到更多的人形。 摄像头参数基本设置 不同品牌的摄像头都有一些基本的视频设置，例如分辨率、帧率和码率等，具体要求如下： 分辨率：建议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 }] }

运行时配置参数 技能在运行时，需要添加运行时配置。配置完成后，参数会从华为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 默认读取的视频文件。