跳转至

增强现实教程#

Info

增强现实是一个单独许可的模块。

本文档将指导读者设置和使用增强现实功能。

概述#

增强现实是一种将信息叠加到对象上的机制,就像通过设备摄像头看到的那样,目的是可视化或交互。

Augmented reality overview

增强现实的作用是识别移动设备摄像头捕获的图像中的二维码,并在系统中查找与该二维码关联的对象的相应配置。二维码和对象的注册通过标签完成。

设置增强现实#

为了能够使用增强现实功能,必须按照下表中所述的步骤操作。

步骤 标题 描述
1 创建必要的UI页面 如果要在读取特定二维码时显示UI页面,则必须提前创建该UI页面。
2 创建增强现实标签 根据需要创建多个步骤以供不同流程使用。
3 创建必要的流程 在系统中创建必要的标签。

Table: 增强现实设置步骤

以下各小节将对各个步骤进行更详细的说明。

创建必要的UI页面#

增强现实中使用的UI页面是正常的UI页面,但增强现实模块会在识别对象时自动向UI页面提供一些参数。下面的表2列出了这些参数。

参数 数据类型 描述
Tag 字符串 已识别标签的ID。
EntityType 字符串 与已识别标签的ID关联的实体类型名称。
EntityInstance 对象 与已识别的标签关联的对象。

Table: 增强现实UI页面参数

下图显示了此类UI页面的示例:

UI Page parameter configuration

这些参数随后可以提供给任何UI页面小组件。在下图中,这三个参数被传递到“实体历史记录”小组件。对于EntityInstance,所用的换算器是anyToAnyProperty,没有任何换算器参数。

Linking the UI Page parameters with a Widget

创建增强现实标签#

增强现实标签是在“管理”>“增强现实”下创建的。有关如何创建增强现实标签的详细信息,请参阅《用户指南》。

Augmented Reality page in Administration

Augmented Reality page details

Info

目前,只能从0到511之间的范围生成标签。

Info

增强现实标签可以显示特定UI页面或标准UI页面。

Info

增强现实标签存储在通用表EntityTag中。

使用增强现实#

增强现实可以从制造 > 增强现实来评估。请注意,运行GUI的设备必须有摄像头,且允许GUI使用摄像头。

要使用增强现实,只需将摄像头对准预定义的二维码。当对象被识别时,系统将自动显示标准磁贴或预定义的UI页面。

下面的图显示了上面定义的示例,显示一个对象的历史记录。

Using Augmented Reality

Using Augmented Reality - Show History

将增强现实用作小组件#

增强现实也可用作小组件。在这种情况下,它会利用相同的增强现实配置。以下示例使用增强现实小组件为实体历史记录小组件提供源。

Using Augmented Reality as a Widget

在本例中,小组件与属性LastTagLastEntityTypeLastEntityInstance链接,如下图所示。

Linking the Augmented Reality widget parameters with another Widget

增强现实小组件提供了五个参数,如下表所述:

属性 数据类型 描述
entityTagFound 对象 提供对最近检测到的标签的访问,可通过上述增强现实UI页面参数表中所述的属性进行访问。
entityTagLost 对象 提供对已丢失(即从检测中移除)的最新标记的访问,可通过上述增强现实UI页面参数表中所述的属性进行访问。
LastTag 字符串 检测到的最后一个标签的ID。
LastEntityType 字符串 与最后检测到的标签的ID相关联的实体类型名称。
LastEntityInstance 对象 与检测到的最后一个标签相关联的对象。

Table: 增强现实小组件输出属性

entityTagLostentityTagFound对象具有增强现实UI页面参数表中显示的属性列表。可以使用anyToAnyProperty换算器访问这些属性,并提供属性的名称作为ConverterParameter。通常,ConverterParameters将是一个静态属性,就像UI页面一样。下图描述了这一过程。

属性 数据类型 描述
Tag 对标签(ID)名称的访问 对标签(ID)名称的访问
EntityType 对实体类型名称的访问 对实体类型名称的访问
EntityInstance 对实体实例的访问 对实体实例的访问

Table: entityTagFoundentityTagLost对象属性

Defining a converter

使用换算器访问*entityTagFound*属性