文档首页/ 华为HiLens/ 常见问题/ HiLens Studio使用/ 使用HiLens Studio如何配置运行时配置?
更新时间:2022-08-18 GMT+08:00
分享

使用HiLens Studio如何配置运行时配置?

问题描述

部分技能在运行的时候,需要技能使用者配置相关参数的值,即运行时配置。比如一般人脸判断的技能都需要用户上传人脸库。

那么开发者在HiLens Studio开发技能时,如何对技能添加运行时配置的参数及其参数规格,供技能使用者在使用技能时配置运行时配置的值。

新建技能项目时添加运行时配置

首先新建技能项目,进入“创建技能”页面。

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

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

  2. 在HiLens Studio页面,单击“New Project”

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

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

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

    图1 创建技能
  4. “创建技能”页面填写技能的基本信息和配置运行时配置,详情请见新建技能项目

    其中,运行时配置参考表1填写。

    您还可以单击“预览JSON格式”查看JSON格式的运行时配置。开发者通过HiLens Framework提供的get_skill_config接口获取技能配置的JSON格式,读取里面字段的值来使用用户的配置。

    运行时配置JSON格式如下所示:
    {
            //全局配置
    	"Languge": "enum",
            //视频分路配置
    	"multi_camera": [ //该字段key值multi_camera固定,值表示摄像头分路配置
    		{       
    			"camera_names": [     //该字段key值camera_names固定,值表示该分组配置里包含了哪些摄像头
    				"cameraX",
    				"cameraY"
    			],
    			"FaceLib": {        //配置名
    				"from": "file source", //文件类型值,表示文件来自哪个服务。比如OBS
    				"path": "file path"  //文件类型值,表示文件的路径
    			}
    		}
    	],
           }
    图2 运行时配置
    表1 运行时配置的参数说明

    字段名称

    说明

    配置名

    配置的名称,逻辑代码里面可用该字段获取该配置的值。运行时配置指技能在运行的时候,由用户配置的内容。比如人脸判断技能需要用户上传人脸库等。需要说明的是,整个运行时配置是可选的,但如果添加了一条配置,那么“配置名”“配置说明”是必填项。

    值类型

    表示该配置项的值是什么类型的数据。

    数值类型(int、float)、枚举类型、字符串和文件类型。

    值约束

    表示该配置可以设置的范围。跟值类型有关。

    • 数值类型:用开闭区间的表示方法。如[1,100)表示大于等于1小于100。
    • 字符串和文件:该项无需输入。
    • 枚举:集合的表示方式,如{a,b}。

    配置说明

    说明该配置的作用,以及配置方法。该字段非常重要,用户会根据该字段的说明来配置,所以如果有运行时配置,开发者一定要在这里解释清楚。

    配置对象

    HiLens Kit可以连接多个(个数不大于设备上所安装技能的支持通道数之和)摄像头,所以可以开发支持多路视屏的技能。

    • 选择“视频”,则表示该配置是可以针对设备上每个摄像头视频进行配置的,比如摄像头1和摄像头2采用不同的人脸库。
    • 选择“全局”,则表示设备上所有摄像头都用同一个配置值。

相关文档