GPRS Manager

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

StageNow - 2.10

概述

GprsMgr 管理设备使用的通用分组无线业务 (GPRS) 网络的接入点名称 (APN) 设置。一般而言，APN 充当设备运营商网络、互联网或其他分组数据网络之间的桥梁，存储设备可能需要访问的安全性、多媒体消息 (MMS) 和其他服务的首选项。

主要功能

  • 创建多个 APN
  • 设置默认 APN
  • 删除或替换旧 APN
  • 删除所有的 APN
  • 定义自定义 APN 参数，包括：
    • 移动通信国家/地区码
    • MMS 端口、代理和中心
    • 移动网络码
    • 自定义端口、代理、服务器和类型

关于 WWAN 通信

配备了无线广域网络 (WWAN) 或蜂窝数据功能的设备支持以下一种或多种 WWAN 技术类型：

  • GPRS 是一种用于启用全球移动通信系统 (GSM) 蜂窝网络的调制方法。GPRS 网络的一个关键特征是用户识别模块 (SIM) 卡，它安全地存储移动用户识别 (IMSI) 号码及其相关密钥，通过这些信息来识别用户以及验证用户身份。插入 SIM 卡即允许建立基本的蜂窝业务（包括通过 GSM 网络收发语音和短信）。但是，蜂窝数据服务可能需要一些额外配置，这些配置是仅仅根据 SIM 卡提供的信息无法执行的。

  • 码分多址 (CDMA) 是许多移动电话标准中使用的调制方法，如 cdmaOne、CDMA2000（cdmaOne 的 3G 演进）以及 WCDMA。CDMA 网络的一个重要特征是它缺少 SIM 卡，这通常需要在设备用户和移动通信提供商之间有一个配置语音、短信和蜂窝数据服务的手动过程。

  • LTE（长期演进，4G）是一个可以将 CDMA 和 GPRS 扩展到 4G 的调制方法。对于 GPRS，LTE 网络使用 SIM 卡安全地存储移动用户识别 (IMSI) 号码及其相关的密钥，通过这些信息来识别用户以及验证用户身份。LTE SIM 卡包含有允许激活蜂窝数据服务的额外信息，无需与 CDMA 关联的手动配置过程。

自定义 APN 设置

在 GSM 网络上运行并且使用 GPRS 蜂窝数据的设备有时需要 SIM 卡未提供的附加信息。此信息通常称为接入点名称 (APN)，但是包括的信息不只是接入点名称。APN 标识移动数据用户需要访问的分组数据网络 (PDN)，有时还定义其他可用服务。配置设备使用特定 APN 通常需要接入点的名称以及用户名和密码，才能通过该接入点进行连接。

配备了 GPRS 的 Android 设备一般必须为要使用的每个 GPRS 蜂窝数据网络定义一个合适的 APN。如果使用一个 GPRS 蜂窝数据网络，则只能在设备上定义一个 APN。但是，如果设备在多个 GPRS 蜂窝数据网络上运行，例如启用跨多个地理区域的漫游，则必须定义多个 APN。

GprsMgr 中的“自定义 APN”参数允许设备管理员创建多个 APN，以匹配各种运营商网络所需的设置。这允许使用一个启用 GPRS 的 WWAN 设备和 SIM 卡，只需通过更改 APN 就可以在不同的蜂窝网络上建立蜂窝数据连接。

注意：自定义参数就是一些“传递”字段；它们存放有各种组合的值集，用于从一个 APN 轻松切换到另一个 APN 以适应各种蜂窝网络。这些值和设置的规则因地区和 SIM 卡而异。Zebra 建议在进行常规部署之前先对工作的设备和 SIM 卡测试运营商指定的 APN 设置。

APN 操作

包含可对 APN 执行的操作的列表。

参数名称：GprsAction

选项 名称 说明需要
1 添加/替换命名 APN 导致添加指定的 APN（替换现有 APN，如果有）。

MX：4.1.1+

Android API：16+
2 删除现有命名 APN 导致删除指定的 APN。

MX：4.1.1+

Android API：16+
3 删除所有现有 APN 导致删除所有现有的 APN。

MX：4.1.1+

Android API：16+

APN 名称

用于指定在设备中用来识别 APN 的名称。设备中的所有 APN 名称必须唯一。一旦已添加具有给定名称的 APN，就可以使用该名称从设备中删除该 APN 定义，或者将该 APN 的定义替换为新定义。

注意：此参数未指定网络上的接入点名称，它仅指定用来识别 APN 并且设备用来引用该 APN　的名称。APN　的网络名称在本文档别处的“接入点”参数中指定。

参数值输入规则：

  • 0 到 255 个字符的字符串

在以下条件下显示：APN 操作为“添加/替换命名 APN”或“删除现有命名 APN”

参数名称：ApnName

需要：

  • MX：4.1.1+
  • Android API：16+

存在时替换

用于指定在创建了同名的新 APN 时是否应替换设备上现有的 APN。如果选择“False”，则尝试替换设备上现有的 APN 将会失败，并且会在结果 XML 中生成错误。

在以下条件下显示：APN 操作是“添加/替换命名 APN”

参数名称：ReplaceIfExisting

选项 名称 说明需要
1 是 导致设备上已定义的 APN 被同名称的新　APN　替换。

MX：4.1.1+

Android API：16+
0 否 阻止现有的　APN　被创建的同名新　APN　替换。

MX：4.1.1+

Android API：16+

设为默认　APN

用于指定添加的新　APN　是否应设为默认　APN　或最优先的　APN。在自动连接时，在考虑列表中的其他 APN 之前，系统会尝试使用默认 APN（如果可用）。

在以下条件下显示：APN 操作是“添加/替换命名 APN”

参数名称：MakeDefault

选项 名称 说明需要
1 是 导致新的 APN 被设置为默认的 APN 。

MX：4.1.1+

Android API：16+
0 否 阻止对当前默认 APN 的任何更改。

MX：4.1.1+

Android API：16+

接入点

用于指定在网络上识别所需 APN 的名称。此值通常从提供 APN 的 GPRS 运营商那里获得（例如，“wap.cingular”是 AT&T 常用的 APN 的名称）。这仅在为 GPRS 运营商选择的值为“自定义”时才相关，否则，预定义 APN 的 APN 值将根据选定 GPRS 运营商自动提供。

参数值输入规则：

  • 0 到 255 个字符的字符串

在以下条件下显示：APN 操作是“添加/替换命令 APN”，GPRS 运营商为“自定义”

参数名称：ATTAccessPoint、TMobileAccessPoint、CustomAccessPoint

需要：

  • MX：4.1.1+
  • Android API：16+

用户名

用于指定在所添加的 APN 上进行身份验证的用户名。此值通常从提供 APN 的 GPRS 运营商那里获得（例如，“WAP.CINGULARGPRS.COM”是 AT&T 常用来验证其 APN 身份的用户名）。这仅在为 GPRS 运营商选择的值为“自定义”时才相关，否则，预定义 APN 的 APN 值将根据选定 GPRS 运营商自动提供。

注意：如果指定空值（长度为 0），则不会使用用户名。通常，只有当 GPRS 运营商指明对于给定 APN 不需要使用用户名的身份验证时才执行此操作。

参数值输入规则：

  • 0 到 255 个字符的字符串

在以下条件下显示：APN 操作是“添加/替换命令 APN”，GPRS 运营商为“自定义”

参数名称：AttUserName、TmobileUserName、CustomUserName

需要：

  • MX：4.1.1+
  • Android API：16+

密码

用于指定在所添加的 APN 上进行身份验证所使用的密码。此值通常从提供 APN 的 GPRS 运营商那里获得（例如，“CINGULAR1”是 AT&T 常用来验证其 APN 身份的密码）。这仅在为 GPRS 运营商选择的值为“自定义”时才相关，否则，预定义 APN 的 APN 值将根据选定 GPRS 运营商自动提供。

注意：如果指定空值（长度为 0），则不会使用密码。通常，只有当 GPRS 运营商指明对于给定 APN 不需要使用密码的身份验证时才执行此操作。

参数值输入规则：

  • 0 到 255 个字符的字符串

在以下条件下显示：APN 操作是“添加/替换命令 APN”，GPRS 运营商为“自定义”

参数名称：ATTPassword、TMobilePassword、CustomPassword

需要：

  • MX：4.1.1+
  • Android API：16+

自定义 MCC

用于指定移动通信国家/地区码 (MCC)。自定义参数就是一些“传递”字段；它们存放有各种组合的值集，用于从一个 APN 轻松切换到另一个 APN 以适应各种蜂窝网络。这些值和设置的规则因地区和 SIM 卡而异。

Zebra 建议在进行部署之前先对工作的设备和 SIM 卡测试运营商指定的 APN 设置。

参数值输入规则：

  • 0 到 255 个字符的字符串

在以下条件下显示：APN 操作是“添加/替换命令 APN”，GPRS 运营商为“自定义”

参数名称：CustomMcc

需要：

  • MX：6.1+
  • Android API：19+

自定义 MMSC

用于指定多媒体消息服务中心 (MMSC)，即运营商的存储并转发服务器。自定义参数就是一些“传递”字段；它们存放有各种组合的值集，用于从一个 APN 轻松切换到另一个 APN 以适应各种蜂窝网络。这些值和设置的规则因地区和 SIM 卡而异。

Zebra 建议在进行部署之前先对工作的设备和 SIM 卡测试运营商指定的 APN 设置。

参数值输入规则：

  • 0 到 255 个字符的字符串

在以下条件下显示：APN 操作是“添加/替换命令 APN”，GPRS 运营商为“自定义”

参数名称：CustomMmsc

需要：

  • MX：6.1+
  • Android API：19+

自定义 MMS 端口

用于指定多媒体消息服务 (MMS) 端口。自定义参数就是一些“传递”字段；它们存放有各种组合的值集，用于从一个 APN 轻松切换到另一个 APN 以适应各种蜂窝网络。这些值和设置的规则因地区和 SIM 卡而异。

Zebra 建议在进行部署之前先对工作的设备和 SIM 卡测试运营商指定的 APN 设置。

参数值输入规则：

  • 0 到 255 个字符的字符串

在以下条件下显示：APN 操作是“添加/替换命令 APN”，GPRS 运营商为“自定义”

参数名称：CustomMmsPort

需要：

  • MX：6.1+
  • Android API：19+

自定义 MMS 代理

用于指定多媒体消息服务 (MMS) 代理。自定义参数就是一些“传递”字段；它们存放有各种组合的值集，用于从一个 APN 轻松切换到另一个 APN 以适应各种蜂窝网络。这些值和设置的规则因地区和 SIM 卡而异。

Zebra 建议在进行部署之前先对工作的设备和 SIM 卡测试运营商指定的 APN 设置。

参数值输入规则：

  • 0 到 255 个字符的字符串

在以下条件下显示：APN 操作是“添加/替换命令 APN”，GPRS 运营商为“自定义”

参数名称：CustomMmsProxy

需要：

  • MX：6.1+
  • Android API：19+

自定义 MNC

用于指定移动网络码 (MNC)。自定义参数就是一些“传递”字段；它们存放有各种组合的值集，用于从一个 APN 轻松切换到另一个 APN 以适应各种蜂窝网络。这些值和设置的规则因地区和 SIM 卡而异。

Zebra 建议在进行部署之前先对工作的设备和 SIM 卡测试运营商指定的 APN 设置。

参数值输入规则：

  • 0 到 255 个字符的字符串

在以下条件下显示：APN 操作是“添加/替换命令 APN”，GPRS 运营商为“自定义”

参数名称：CustomMnc

需要：

  • MX：6.1+
  • Android API：19+

自定义端口

用于指定自定义端口。自定义参数就是一些“传递”字段；它们存放有各种组合的值集，用于从一个 APN 轻松切换到另一个 APN 以适应各种蜂窝网络。这些值和设置的规则因地区和 SIM 卡而异。

Zebra 建议在进行部署之前先对工作的设备和 SIM 卡测试运营商指定的 APN 设置。

参数值输入规则：

  • 0 到 255 个字符的字符串

在以下条件下显示：APN 操作是“添加/替换命令 APN”，GPRS 运营商为“自定义”

参数名称：CustomPort

需要：

  • MX：6.1+
  • Android API：19+

自定义代理

用于指定自定义代理。自定义参数就是一些“传递”字段；它们存放有各种组合的值集，用于从一个 APN 轻松切换到另一个 APN 以适应各种蜂窝网络。这些值和设置的规则因地区和 SIM 卡而异。

Zebra 建议在进行部署之前先对工作的设备和 SIM 卡测试运营商指定的 APN 设置。

参数值输入规则：

  • 0 到 255 个字符的字符串

在以下条件下显示：APN 操作是“添加/替换命令 APN”，GPRS 运营商为“自定义”

参数名称：CustomProxy

需要：

  • MX：6.1+
  • Android API：19+

自定义服务器

用于指定自定义服务器。自定义参数就是一些“传递”字段；它们存放有各种组合的值集，用于从一个 APN 轻松切换到另一个 APN 以适应各种蜂窝网络。这些值和设置的规则因地区和 SIM 卡而异。

Zebra 建议在进行部署之前先对工作的设备和 SIM 卡测试运营商指定的 APN 设置。

参数值输入规则：

  • 0 到 255 个字符的字符串

在以下条件下显示：APN 操作是“添加/替换命令 APN”，GPRS 运营商为“自定义”

参数名称：CustomServer

需要：

  • MX：6.1+
  • Android API：19+

自定义类型

用于指定自定义类型。自定义参数就是一些“传递”字段；它们存放有各种组合的值集，用于从一个 APN 轻松切换到另一个 APN 以适应各种蜂窝网络。这些值和设置的规则因地区和 SIM 卡而异。

Zebra 建议在进行部署之前先对工作的设备和 SIM 卡测试运营商指定的 APN 设置。

参数值输入规则：

  • 0 到 255 个字符的字符串

在以下条件下显示：APN 操作是“添加/替换命令 APN”，GPRS 运营商为“自定义”

参数名称：CustomType

需要：

  • MX：6.1+
  • Android API：19+

示例

查询

获取飞行模式

输入

<wap-provisioningdoc><characteristic type="PowerKeyMgr" ><parm-query name="AirPlaneMode"/></characteristic></wap-provisioningdoc>

输出

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

获取触摸屏

输入

<wap-provisioningdoc><characteristic type="PowerKeyMgr" ><parm-query name="TouchPanel"/></characteristic></wap-provisioningdoc>

输出

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

获取安全模式

输入

<wap-provisioningdoc><characteristic type="PowerKeyMgr" ><parm-query name="SafeMode"/></characteristic></wap-provisioningdoc>

输出

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

获取自动屏幕锁定选项

输入

<wap-provisioningdoc><characteristic type="PowerKeyMgr" ><parm-query name="AutoScreenLockOption"/></characteristic></wap-provisioningdoc>

输出

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

获取自动屏幕锁定状态

输入

<wap-provisioningdoc><characteristic type="PowerKeyMgr" ><parm-query name="AutoScreenLockState"/></characteristic></wap-provisioningdoc>

输出

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

示例

添加 AT&T GPRS APN

<wap-provisioningdoc><characteristic type="GprsMgr" version="4.2" ><parm name="GprsAction" value="1"/><parm name="GprsCarrier" value="1"/><characteristic type="gprs-details"><parm name="ApnName" value="myATT"/><parm name="ReplaceIfExisting" value="1"/><parm name="MakeDefault" value="1"/></characteristic><characteristic type="att-details"><parm name="AttAccessPoint" value="wap.cingular"/><parm name="AttUserName" value="WAP@CINGULARGPRS.COM"/><parm name="AttPassword" value="CINGULAR1"/></characteristic></characteristic></wap-provisioningdoc>

添加 T-Mobile GPRS APN

<wap-provisioningdoc><characteristic type="GprsMgr" version="4.2" ><parm name="GprsAction" value="1"/><parm name="GprsCarrier" value="2"/><characteristic type="gprs-details"><parm name="ApnName" value="myTMobile"/><parm name="ReplaceIfExisting" value="0"/><parm name="MakeDefault" value="1"/></characteristic><characteristic type="tmobile-details"><parm name="TmobileAccessPoint" value="internet3.voicestream.com"/><parm name="TmobileUserName" value=""/><parm name="TmobilePassword" value=""/></characteristic></characteristic></wap-provisioningdoc>

添加自定义 GPRS APN

<wap-provisioningdoc><characteristic type="GprsMgr" version="4.2" ><parm name="GprsAction" value="1"/><parm name="GprsCarrier" value="0"/><characteristic type="gprs-details"><parm name="ApnName" value="myCustom"/><parm name="ReplaceIfExisting" value="1"/><parm name="MakeDefault" value="1"/></characteristic><characteristic type="custom-details"><parm name="CustomAccessPoint" value="apn"/><parm name="CustomUserName" value="user"/><parm name="CustomPassword" value="pass"/></characteristic></characteristic></wap-provisioningdoc>

删除现有命名 APN

<wap-provisioningdoc><characteristic type="GprsMgr" version="4.2" ><parm name="GprsAction" value="2"/><characteristic type="gprs-details"><parm name="ApnName" value="myTMobile"/></characteristic></characteristic></wap-provisioningdoc>

删除所有现有 APN

<wap-provisioningdoc><characteristic type="GprsMgr" version="4.2" ><parm name="GprsAction" value="3"/></characteristic></wap-provisioningdoc>