Camera Manager

注意：要仅显示特定设备上存在的功能，请从下面的 SmartDocs 栏中选择一个或多个过滤器。

StageNow - 2.10

概述

CameraMgr 控制对设备上的摄像头以及能够拍摄图像的其他机制的访问。许多 Zebra Android 产品都配备有可用于拍摄图片、扫描条码或者以别的方式采集或获取数据、文档和图像的设备。对于安全环境，可使用 CameraMgr 限制拍照和文档采集，消除了有摄像头及无摄像头的设备所带来的潜在风险。

重要说明：设备上可用于拍摄照片或以别的方式采集图像的任何机制都被 CameraMgr 视为摄像头。例如，如果设备配有一个基于 CCD 的成像器，它的主要用途是扫描条码，但也支持一些拍照手段，该成像器的拍照功能可通过 UseAllCameras (enable/disable) 参数来禁用。如果条码扫描不会暴露拍照的能力，条码扫描功能将保持正常。如果此类设备只提供扫描条码的能力，则不会将它视为摄像头，因为它给图像安全带来的风险很小。

注意：

  • 在运行 Android L 或更高版本的设备上为使用无摄像头的设备拍照提供了有限支持。
  • 在以后的 Android 版本中可能会为使用无摄像头的设备拍照提供更多的支持。
  • 如果条码扫描会直接或间接暴露拍照的能力，阻止某些或所有摄像头也可能禁止通过这些摄像头进行的条码扫描。
  • 阻止某些或所有摄像头也可能禁止通过这些摄像头使用 SimulScan，因为 SimulScan 的部分或所有功能可能依赖或暴露拍照的能力。
  • 阻止 Android L 设备上的成像器将禁用 SimulScan。

主要功能

  • 启用/禁用所有摄像头和图像采集设备
  • 启用/禁用前置摄像头
  • 启用/禁用后置摄像头
  • 启用/禁用扫描头
  • 报告哪些摄像头和图像采集设备已启用/已禁用

所有摄像头启用/禁用

用于启用或禁用所有摄像头以及设备上被分类为摄像头的其他机制。使用此参数“禁用所有摄像头”将阻止设备通过任何方式拍照，即使设备上有某个应用程序要拍照。注意：在某些设备上，禁用所有摄像头还可能会禁用 SimulScan 应用程序和/或扫描器，以及未明确作为摄像头列出和/或未打算用于拍照用途的设备。

在运行 Android L 或更高版本的设备上为使用无摄像头的设备拍照提供了有限支持。

重要说明：此参数可控制设备上被 CameraMgr 分类为摄像头的所有机制，即使设备的摄像头数量超出了使用各个 CameraMgr 参数可控制的数量。例如，如果某个设备配备了前置和后置摄像头以及一个可以采集文档的侧向成像器，所有这三个设备均分类为摄像头，因此可使用此参数一起启用或禁用。在此情况下，如果不先启用所有三个“摄像头”，然后使用各自的参数禁用前置摄像头和后置摄像头，将无法单独控制侧向成像器。

同样值得注意的是，启用或禁用所有摄像头可能覆盖先前由单个摄像头应用程序发出的此类命令，或者也可能对于个别摄像头被使用 CameraMgr 的其他应用程序之后发出的命令覆盖。

CameraMgr 先前启用或禁用的摄像头和其他成像设备将保持在该状态，直到明确收到命令执行别的操作。

参数名称：UseAllCameras

选项 名称 说明需要
0 控制各个摄像头 此值（或 XML 中缺少此参数）导致不会更改设备的任何摄像头是否被个别启用还是禁用，以及是否能通过随后来自另一个参数的命令启用或禁用。此处的零值或空值将允许前置摄像头和后置摄像头分别通过各自的参数进行控制。CameraMgr 先前启用或禁用的摄像头和其他成像设备将保持在该状态，直到明确收到命令执行别的操作。

OSX：3.5+

MX：4.3+
1 启用所有摄像头 启用所有摄像头以及分类为摄像头的设备，允许任何摄像头拍照或以其他方式采集文档或图像（如果设备上存在执行此操作的应用程序）。

OSX：3.5+

MX：4.3+
2 禁用所有摄像头 禁用所有摄像机和分类为摄像头的设备，阻止设备拍摄照片或以其他方式采集文档或图像，即使在设备上存在执行此操作的应用程序。

OSX：3.5+

MX：4.3+

前置摄像头启用/禁用

控件对设备上前置摄像头的使用。如果设备没有配备前置摄像头，使用此参数将在结果 XML 文档中返回一个错误。

在以下条件下显示：“使用所有摄像头”设置为“控制各个摄像头”

参数名称：UseFrontCamera

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）导致不会更改是否能在设备上使用前置摄像头；任何以前选择的设置都将保留。

OSX：3.5+

MX：4.3+
1 启用 启用设备上的前置摄像头，允许该摄像头拍照或以其他方式采集文档或图像（如果设备上存在执行此操作的应用程序）。

OSX：3.5+

MX：4.3+
2 禁用 禁用设备上的前置摄像头，阻止设备拍照或以其他方式采集文档或图像，即使在设备上存在执行此操作的应用程序。

OSX：3.5+

MX：4.3+

后置摄像头启用/禁用

控制对设备上后置摄像头的使用。如果设备没有配备后置摄像头，使用此参数将在结果 XML 文档中返回一个错误。

在以下条件下显示：“使用所有摄像头”设置为“控制各个摄像头”

参数名称：UseRearCamera

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）导致不会更改是否能在设备上使用后置摄像头；任何以前选择的设置都将保留。

OSX：3.5+

MX：4.3+
1 启用 启用设备上的后置摄像头，允许该摄像头拍照或以其他方式采集文档或图像（如果设备上存在执行此操作的应用程序）。

OSX：3.5+

MX：4.3+
2 禁用 禁用设备上的后置摄像头，阻止设备拍照或以其他方式采集文档或图像，即使在设备上存在执行此操作的应用程序。

OSX：3.5+

MX：4.3+

扫描头启用/禁用

控制设备上的成像器（如果配备）是否可用于拍照。如果设备没有配备成像器或没有使用成像器拍照的能力，使用此参数将在结果 XML 文档中返回一个错误。

注意：

  • 在运行 Android L 或更高版本的设备上为使用无摄像头的设备拍照提供了有限支持。
  • 阻止 Android L 设备上的成像器将禁用 SimulScan。

在以下条件下显示：“使用所有摄像头”设置为“控制各个摄像头”

参数名称：UseImagerCamera

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）导致不会更改是否能使用设备的成像器拍照；任何以前选择的设置都将保留。

OSX：5.0+

MX：6.0+
1 启用 控制设备上的成像器（如果配备）是否可用于拍照。

OSX：5.0+

MX：6.0+
2 禁用 禁止使用设备上的成像器（如已配备）拍照。这将允许继续使用扫描功能，同时阻止成像器拍照，即使设备上存在执行此操作的应用程序。

OSX：5.0+

MX：6.0+

示例

启用所有摄像头：

<wap-provisioningdoc><characteristic type="CameraMgr" version="4.3" ><parm name="UseAllCameras" value="1"/></characteristic></wap-provisioningdoc>


禁用所有摄像头：

<wap-provisioningdoc><characteristic type="CameraMgr" version="4.3" ><parm name="UseAllCameras" value="2"/></characteristic></wap-provisioningdoc>


启用前置摄像头：

<wap-provisioningdoc><characteristic type="CameraMgr" version="4.3" ><parm name="UseFrontCamera" value="1"/></characteristic></wap-provisioningdoc>


禁用后置摄像头：

<wap-provisioningdoc><characteristic type="CameraMgr" version="4.3" ><parm name="UseRearCamera" value="2"/></characteristic></wap-provisioningdoc>


禁用前置摄像头和启用后置摄像头：

<wap-provisioningdoc><characteristic type="CameraMgr" version="4.3" ><parm name="UseFrontCamera" value="2"/><parm name="UseRearCamera" value="1"/></characteristic></wap-provisioningdoc>


查询

获取“使用所有摄像头”参数的状态：

输入

<wap-provisioningdoc><characteristic type="CameraMgr" ><parm-query name="UseAllCameras"/></characteristic></wap-provisioningdoc>

输出

<wap-provisioningdoc><characteristic type="CameraMgr" version="4.3" ><parm name="UseAllCameras" value="1"/></characteristic></wap-provisioningdoc>


获取“使用前置摄像头”参数的状态：

输入

<wap-provisioningdoc><characteristic type="CameraMgr" ><parm-query name="UseFrontCamera"/></characteristic></wap-provisioningdoc>

输出

<wap-provisioningdoc><characteristic type="CameraMgr" version="4.3" ><parm name="UseFrontCamera" value="1"/></characteristic></wap-provisioningdoc>


获取“使用后置摄像头”参数的状态：

输入

<wap-provisioningdoc><characteristic type="CameraMgr" ><parm-query name="UseRearCamera"/></characteristic></wap-provisioningdoc>

输出

<wap-provisioningdoc><characteristic type="CameraMgr" version="4.3" ><parm name="UseRearCamera" value="1"/></characteristic></wap-provisioningdoc>