MSDC 4.3 接口规范（11）

4.5 MSDC Manager 模块连接管理

4.5.1 MSDC 错误通知

4.5.1.1 先决条件

添加 MSDC Manager 模块事件侦听器

4.5.1.2 描述

MSDC 使用 msdcError() 将通用 MSDC 错误通知应用程序。 有关不同类型的错误通知的更多信息，请参阅第 9.4 节。

4.5.1.3 调用流程

如果 MSDC 没有从操作系统获得足够的内存，MSDC API 会使用 msdcError() 和错误代码 ERROR_MSDC_UNABLE_TO_ALLOCATE_MEMORY 响应应用程序。

在这种情况下，请检查运行 MSDC 的设备是否有足够的可用内存。

如果 MSDC API 使用 msdcError() 通知应用程序并带有以下任何特定于运营商的错误代码，请联系运营商：

• ERROR_MSDC_UNABLE_TO_LOCATE_PROVISIONING
• ERROR_MSDC_PROVISIONING_FILE_INCOMPATIBILITY
• ERROR_MSDC_UNABLE_TO_PARSE_PROVISIONING_FILE
• ERROR_MSDC_UNABLE_TO_BIND_PORT
• ERROR_MSDC_TIME_SYNC
• ERROR_MSDC_MODEM_VERSION_INCOMPATIBLE
• ERROR_MSDC_BOOTSTRAP_CONNECTION_FAIL
• ERROR_MSDC_UNABLE_TO_PARSE_BOOTSTRAP
• ERROR_MDSC_NOT_CONNECTED_TO_HOMECARRIER_LTE
• ERROR_MDSC_FAILED_BOOTSTRAP_SERVER_DISCOVERY
• ERROR_MDSC_SIM_READ
• ERROR_MSDC_UNABLE_TO_ENABLE_MODEM
• ERROR_MSDC_MIDDLEWARE_NOT_INSTALLED
• ERROR_MSDC_EMBMS_SERVICE_NOT_AVAILABLE

4.5.2 MSDC 警告通知

4.5.2.1 先决条件

添加 MSDC Manager 模块事件侦听器

4.5.2.2 描述

如果 MSDC 想要将任何通用 MSDC 警告通知应用程序，它会使用重载的 msdcWarning()。 有关不同类型的警告通知的更多信息，请参阅第 9.4 节。

4.5.2.3 调用流程

如果 MSDC 检测到设备运行所在的网络发生变化，MSDC API 会使用 msdcWarning() 向应用发出警告，警告代码为 WARNING_MSDC_NETWORK_CHANGE_DETECTED。

MSDC API 使用 msdcWarning() 向应用程序通知以下可能的警告：

• WARNING_MSDC_NETWORK_CHANGE_DETECTED
• WARNING_MSDC_REDUCED_FEATURE_SET

4.5.3 增强型 911 通知

4.5.4 接口函数

void e911Indication(int state);

4.5.4.1 先决条件

MSDC Manager 模块连接初始化

4.5.4.2 描述

当您拨打 911 时，电话应在理想情况下停止所有活动，直到增强型 911 (E911) 呼叫和随后的回叫期结束。 回调周期通常为 5 分钟。

当调制解调器指示它处于 E911 状态时，中间件会停止所有处理并向应用程序发送状态为 IN 的 E911 指示。

当调制解调器指示 E911 状态结束时，中间件恢复正常操作并向应用程序发送状态为 OUT 的 E911 指示。

在从中间件接收到 E911 指示时，建议应用程序通知用户 E911 状态并退出。

4.5.4.3 调用流程

如果您拨打 911 并且应用程序正在后台运行，应用程序会收到 E911 通知。 如果在回调期间启动应用程序，则应用程序在 MSDC 初始化后收到 E911 通知，并且请求初始化其他模块会失败。

4.5.5 MSDC 不可用通知

4.5.6 接口函数

void msdcUnavailableNotification(int reason);

4.5.6.1 先决条件

添加 MSDC 管理器模块事件侦听器

4.5.6.2 描述

当没有连接到 MSDC 中间件时，UI 应用程序会收到此通知。 此通知包括连接丢失的可能原因：

• MSDC_NONE – 根据在initializeMSDC() 调用中声明的UI 应用程序首选项，没有找到MSDC 中间件。
• MSDC_NO_WIFI – 没有连接到远程 MSDC 中间件的 Wi-Fi 连接。
• MSDC_REMOTE_AVAILABLE – 远程 MSDC 中间件可用，并且 UI 应用程序在连接到远程 MSDC 中间件时与设备上的本地 MSDC 中间件断开连接。 应用应在收到此通知后不久收到 msdcAvailableNotification()

注意：建议在收到 MSDC 不可用通知后释放 mediaPlayer。

4.5.7 MSDC 可用通知

4.5.7.1 接口函数

void msdcAvailableNotification(int which, Object obj);

4.5.7.2 先决条件

添加 MSDC 管理器模块事件侦听器

4.5.7.3 描述

UI 应用程序在连接到 MSDC 中间件时会收到此通知。 此通知包括连接类型：

• MSDC_LOCAL – UI 应用程序连接到与 UI 位于同一设备上的本地 MSDC 中间件。
• MSDC_REMOTE – UI 应用程序连接到移动宽带产品上的远程 MSDC 中间件。

4.5.8 信息调用

4.5.8.1 获取 MSDC API 版本

4.5.8.1.1 接口函数

String getAPIVersion();

4.5.8.1.2 先决条件

MSDC 管理器模块连接初始化

4.5.8.1.3 描述

要获取 MSDC API 版本，应用程序可以使用 getAPIVersion()。 返回值具有 MSDC API 版本。

4.5.8.1.4 调用流程

4.5.8.2 获取MSDC服务器版本

4.5.8.2.1 接口函数

String getServerAPIVersion ();

4.5.8.2.2 描述

要获取 MSDC 服务器版本，应用程序可以使用 getServerAPIVersion()。 返回值有 MSDC 服务器版本

4.5.8.2.3 调用流程

4.5.8.3 检查 MSDC 初始化状态

4.5.8.3.1 接口函数

boolean isMSDCInitialized();

4.5.8.3.2 先决条件

添加 MSDC 管理器模块事件侦听器

4.5.8.3.3 描述

要确定与 MSDC 的连接是否已初始化，应用程序使用 isMSDCInitialized()。 如果返回布尔值为 TRUE，则 MSDC 连接已初始化。

4.5.8.3.4 调用流程