文档首页/ 华为HiLens/ 用户指南（基础版控制台）/ 开发环境HiLens Studio/ 新建技能项目
更新时间：2024-12-26 GMT+08:00
编辑
查看PDF
分享

新建技能项目

使用HiLens Studio 新建技能项目，将技能文件组织起来以便进行编译和调试，最终开发一个新的技能。

前提条件

  • 保证华为云账号处于不欠费状态。在华为HiLens控制台开发技能时，会占用OBS资源，需要收取一定费用，收费规则请参见对象存储服务 OBS。
  • 已订购HiLens Studio版本。
  • 新建技能使用的算法模型已开发完成并导入HiLens中。

当前技能市场购买的技能暂不支持在HiLens Studio中打开，您可以选择在HiLens Studio中选择技能模板新建技能项目，详情请见新建技能项目。

1. 开始新建项目

  1. 登录华为HiLens管理控制台，在左侧导航栏中选择“技能开发>HiLens Studio”。

    等待大概30秒，进入HiLens Studio 页面。

  2. 在HiLens Studio页面，单击“File>New Project”。

    弹出“选择模板创建HiLens Studio项目”对话框。

  3. 在“选择模板创建HiLens Studio项目”对话框，选择您想要使用的技能模板，然后单击“新建技能”。

    页面自动跳至“创建技能”页面，您选择的模板默认配置将自动加载，您可以在创建技能页面右侧查看到相关信息。

    图1 创建技能-25

2. 填写基本信息

选择已有技能模板后，页面已自动加载技能模板的默认参数配置，如表1所示。您必须填写“技能名称”、“技能版本”参数。

表1 基本信息

字段名称

说明

技能模板

是否使用模板来开发技能。使用HiLens Studio新建技能默认选择已有模板，则会使用模板的模型和代码。即技能内容模块的字段都会使用模板的信息。

已选择模板

选择的技能模板名称。

技能名称

技能的名称，下发到端侧也使用该名称作为根目录。

技能名称不能与“已选择模板”，即已选择的技能模板名称一致。

可输入字母、数字、下划线或中划线，必须以字母开头，以字母或数字结尾，长度3~48个字符。

说明：

由于技能市场不允许存在同名技能，所以如果想发布到技能市场，请使用全局唯一的名称对您的技能进行命名。

技能版本

技能的版本。版本号格式为“A.A.A”，“A”为不超过3位的自然数。例如“1.0.0”。

当“A”超过一位时，不允许以“0”开头，比如禁止输入“01.0.0”。

适用芯片

技能支持的芯片。运行在HiLens Kit上的技能需选择Ascend 310芯片。

检验值

用于技能校验，防止技能伪冒。要与代码中初始化接口的参数一致。具体使用方法请参见开发指南>初始化HiLens Framework。

应用场景

技能适用的场景，例如“园区”、“家庭”、“车载”、“商超”等场景及其子场景。如果选项中没有合适的场景，可选择“其他”，然后在文本框中填写场景名称。

技能图标

技能的头像。

OS平台

技能运行的操作系统平台，包括Linux、Android、IOS、LiteOS和Windows。HiLens Kit用的是基于CentOS制作的Linux发行版Euler系统操作系统，所以如果开发的是运行在HiLens Kit的技能，这里选择Linux。

描述

对技能的详细介绍。输入最大长度2048。

说明：

若新建技能的场景需要发送消息到用户的手机或邮箱，比如检测到陌生人技能需要在发现陌生人后发送消息提醒用户，描述中必须注明：“本技能支持发送订阅消息”，发送的具体内容需在使用手机实时视频流编写/调试代码时注明，详细指导和API介绍可参见开发指南。

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采用不同的人脸库。
  • 选择“全局”,则表示设备上所有摄像头都用同一个配置值。

4. 确认信息进入HiLens Studio

确认信息无误后，单击“确定”，进入启动HiLens Studio的界面。

必要信息填写完成后，您可以在界面右侧查看其配置参数值，如果某个字段填写错误，在右侧会显示一个小红叉。

图3 确认信息
  • 确认信息后请务必进入HiLens Studio界面查看所创建的技能项目，否则会创建空项目，造成后续无法在HiLens Studio界面打开技能项目文件。
  • 如果打不开HiLens Studio界面，请检查浏览器是否设置阻止弹出式窗口。如果浏览器设置了阻止弹出式窗口，请添加HiLens Studio网址为允许浏览器弹窗的白名单地址。

相关文档