更新时间:2024-04-03 GMT+08:00
分享

新建技能项目

使用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网址为允许浏览器弹窗的白名单地址。
分享:

    相关文档

    相关产品