Bluetooth Manager

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

StageNow - 2.10

概述

Bluetooth Manager (BluetoothMgr) 控制设备是否可与进入到有效范围内的其他蓝牙设备配对，如耳机、打印机和计算机，以及设备是否“可发现”，这将使其他蓝牙设备能够发起与它的配对请求。

蓝牙是一种在 2.4 GHz ISM 频段下工作的短距离无线技术，最初打算是用来替换串行通信电缆。此后，它已被采用作为免提耳机、立体声音频、PC 联网、条码扫描器连接、医疗设备以及先前使用 RS-232 的其他设备的连接标准。

主要功能

启用/禁用
- 蓝牙配对
- 蓝牙可发现性
- 无提示配对（无用户确认）
创建无提示配对规则

可发现性启用/禁用

控制设备用户是否可以将设备置于“可发现”模式。当设备处于此模式时，可以被其他尝试与它配对的其他蓝牙设备发现。此参数对于设备本身发现其他设备、发起与它们的配对请求或重新连接先前已配对的设备的能力没有影响。

参数名称：AllowDiscoverability

选项	名称	说明	需要
0	不更改	此值（或 XML 中缺少此参数）导致不会更改设备被其他蓝牙设备发现的能力；任何以前选择的设置都将保留。	MX：6.1+ Android API：23+
1	启用	使用户可以将设备设置为其他蓝牙设备“可发现”。	MX：6.1+ Android API：23+
2	禁用	可阻止用户将设备设置为其他蓝牙设备可发现。	MX：6.1+ Android API：23+

选项

名称

说明

需要

不更改

此值（或 XML 中缺少此参数）导致不会更改设备被其他蓝牙设备发现的能力；任何以前选择的设置都将保留。

MX：6.1+

Android API：23+

启用

使用户可以将设备设置为其他蓝牙设备“可发现”。

MX：6.1+

Android API：23+

禁用

可阻止用户将设备设置为其他蓝牙设备可发现。

MX：6.1+

Android API：23+

配对启用/禁用

控制是否允许设备与新发现的进入有效范围内的蓝牙设备配对。此参数的设置不会影响现有设备配对。

参数名称：AllowPairing

选项	名称	说明	需要
0	不更改	此值（或 XML 中缺少此参数）导致不会更改设备与发现的其他蓝牙设备配对的能力；任何以前选择的设置都将保留。	MX：5.1+ Android API：22+
1	启用	使设备能够与新发现的蓝牙设备配对。	MX：5.1+ Android API：22+
2	禁用	禁用与新发现的蓝牙设备配对。	MX：5.1+ Android API：22+

选项

名称

说明

需要

不更改

此值（或 XML 中缺少此参数）导致不会更改设备与发现的其他蓝牙设备配对的能力；任何以前选择的设置都将保留。

MX：5.1+

Android API：22+

启用

使设备能够与新发现的蓝牙设备配对。

MX：5.1+

Android API：22+

禁用

禁用与新发现的蓝牙设备配对。

MX：5.1+

Android API：22+

无提示配对启用/禁用

控制是否允许设备与远程蓝牙设备配对而无需用户确认。此功能与自动配对不同；它只是取消设备用户发起设备配对后的确认步骤。此参数的设置不会影响现有设备配对。

参数名称：AllowSilentPairing

选项

名称

说明

需要

不更改

此值（或 XML 中缺少此参数）导致不会更改设备与发现的其他蓝牙设备配对的能力；任何以前选择的设置都将保留。

MX：7.0+

Android API：24+

启用

使设备可以与已知设备配对而无需用户确认。

MX：7.0+

Android API：24+

禁用

禁用与蓝牙设备的无提示配对；需要对配对进行确认。

MX：7.0+

Android API：24+

静默配对操作

用于管理设备上无提示配对规则的列表。默认情况下，已设置有无提示配对规则，允许一些 Zebra 设备型号在用户发起配对后没有用户确认的情况下配对。注意：下列默认设备列表的配对规则仅对设备名称进行匹配。为提高安全性，Zebra 建议将默认规则替换为对设备名称、设备种类和高位地址部分进行匹配。

DS3578
DS3678
RS6000
RS507
HS3100
DX30
PAR-TMD
DS8178
LI3678
DS2278

在以下条件下显示：“允许配对”以及“允许无提示配对”均设置为“启用”

参数名称：SilentPairingAction

选项	名称	说明	需要
0	不更改	此值（或 XML 中缺少此参数）导致不会更改设备与发现的其他蓝牙设备配对的能力；任何以前选择的设置都将保留。	MX：7.0+ Android API：24+
1	添加静默配对规则	将无提示配对规则添加到列表中。	MX：7.0+ Android API：24+
2	删除静默配对规则	删除指定的无提示配对规则。	MX：7.0+ Android API：24+
3	删除所有静默配对规则	在设备列表中清除以前为无提示配对指定的规则，包括默认规则。	MX：7.0+ Android API：24+

无提示配对设备名称

用于指定允许设备与其配对而不需要用户确认的蓝牙设备的名称。创建无提示配对规则只需要“名称”字段。可以根据需要将设备名称与设备种类和/或设备 MAC 地址的高位地址部分 (UAP) 相结合，创建比只使用设备名称更加具体的无提示配对规则。

输入值规则：

1 到 255 个字符的字符串，其中包含蓝牙设备名称。例如："Zebra Printer_01"

在以下条件下显示：“允许配对”以及“允许无提示配对”均设置为“启用”

参数名称：SilentPairingName
需要：
MX：7.0+

Android API：24+

无提示配对设备种类

用于指定允许设备与其配对而不需要用户确认的蓝牙设备的设备种类 (CoD)。一旦发现蓝牙设备，可在蓝牙设置活动中看到它的种类。可以与无提示配对名称以及（可选）设备 MAC 地址的高位地址部分 (UAP) 相结合来创建无提示配对规则。

输入值规则：

表示蓝牙设备种类的字符串。例如："002900"

有关详细信息，请访问：

CoD 计算器
Bluetooth.com 基带规范

在以下条件下显示：“允许配对”以及“允许无提示配对”均设置为“启用”

参数名称：SilentPairingCoD
需要：
MX：7.0+

Android API：24+

无提示配对 UAP

用于指定允许设备与其配对而不需要用户确认的蓝牙设备的 MAC 地址的高位地址部分 (UAP)。UAP 通常是蓝牙 MAC 地址的前三个字节。一旦发现蓝牙设备，可在蓝牙设置活动中看到它的 UAP 。可以结合无提示配对名称和（可选）设备种类来创建一个完整的无提示配对规则。

输入值规则：

一个十六进制字符串，表示蓝牙 MAC 地址的前三个 (3) 字节。例如："0A:1B:2C"

在以下条件下显示：“允许配对”以及“允许无提示配对”均设置为“启用”

参数名称：SilentPairingUAP
需要：
MX：7.0+

Android API：24+

示例

允许新配对

输入

<wap-provisioningdoc><characteristic type="BluetoothMgr" version="5.0"><parm name="AllowPairing" value="1"/></characteristic></wap-provisioningdoc>

输出

<wap-provisioningdoc><characteristic type="BluetoothMgr" version="5.0"><parm name="AllowPairing" value="1"/></characteristic></wap-provisioningdoc>

如果操作成功，结果 XML（输出）将与输入 XML 相同。

不允许新配对

输入

<wap-provisioningdoc><characteristic type="BluetoothMgr" version="5.0"><parm name="AllowPairing" value="2"/></characteristic></wap-provisioningdoc>

输出

<wap-provisioningdoc><characteristic type="BluetoothMgr" version="5.0"><parm name="AllowPairing" value="2"/></characteristic></wap-provisioningdoc>

如果操作成功，结果 XML（输出）将与输入 XML 相同。

查询设备上的无提示配对状态

输入

<wap-provisioningdoc><characteristic type="BluetoothMgr"><parm-query name="AllowSilentPairing"/></characteristic></wap-provisioningdoc>

输出（允许无提示配对 = "1"，并且已启用）

<wap-provisioningdoc><characteristic type="BluetoothMgr" version="7.1"><parm name="AllowSilentPairing" value="1"/></characteristic></wap-provisioningdoc>

使用名称、CoD 和 UAP 创建无提示配对规则

<wap-provisioningdoc><characteristic type="BluetoothMgr" version="7.0" ><parm name="AllowPairing" value="1"/><parm name="AllowDiscoverability" value="1"/><parm name="AllowSilentPairing" value="1"/><parm name="SilentPairingAction" value="1"/><characteristic type="SilentPairingDeviceDetails"><parm name="SilentPairingName" value="TC51"/><parm name="SilentPairingCoD" value="524"/><parm name="SilentPairingUAP" value="40:83:DE"/></characteristic></characteristic></wap-provisioningdoc>

从无提示配对规则列表中删除所有设备

<wap-provisioningdoc><characteristic type="BluetoothMgr"><parm name="SilentPairingAction" value="3"/></characteristic></wap-provisioningdoc>

将默认规则恢复为无提示配对规则列表

<wap-provisioningdoc><characteristic type="BluetoothMgr"><parm name="SilentPairingAction" value="1"/><characteristic type="SilentPairingDeviceDetails"><parm name="SilentPairingName" value="DS3578"/></characteristic></characteristic><characteristic type="BluetoothMgr"><parm name="SilentPairingAction" value="1"/><characteristic type="SilentPairingDeviceDetails"><parm name="SilentPairingName" value="DS3678"/></characteristic></characteristic><characteristic type="BluetoothMgr"><parm name="SilentPairingAction" value="1"/><characteristic type="SilentPairingDeviceDetails"><parm name="SilentPairingName" value="RS6000"/></characteristic></characteristic><characteristic type="BluetoothMgr"><parm name="SilentPairingAction" value="1"/><characteristic type="SilentPairingDeviceDetails"><parm name="SilentPairingName" value="RS507"/></characteristic></characteristic><characteristic type="BluetoothMgr"><parm name="SilentPairingAction" value="1"/><characteristic type="SilentPairingDeviceDetails"><parm name="SilentPairingName" value="HS3100"/></characteristic></characteristic><characteristic type="BluetoothMgr"><parm name="SilentPairingAction" value="1"/><characteristic type="SilentPairingDeviceDetails"><parm name="SilentPairingName" value="DX30"/></characteristic></characteristic><characteristic type="BluetoothMgr"><parm name="SilentPairingAction" value="1"/><characteristic type="SilentPairingDeviceDetails"><parm name="SilentPairingName" value="PAR-TMD"/></characteristic></characteristic><characteristic type="BluetoothMgr"><parm name="SilentPairingAction" value="1"/><characteristic type="SilentPairingDeviceDetails"><parm name="SilentPairingName" value="DS8178"/></characteristic></characteristic><characteristic type="BluetoothMgr"><parm name="SilentPairingAction" value="1"/><characteristic type="SilentPairingDeviceDetails"><parm name="SilentPairingName" value="LI3678"/></characteristic></characteristic><characteristic type="BluetoothMgr"><parm name="SilentPairingAction" value="1"/><characteristic type="SilentPairingDeviceDetails"><parm name="SilentPairingName" value="DS2278"/></characteristic></characteristic></wap-provisioningdoc>