为了给 user 提供 standardized implementation，需要定义一些 menu behavior。Vision App Control 应设计为一个 input source，类似 DMX、CRMX 或 ArtNet。

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

VISION APP menu 分为一个 action、一个 optional setting，以及一组 read-only information items。下表列出应向 user 显示的 entries：

Level 1	Level 2	Level 3	Type	Description
VISION APP	Unlink		Action	将 fixture 从 network unlink。需要 user confirm。
	App Visibility	Vision Active*	Setting (optional)	Vision 被选择为 Input Source。
		Input Inactive		当没有其他 active Input Source available 时，Vision 变为 active。
		Always		Vision 始终 active。
	Information	State	Information (read-only)	Current link state: Unlinked / Linked / Active / Master / Inactive。
		Network Name		Fixture linked 到的 network name。
		Signal Quality		Signal quality in % (0 - 100)。
		UUID		Fixture 的 unique identifier。

Note: App Visibility setting 是 optional。如果未实现，fixture 应按选择了 "Vision Active" 的方式 behavior。

Vision 相关 fixture settings（Battery）

以下 fixture settings 是 optional，但 recommended，因为它们会由 Vision Control app 显示和使用。如果实现，应可从 regular fixture menu 访问，通常位于 General Settings 和 Fixture Brightness 下。

Setting	Options	Type	Description
AC Emergency	OFF* / ON	Setting (optional)	定义 AC emergency 时的 fixture behaviour。Vision app 只会将该 setting On / Off。
Battery Runtime	OFF* Remaining Time: xx	Setting (optional)	Battery runtime limit disabled。
	Full battery: 2 h Remaining Time: xx		Target runtime 2 h。
	Full battery: 4 h Remaining Time: xx ... Full battery: 22 h Remaining Time: xx		Target runtime 可按 2 h steps 选择。
	Full battery: 24 h Remaining Time: xx		Maximum target runtime。

完整 menu 示例

以下 example 展示如何将 VISION APP entries 嵌入完整 fixture menu，并与 common fixture settings 放在一起。Default values 使用 "*" 标记。

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			Wired DMX input。
	CRMX			Wireless CRMX input。
	Vision App			在该 mode 中请确保 CRMX off。
	Master / Slave	Set as Master / Set as Slave		Default: Slave。
Input Settings	Vision App	Unlink	Yes / No	Action - 将 fixture 从 network unlink。
		Visibility (optional)	Vision Active* / Input Inactive / Always	Default: Vision Only。
		Information	State / Network Name	Read-only。
			Signal Quality / UUID	Read-only。
	CRMX	Unlink	Yes / No*	Unlinks CRMX network。
Dimmer Settings	Dimmer Curve	Linear / Square / Square Inv / S-Curve*		Default: S-Curve。
	Dimmer Response	Off* / Slow / Middle / Fast / Very Fast		Default: Off。
Fixture Settings	AC Emergency	OFF* / Hold / Blackout / White / Color Macro		AC emergency 时的 behaviour。Vision app 只会将该 setting On / Off。
	Battery Runtime	OFF* Remaining Time: xx		Battery runtime limit disabled。
		Full battery: 2 h Remaining Time: xx		Target runtime 2 h。
		Full battery: 4 h Remaining Time: xx ... Full battery: 22 h Remaining Time: xx		Target runtime 可按 2 h steps 选择。
		Full battery: 24 h Remaining Time: xx		Maximum target runtime。
	DMX Fail	Hold* / Blackout		DMX signal loss 时的 behaviour。
Factory Defaults	Yes / No		将所有 settings reset to factory defaults。
Information	Device Hours			Standard RDM counter (PID 0x0400)。Fixture total runtime。
	Lamp Hours			Standard RDM counter (PID 0x0401)。Total LED runtime；Vision app 将其用作 LED hours。
	Device Power Cycles			Standard RDM counter (PID 0x0405)。Total power cycles。
	RDM ID			Unique RDM device identifier。
	Software Version			Fixture firmware / software version。
	Sensors			Sensors like temperature。

Anti-theft lockscreen

当 fixture 通过 Anti-Theft feature locked 时，display 应清楚显示该 state，并告诉 user 如何 unlock。推荐 message：

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

对于字符空间有限的 displays，可以使用以下 short variant：

Anti-Theft: Unlock via Vision Control

如何获取这些信息？

Unlink (Action):

使用 Vision SPI Library 时，该 function 位于 libVisionSpiInterface.h，名称为 vision_unlinkVisionData。它会将 fixture 从 Vision App 创建的 network unlink。

State (Information)

使用 Vision SPI Library 时，该 function 位于 libVisionSpiInterface.h，名称为 vision_getStatusFlags。Return type 为 vision_status_flags_t。在该 type 中可以找到所需 information：vision_status_t。

Network Name (Information)

使用 Vision SPI Library 时，该 function 位于 libVisionSpiInterface.h，名称为 vision_getInformation。Return type 为 vision_information_t，其中包含 12 Bytes long network name。

Signal Quality (Information)

使用 Vision SPI Library 时，该 function 位于 libVisionSpiInterface.h，名称为 vision_getInformation。Return type 为 vision_information_t，其中包含 signalQuality。0 - 100 表示 Quality in %。

UUID (Information)

使用 Vision SPI Library 时，该 function 位于 libVisionSpiInterface.h，名称为 vision_getInformation。Return type 为 vision_information_t，其中包含 uuid。