使用HiLens Studio如何配置运行时配置?
问题描述
部分技能在运行的时候,需要技能使用者配置相关参数的值,即运行时配置。比如一般人脸判断的技能都需要用户上传人脸库。
那么开发者在HiLens Studio开发技能时,如何对技能添加运行时配置的参数及其参数规格,供技能使用者在使用技能时配置运行时配置的值。
新建技能项目时添加运行时配置
首先新建技能项目,进入“创建技能”页面。
- 登录华为HiLens管理控制台,在左侧导航栏中选择“技能开发>HiLensStudio”。
等待大概30秒,进入HiLens Studio 页面。
- 在HiLens Studio页面,单击“New Project”。
弹出“选择模板创建HiLens Studio项目”对话框。
- 在“选择模板创建HiLens Studio项目”对话框,选择您想要使用的技能模板,然后单击“新建技能”。
页面自动跳至“创建技能”页面,您选择的模板默认配置将自动加载,您可以在创建技能页面右侧查看到相关信息。
图1 创建技能
- 在“创建技能”页面填写技能的基本信息和配置运行时配置,详情请见新建技能项目。
其中,运行时配置参考表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采用不同的人脸库。
- 选择“全局”,则表示设备上所有摄像头都用同一个配置值。