MSDC 4.3 接口规范(2)
3 MSDC API
MSDC API 为典型的基于 MVC 的 UI 应用程序提供模型和控制器实现。 这种架构有助于快速开发客户端应用程序。 MSDC API 使开发人员可以专注于为实时流媒体和文件传送服务创建出色的应用程序,而不必担心底层 Android 服务以及与这些服务的通信管理。
本章描述了应用程序需要的主要接口和组件。 有关类和函数的更多详细信息,请参阅第 9 章。
注意:
- 任何MSDC Android 服务都称为模块。
- 如果出现错误,根据错误情况,MSDC 通过异步错误通知通知应用程序。
3.1 MSDC 管理器模块
所有应用程序都使用 MSDC 管理器模块类中的函数,无论它们是否提供流式传输或文件传递服务。
这些类中的函数帮助应用程序建立和管理与 MSDC 的整体通信。应用程序必须使用这些函数来启动与 MSDC 的任何通信。
接口类 | 描述 |
---|---|
IMSDCAppManager | 包含应用程序用于向 MSDC 发送请求的所有功能,这些功能不特定于任何类型的服务。 这些函数提供以下功能: * 初始化/终止——初始化或终止与 MSDC 管理器模块的连接。 * 添加/删除事件侦听器– 添加或删除MSDC 管理器模块的事件侦听器。 * 获取控制器和模型实例——流模块、文件传递模块和网络模块类。 * 其他获取函数——getAPIVersion()。 |
IMSDCAppManagerEventListener | * 包含与 MSDC 有关但不特定于特定类型服务(流式传输或文件传递)的通用事件通知。 * 应用程序必须实现此类并在IMSDCAppManager 中添加事件侦听器(使用addMSDCEventListener()),然后才能接收这些事件通知。 |
3.2 流媒体模块
要使用来自 MSDC 的流服务,应用程序实现流模块接口类以与 MSDC 的流模块进行通信。
该应用程序可以将 Streaming 模块类与 Network 模块类中的函数结合使用(参见第 3.4 节)。
接口类 | 描述 |
---|---|
IMSDCStreamingController | 包含应用程序用于向 MSDC 发送流服务相关请求的所有函数。 这些函数提供以下功能: * 初始化/终止——初始化或终止与流媒体模块的连接。 * 添加/删除事件侦听器– 添加或删除Streaming 模块的事件侦听器。 * 流媒体服务控制 |
IMSDCStreamingControllerEventListener | * 包含与流媒体服务相关的所有事件通知。 * 应用程序必须实现此类并在IMSDCStreamingController 中添加事件侦听器,然后才能接收这些事件通知。 |
IMSDCStreamingModel | 包含应用程序可以随时用于从 MSDC 检索信息的 get 函数。 |
3.3 文件传递模块
要使用来自 MSDC 的文件传递服务,应用程序实现文件传递模块接口类以与 MSDC 的文件传递模块进行通信。
该应用程序可以将文件传递模块类与网络模块类中的函数结合使用(参见第 3.4 节)。
接口类 | 描述 |
---|---|
IMSDCFileDeliveryController | 包含应用程序用于向 MSDC 发送文件传递服务相关请求的所有功能。 这些函数提供以下功能: * 初始化/终止——初始化或终止与文件传递模块的连接。 * 添加/删除事件监听器– 添加或删除文件传递模块的事件监听器。 * 文件传递服务控制 |
IMSDCFileDeliveryControllerEventListener | * 包含与文件传送服务相关的所有事件通知。 * 应用程序必须实现此类并在IMSDCFileDeliveryController 中添加事件侦听器,然后才能接收这些事件通知。 |
IMSDCFileDeliveryModel | 包含应用程序可以随时用于从 MSDC 检索信息的 get 函数。 |
3.4 网络模块
流式传输或文件传递应用程序可以使用网络模块接口类从 MSDC 获取与网络相关的通知。 此类下的函数并不特定于应用打算呈现并与 MSDC 的网络模块通信的服务类型。
只对网络通知感兴趣但不向用户呈现流或文件传递服务的应用程序也可以使用网络模块类和 MSDC 管理器模块接口类(参见第 3.1 节)。
接口类 | 描述 |
---|---|
IMSDCNetworkController | 包含应用程序为向 MSDC 发送与网络通知相关的请求而实现的所有常用功能。 这些功能共同提供以下功能: * 初始化/终止——初始化或终止与网络模块的连接。 * 添加/删除事件监听器——添加或删除网络模块的事件监听器。 |
IMSDCNetworkControllerEventListener | * 包含所有应用程序共有的网络相关事件通知。 * 应用程序必须在 IMSDCNetworkController 中添加事件侦听器,然后应用程序才能接收事件通知,例如: – 广播报道 – 信号电平 |
IMSDCNetworkModel | 包含可用于所有应用程序随时从 MSDC 检索广播覆盖率和信号级别信息的 get 函数。 |