MSDC 4.3 接口规范(20)

  • 6 Network Module Management
    • 6.1 App-to-MSDC connection setup
      • 6.1.1 Add MSDC Manager module event listener
      • 6.1.2 MSDC Manager module connection initialization
      • 6.1.3 Get the Network module Controller and Model instances
        • 6.1.3.1 Interface functions
        • 6.1.3.2 Description
        • 6.1.3.3 Call flows
    • 6.2 Network module initialization
      • 6.2.1 Add Network module event listener
        • 6.2.1.1 Interface functions
        • 6.2.1.2 Description
        • 6.2.1.3 Call flows
      • 6.2.2 Network module connection initialization
        • 6.2.2.1 Interface functions
        • 6.2.2.2 Prerequisites
        • 6.2.2.3 Description
        • 6.2.2.4 Call flows
          • 6.2.2.4.1 Call flows Connection initialization succeeds
          • 6.2.2.4.2 Connection initialization fails
    • 6.3 Notifications and feature opt-ins
      • 6.3.1 Broadcast coverage notification
        • 6.3.1.1 Interface functions
        • 6.3.1.2 Prerequisites
        • 6.3.1.3 Description
        • 6.3.1.4 Call flows
      • 6.3.2 Signal level notification
        • 6.3.2.1 Interface functions
        • 6.3.2.2 Prerequisites
        • 6.3.2.3 Description
        • 6.3.2.4 Call flows
          • 6.3.2.4.1 Enable signal level
          • 6.3.2.4.2 Disable signal level notification
      • 6.3.3 Roaming notification
        • 6.3.3.1 Interface functions
        • 6.3.3.2 Prerequisites
        • 6.3.3.3 Description
        • 6.3.3.4 Call flows
    • 6.4 Other error notifications
      • 6.4.1 Interface functions
      • 6.4.2 Prerequisites
      • 6.4.3 Call flows
    • 6.5 App-to-MSDC connection shutdown
      • 6.5.1 Close Network module connection
        • 6.5.1.1 Interface functions
        • 6.5.1.2 Prerequisites
        • 6.5.1.3 Description
        • 6.5.1.4 Call flows
      • 6.5.2 Remove Network module event listener
        • 6.5.2.1 Interface functions
        • 6.5.2.2 Prerequisites
        • 6.5.2.3 Description
        • 6.5.2.4 Call flows
        • 6.5.3 Close MSDC Manager module connection
        • 6.5.4 Remove MSDC Manager module event listener

6 Network Module Management

本章描述了对网络服务感兴趣的应用程序到MSDC接口的调用流程序列。
本章中的所有功能,即请求调用和通知,都是以下类中的一部分。

  • IMSDCAppManager() (见第3.1节)
  • IMSDCAppManagerEventListener() (见第3.1节)
  • IMSDCNetworkController() (见第3.4节)
  • IMSDCNetworkControllerEventListener() (见第3.4节)
  • IMSDCNetworkModel() (见第3.4节)

6.1 App-to-MSDC connection setup

应用程序从这里开始,开始与MSDC沟通。

6.1.1 Add MSDC Manager module event listener

见第4.2.1节。

6.1.2 MSDC Manager module connection initialization

见第4.2.2节。

6.1.3 Get the Network module Controller and Model instances

6.1.3.1 Interface functions

IMSDCNetworkController getNetworkController()
IMSDCNetworkModel getNetworkModel()

6.1.3.2 Description

为了向MSDC的网络模块发送请求,应用程序应该使用getNetworkController()和getNetworkModel()调用来分别获得网络控制器和模型实例。
有关代码示例,请参见A.2.3节。

6.1.3.3 Call flows

6.2 Network module initialization

6.2.1 Add Network module event listener

6.2.1.1 Interface functions

void addNetworkEventListener (NetworkServiceEventListenerlistener);

6.2.1.2 Description

为了从MSDC API的网络模块获取事件,应用程序必须使用addNetworkEventListener()来添加网络模块的事件监听器。
有关代码示例,请参见第A.2.4节。

6.2.1.3 Call flows

图5-5显示了添加网络模块事件监听器的调用流程。

6.2.2 Network module connection initialization

6.2.2.1 Interface functions

void initializeNetworkService ();
void networkServiceConfirmation();
void networkServiceError (int errorCode,String message);

6.2.2.2 Prerequisites

添加网络模块事件监听器

6.2.2.3 Description

在网络模块的事件监听器被添加后,应用程序必须用initializeNetworkService()初始化与网络模块的连接。
如果MSDC的API接受了请求,并且连接初始化成功,MSDC会以networkServiceInitializeConfirmation来回应。
有关代码示例,请参见第A.2.2节和A.5.1节。

6.2.2.4 Call flows

6.2.2.4.1 Call flows Connection initialization succeeds

6.2.2.4.2 Connection initialization fails

如果网络模块连接初始化失败,MSDC API会以networkServiceError()和错误代码ERROR_NW_UNABLE_TO_INITIALIZE进行响应。
public void insufficientStorage(int serviceHandle ,String uri, String path,Long totalStorageNeeded);

6.3 Notifications and feature opt-ins

6.3.1 Broadcast coverage notification

6.3.1.1 Interface functions

void broadcastCoverageNotification(int state);
int getBroadcastCoverage();

6.3.1.2 Prerequisites

文件传递模块连接初始化

6.3.1.3 Description

如果运行MSDC的设备移入或移出LTE广播覆盖区,MSDC API会用broadcastCoverageNotification()通知应用程序,以表明这一变化。
如果 MSDC 无法访问指定位置来存储下载的文件,它会通过 inaccessibleLocation() 通知应用程序。

6.3.1.4 Call flows

6.3.2 Signal level notification

6.3.2.1 Interface functions

void enableSignalLevelMonitoring(int periodicity);
void signalLevelNotification();
void disableSignalLevelMonitoring();
void networkServiceError(int errorCode,String message);

6.3.2.2 Prerequisites

网络模块连接初始化

6.3.2.3 Description

应用程序可以通过使用enableSignalLevelMonitoring()请求定期显示信号电平通知。它还提供以秒为单位的监测间隔参数值。
MSDC API用signalLevelNotification()来响应,它的信号电平值从0(最低)到5(最高)。超出覆盖范围事件期间的信号级别为-1。
如果应用程序给出的通知间隔是一个正值,MSDC API会继续发送signalLevelNotification()消息,并更新信号电平值。每次通知的间隔时间由周期值定义。
要禁用信号电平,请使用disableSignalLevelMonitoring()。

6.3.2.4 Call flows

6.3.2.4.1 Enable signal level


如果应用程序给出的通知间隔值小于或等于零,MSDC API将发送一次signalLevelNotification()消息。

如果MSDC不能启用信号电平通知,MSDC API会以networkServiceError()和errorcodeERROR_NW_ UNABLE_TO_ENABLE_SIGNAL_LEVEL进行响应。

6.3.2.4.2 Disable signal level notification

要禁用信号电平通知,应用程序可以使用 disableSignalLevelNotification()。如果MSDC API接受该请求,它将向应用程序返回ACCEPTED。
MSDC API不会向应用程序发送禁用确认通知,作为对该请求的响应。

如果MSDC无法禁用信号电平通知,MSDC API会以networkServiceError()和错误代码ERROR_NW_UNABLE_TO_DISABLE_SIGNAL_LEVEL作出响应。

6.3.3 Roaming notification

6.3.3.1 Interface functions

void roamingNotification (int state);
int getRoamingState();
State Enum: IN_NETWORK, OUT_OF_NETWORK

6.3.3.2 Prerequisites

网络模块连接初始化

6.3.3.3 Description

如果运行MSDC的设备在LTE广播家庭操作网络区域内或外漫游,MSDC API会用漫游通知()通知应用程序,以表明这一变化。

6.3.3.4 Call flows

6.4 Other error notifications

如果MSDC API想要通知应用程序任何网络模块的错误,它会使用重载的networkServiceError()通知。
关于不同类型的错误通知的更多信息,见第9.4节。

6.4.1 Interface functions

void networkServiceError(int errorCode,String message);

6.4.2 Prerequisites

添加网络模块事件监听器

6.4.3 Call flows

如果MSDC的网络模块因任何原因不可用,MSDC API会以networkServiceError()和错误代码ERROR_NW_SERVICE_UNAVAILABLE回应应用程序。

6.5 App-to-MSDC connection shutdown

本节定义了应用程序用来关闭与MSDC连接的调用。

6.5.1 Close Network module connection

6.5.1.1 Interface functions

void terminateNetworkService()

6.5.1.2 Prerequisites

网络模块连接初始化

6.5.1.3 Description

为了关闭与MSDC网络模块的连接,应用程序使用terminateNetworkService()。

6.5.1.4 Call flows

6.5.2 Remove Network module event listener

6.5.2.1 Interface functions

void removeNetworkEventListener (NetworkServiceEventListenerlistener);

6.5.2.2 Prerequisites

添加网络模块事件监听器

6.5.2.3 Description

要停止从网络模块获取事件,应用程序必须使用removeNetworkEventListener()删除它先前添加的事件监听器(见6.2.1节)。

6.5.2.4 Call flows

6.5.3 Close MSDC Manager module connection

见第4.6.3节。

6.5.4 Remove MSDC Manager module event listener

见第4.6.4节。

MSDC 4.3 接口规范(20)相关推荐

  1. MSDC 4.3 接口规范(10)

    MSDC 4.3 接口规范(10) 4.4.7 警告提示 4.4.7.1 接口方法 4.4.7.2 描述 4.4.8 信息调用 4.4.8.1 获取播放URL 4.4.8.1.1 接口方法 4.4.8 ...

  2. MSDC 4.3 接口规范(9)

    MSDC 4.3 接口规范(9) 4.4.5 其他需要注意的事项 4.4.5.1 流服务已暂停 4.4.5.1.1接口功能 4.4.5.1.2 前置条件 4.4.5.1.3 描述 4.4.5.1.4 ...

  3. MSDC 4.3 接口规范(4)

    MSDC 4.3 接口规范(4) 4 流服务 4.1 概览 4.2 应用程序到MSDC的连接设置 4.2.1 添加 MSDC 管理模块事件监听器 4.2.1.1 接口函数 4.2.1.2 描述 4.2 ...

  4. MSDC 4.3 接口规范(5)

    MSDC 4.3 接口规范(5) 4.2.2 MSDC Manager 模块初始化链接 4.2.2.1 接口函数 4.2.2.2 先决条件 4.2.2.3 描述 4.2.2.4 调用流程 4.2.2. ...

  5. MSDC 4.3 接口规范(11)

    MSDC 4.3 接口规范(11) 4.5 MSDC Manager 模块连接管理 4.5.1 MSDC 错误通知 4.5.1.1 先决条件 4.5.1.2 描述 4.5.1.3 调用流程 4.5.2 ...

  6. MSDC 4.3 接口规范(19)

    MSDC 4.3 接口规范(19) 5.5 MSDC Manager module connection management 5.6 App-to-MSDC connection shutdown ...

  7. MSDC 4.3 接口规范(13)

    MSDC 4.3 接口规范(13) 5 文件传输服务 5.1 概览 5.2 应用到MSDC 链接初始化 5.2.1 添加MSDC 管理模块监听器 5.2.2 MSDC管理模块初始化 5.2.3 获取文 ...

  8. MSDC 4.3 接口规范(18)

    MSDC 4.3 接口规范(18) 5.4.6 Information calls 5.4.6.1 Get service list 5.4.6.1.1 Interface functions 5.4 ...

  9. MSDC 4.3 接口规范(8)

    MSDC 4.3 接口规范(8) 4.4.3停止流媒体服务 4.4.3.1 接口功能 4.4.3.2 先决条件 4.4.3.3 描述 4.4.3.4 调用流程 4.4.3.4.1 停止流服务 4.4. ...

最新文章

  1. 查看linux系统的性能
  2. python自学书籍顺序-python:入门到实践书籍学习(六)
  3. (九) shiro采用AES加密和解密
  4. 线程的属性 —— 分离的状态(detached state)、栈地址(stack address)、栈大小(stack size)
  5. jQuery教程08-属性筛选选择器
  6. 关于std::thread以及std::condition_variable的一些细节备忘
  7. 计算机基础与应用 是学什么,计算机基础与应用教学大纲
  8. docker添加新的环境变量_docker使用教程[三]Dockfile小试牛刀
  9. nginx之lua_shared_dict命令
  10. (附源码)springboot嘉应房地产公司质量管理系统 毕业设计 453100
  11. 如何批量设置 Word 文档的只读密码?
  12. [Bada开发]使用静态库
  13. matlab simulink 例子,simulink实例超实用
  14. lego-loam在Ubuntu16.04下安装、跑包及实时建图
  15. Linux下pppd拨号脚本配置
  16. VUE 使用animated 动画
  17. OpenStack部署及创建云主机实例
  18. 浏览器查看请求与响应报文
  19. Office办公软件各种神操作,看到第1个就傻眼了,建议收藏
  20. 深圳美景品牌策划机构:英国知名时尚鞋履品牌IGX签约美景策划

热门文章

  1. 网上交易的卫兵—数字证书和数字签名
  2. 循序搜寻法(使用卫兵)
  3. IOS – OpenGL ES 图像柏林噪点/花边噪点 GPUImagePerlinNoiseFilter
  4. 腾讯云拟年内在全球增设超30%数据中心;Zepp Health首季成人智能手表出货量居全球前四 | 全球TMT...
  5. idea svn插件离线安装_idea离线安装lombock插件
  6. 强化学习七日打卡营终极复现之flappy bird
  7. SpringBoot整合RabbitMQ之Spring事件驱动模型
  8. ajax跨域数据不完整,Ajax交互,浏览器接收不到服务器的Json数据(跨域问题)
  9. Matlab——常用函数的用法总结(部分直接摘自mathwork,持续更新)
  10. fastdfs连接mysql_使用fastdfs-zyc监控FastDFS文件系统