概述

Display Manager (DisplayMgr) 提供了对设备上某些显示屏幕功能的控制。

主要功能

  • 启用/禁用：
    • 屏幕截图使用
    • 保持唤醒模式
    • 屏幕消隐
  • 设置显示屏幕超时间隔
  • 设置屏幕消隐信号端口
  • 设置屏幕消隐信号极性
  • 设置屏幕消隐信号去抖动延迟

屏幕截图启用/禁用

控制设备是否可以使用 Android 的内置屏幕捕获功能，它将捕获屏幕的内容并将其保存到设备上的文件。

注意：捕获屏幕的方法通常涉及到同时按下按键组合，具体因设备而异。

参数名称：ScreenShotUsage

选项 名称 说明需要
0 无操作 此值（或 XML 中缺少此参数）导致不会更改当前行为；任何以前选择的设置都将保留。

OSX：仅限 3.6、4.5

不适用于 OSX：4.0 - 4.4

MX：5.0+
1 启用 允许使用 Android 屏幕捕获功能。

OSX：仅限 3.6、4.5

不适用于 OSX：4.0 - 4.4

MX：5.0+
2 禁用 禁止使用 Android 屏幕捕获功能。

OSX：仅限 3.6、4.5

不适用于 OSX：4.0 - 4.4

MX：5.0+

保持唤醒启用/禁用

控制设备是否根据其外部电源连接进入挂起（睡眠）模式。否则，设备将根据 Android“设置”面板的“开发人员选项”部分中的设置进行操作。注意：Zebra VC80x 车载数据终端在默认情况下已启用此功能。.

参数名称：保持唤醒

选项 名称 说明需要
0 无操作 此值（或 XML 中缺少此参数）导致不会更改当前行为；任何以前选择的设置都将保留。

MX：7.2+

Android API：17+
1 启用 阻止设备在连接到外部电源时进入挂起（睡眠）模式。

MX：7.2+

Android API：17+
2 禁用 允许设备进入挂起（睡眠）模式，与是否连接到外部电源无关。

MX：7.2+

Android API：17+

设置屏幕超时间隔

用于设置设备在不活动（没有触摸屏幕或按下按键）期间等待的时间长度，此时间过后便会关闭屏幕以节约电量。理想情况下，此时间间隔应该在节约电池电量和用户使用方便之间达到平衡。

注意：Android 仅支持在下表中所示的显示屏幕超时设置。如果指定的值在任意两个受支持的值之间，则会将设置更改为最接近的那个支持值。如果指定的值超过所示的最小值或最大值，则会导致在结果 XML 文档中返回错误，并且设置更改被忽略。

参数名称：TimeoutInterval

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）导致不会更改当前显示屏幕超时间隔；任何以前选择的设置都将保留。

MX：4.3+

Android API：1+
15 显示超时后 15 秒 导致显示屏幕在设备用户不活动 15 秒后超时。

MX：4.3+

Android API：1+
30 显示超时后 30 秒 导致显示屏幕在设备用户不活动 30 秒后超时。

MX：4.3+

Android API：1+
60 显示超时后 1 分钟 导致显示屏幕在设备用户不活动 1 分钟后超时。

MX：4.3+

Android API：1+
120 显示超时后 2 分钟 导致显示屏幕在设备用户不活动 2 分钟后超时。

MX：4.3+

Android API：1+
300 显示超时后 5 分钟 导致显示屏幕在设备用户不活动 5 分钟后超时。

MX：4.3+

Android API：1+
600 显示超时后 10 分钟 导致显示屏幕在设备用户不活动 10 分钟后超时。

MX：4.3+

Android API：1+
1800 显示超时后 30 分钟 导致显示屏幕在设备用户不活动 30 分钟后超时。

MX：4.3+

Android API：1+

屏幕消隐启用/禁用

控制设备显示屏在通过“屏幕消隐信号”参数中设置的信号触发时是否能够消隐。消隐屏幕将阻止与设备及其应用程序之间的所有用户交互。

此功能是为了安全原因而开发，旨在用于行驶车辆中安装的车载数据终端。例如，可以通过连接到车辆油门的电子信号来激活该功能。有关连接 Zebra 设备到车辆线路的更多信息，请参阅设备附带的集成商指南。

参数名称：ScreenBlanking

选项 名称 说明需要
0 无操作 此值（或 XML 中缺少此参数）导致不会更改当前行为；任何以前选择的设置都将保留。

MX：7.1+
1 从不消隐 阻止消隐屏幕。

MX：7.1+
2 通过信号触发 使屏幕能够在设备外接信号触发时消隐。

MX：7.1+

设置屏幕消隐信号

用于指定哪些外部信号将控制屏幕消隐（如果已启用）。输入 1 和 2 与 Zebra VC80x 车载数据终端上的串行端口 1 和 2 对应。其他设备可能有所不同。串行端口可用于确定是否踩下了车辆油门踏板。有关连接 Zebra 设备到车辆线路的更多信息，请参阅设备附带的集成商指南。

参数名称：ScreenBlankingSignal

选项 名称 说明需要
1 输入 1 将屏幕消隐信号设置为输入 1（VC80x 串行端口 1）。

MX：7.1+
2 输入 2 将屏幕消隐信号设置为输入 2（VC80x 串行端口 2）。

MX：7.1+

设置消隐信号极性

控制当“屏幕消隐信号”参数中指定的信号出现或消失时是否消隐屏幕。

参数名称：ScreenBlankingSignalPolarity

选项 名称 说明需要
1 在车辆活动（开）时消隐屏幕 将屏幕设置为在出现信号时消隐。

MX：7.1+
2 在车辆不活动（关）时消隐屏幕 将屏幕设置为在信号不存在时消隐。

MX：7.1+

设置消隐去抖动延迟

用于指定在检测到信号变化后、在消隐或取消消隐屏幕之前的延迟（以毫秒为单位）。默认值为 1000 毫秒（1 秒）。

参数值输入规则：

  • 接受 250 到 32767 之间的整数
  • 如果未输入值，将使用默认值 1000

参数名称：ScreenBlankingDebounceDelay

需要：

  • MX：7.1+

示例

打开屏幕消隐

以下示例打开屏幕消隐功能，选择 Zebra VC80x 车载数据终端上的串行端口 1 作为使用标准极性接线的信号端口，并且设置 2 秒（2000 毫秒）的延迟。

<wap-provisioningdoc><characteristic type="DisplayMgr"><parm name="ScreenBlanking" value="2" /><characteristic type="screen-blanking-details"><parm name="ScreenBlankingSignal" value="1" /><parm name="ScreenBlankingPolarity" value="1" /><parm name="ScreenBlankingDebounceDelay" value="2000" /></characteristic></characteristic></wap-provisioningdoc>

关闭屏幕消隐

<wap-provisioningdoc><characteristic type="DisplayMgr"><parm name="ScreenBlanking" value="1" /></characteristic></wap-provisioningdoc>

关闭保持唤醒功能

<wap-provisioningdoc> ​<characteristic type="DisplayMgr"> ​​<parm name="StayAwake" value="2" /> ​</characteristic></wap-provisioningdoc>