为实现用户操作的标准化，必须进行以下定义。Vision App Control 应设计为类似 DMX、CRMX 或 ArtNet 的输入源。

输入源名称：VISION APP。如果字符空间不足，可以使用 VC APP。

VISION APP 的菜单结构包含一个 action、一个 optional setting 以及一组 read-only information items。下表列出了应向用户展示的所有条目：

Level 1 一级菜单	Level 2 二级菜单	Level 3 三级菜单	Type 类型	Description 描述
VISION APP	Unlink 解除链接		Action 操作	将灯具从网络中解除链接，需要用户确认。
	App Visibility 应用可见性	Vision Active* Vision 活动*	Setting (optional) 设置（可选）	Vision 被选为输入源。
		Input Inactive 输入非活动时		当没有其他活跃的输入源时，Vision 变为活动状态。
		Always 始终		Vision 始终处于活动状态。
	Information 信息	State 状态	Information (read-only) 信息（只读）	当前链接状态：Unlinked / Linked / Active / Master / Inactive。
		Network Name 网络名称		灯具所链接到的网络名称。
		Signal Quality 信号质量		信号质量百分比（0 - 100）。
		UUID		灯具的唯一标识符。

注：App Visibility 设置为 optional。如果未实现该设置，灯具的行为应如同选择了 "Vision Active" 一样。

与 Vision 相关的灯具设置（电池）

以下灯具设置是 optional，但建议实现，因为它们会被 Vision Control app 显示和使用。如果实现了这些设置，则应能从常规灯具菜单中访问到它们，通常位于 General Settings 和 Fixture Brightness 下。

Setting 设置	Options 选项	Type 类型	Description 描述
AC Emergency 交流应急模式	OFF* / ON	Setting (optional) 设置（可选）	定义交流应急情况下灯具的行为。Vision app 仅将此设置切换为 On / Off。
Battery Runtime 电池续航时间	OFF* Remaining Time: xx 关闭* 剩余时间：xx	Setting (optional) 设置（可选）	电池续航时间限制已禁用。
	Full battery: 2 h Remaining Time: xx 电池满电：2 小时 剩余时间：xx		目标续航时间 2 小时。
	Full battery: 4 h Remaining Time: xx ... Full battery: 22 h Remaining Time: xx 电池满电：4 小时 剩余时间：xx ... 电池满电：22 小时 剩余时间：xx		目标续航时间以 2 小时为步长可选。
	Full battery: 24 h Remaining Time: xx 电池满电：24 小时 剩余时间：xx		最大目标续航时间。

完整菜单示例

以下示例展示了如何将 VISION APP 菜单条目嵌入完整的灯具菜单中，并与常规灯具设置放在一起。默认值用 "*" 标记。

Level 1 一级菜单	Level 2 二级菜单	Level 3 三级菜单	Level 4 四级菜单	Description / Default 描述 / 默认值
DMX Settings	DMX Address	1 - 512		Default: 1。
	DMX Mode	RGB / RGBL / ...		Default: RGB。
Input Source 输入源	Wired DMX 有线 DMX			有线 DMX 输入。
	CRMX 无线 CRMX			无线 CRMX 输入。
	Vision App			Vision App 输入。在此模式下确保 CRMX 处于关闭状态。
	Auto 自动			自动选择输入源。
	Slave 从机			从机输入。
Input Settings 输入设置	Vision App	Unlink 解除链接	Yes / No	操作 - 将灯具从网络中解除链接。
		Visibility (optional) 可见性（可选）	Vision Active* / Input Inactive / Always	Default: Vision Active。
		Information 信息	State / Network Name 状态 / 网络名称	Read-only。 只读。
			Signal Quality / UUID 信号质量 / UUID	Read-only。 只读。
	CRMX	Unlink 解除链接	Yes / No*	解除 CRMX 网络链接。
Dimmer Settings 调光器设置	Dimmer Curve 调光曲线	Linear / Square / Square Inv / S-Curve* 线性 / 平方 / 平方反比 / S 曲线*		Default: S-Curve。 默认值：S 曲线。
	Dimmer Response 调光响应	Off* / Slow / Middle / Fast / Very Fast 关闭* / 慢 / 中 / 快 / 非常快		Default: Off。 默认值：关闭。
Fixture Settings 灯具设置	AC Emergency 交流应急模式	OFF* / Hold / Blackout / White / Color Macro 关闭* / 保持 / 黑场 / 白光 / 色彩宏		交流应急情况下的行为。Vision App 仅将此设置切换为 On / Off。
	Master Output 主控输出	Off* / On 关闭* / 开启		启用后，灯具可将自身的独立运行/控制数据输出或转发给从机灯具。
	Battery Runtime 电池续航时间	OFF* Remaining Time: xx 关闭* 剩余时间：xx		电池续航时间限制已禁用。
		Full battery: 2 h Remaining Time: xx 电池满电：2 小时 剩余时间：xx		目标续航时间 2 小时。
		Full battery: 4 h Remaining Time: xx ... Full battery: 22 h Remaining Time: xx 电池满电：4 小时 剩余时间：xx ... 电池满电：22 小时 剩余时间：xx		目标续航时间以 2 小时为步长可选。
		Full battery: 24 h Remaining Time: xx 电池满电：24 小时 剩余时间：xx		最大目标续航时间。
	DMX Fail DMX 信号丢失	Hold* / Blackout 保持* / 黑场		DMX 信号丢失时的行为。
Factory Defaults 恢复出厂设置	Yes / No 是 / 否		将所有设置重置为出厂默认值。
Information 信息	Device Hours 设备运行小时数			Standard RDM counter (PID 0x0400)。灯具总运行时间。
	Lamp Hours 灯珠运行小时数			Standard RDM counter (PID 0x0401)。LED 总运行时间；Vision App 将其用作 LED 小时数。
	Device Power Cycles 设备上电次数			Standard RDM counter (PID 0x0405)。总上电次数。
	RDM ID			唯一的 RDM device identifier。
	Software Version 软件版本			灯具的 firmware / software version。
	Sensors 传感器			温度等传感器。

防盗锁屏

当灯具通过 Anti-Theft 功能锁定时，显示屏应清晰指示此状态，并告知用户如何解锁。推荐显示的信息为：

Anti-Theft is active: Use Vision Control app to unlock

中文含义：防盗已激活，请使用 Vision Control app 解锁。

对于字符空间有限的显示屏，可以使用以下简短版本：

Anti-Theft: Unlock via Vision Control

中文含义：防盗：通过 Vision Control 解锁。

如何获取这些信息？

Unlink（操作）：

使用 Vision SPI Library 时，该函数位于 libVisionSpiInterface.h，名称为 vision_triggerUnlink。该函数会将灯具从 Vision App 创建的网络中解除链接。

State（信息）

使用 Vision SPI Library 时，该函数位于 libVisionSpiInterface.h，名称为 vision_getStatusFlags。返回类型为 vision_status_flags_t。在该类型中可以找到所需的状态信息：vision_status_t。

Network Name（信息）

使用 Vision SPI Library 时，该函数位于 libVisionSpiInterface.h，名称为 vision_getInformation。返回类型为 vision_information_t，其中包含一个 12 字节长的网络名称。

Signal Quality（信息）

使用 Vision SPI Library 时，该函数位于 libVisionSpiInterface.h，名称为 vision_getInformation。返回类型为 vision_information_t，其中包含 signalQuality。0 - 100 表示百分比形式的信号质量。

UUID（信息）

使用 Vision SPI Library 时，该函数位于 libVisionSpiInterface.h，名称为 vision_getInformation。返回类型为 vision_information_t，其中包含 uuid。