MSDC 4.3 接口规范(6)
4.3 流媒体模块初始化
4.3.1 添加Streaming模块事件监听
4.3.1.1 接口函数
void addStreamingEventListener (IMSDCStreamingControllerEventListener listener)
4.3.1.2 先决条件
查看前面的 获取 Streaming 模块 Controller 和 Model 实例 小节
4.3.1.3 描述
要从 MSDC 获取 Streaming 模块相关的事件,应用程序必须使用 addStreamingEventListener() 添加事件侦听器。
4.3.1.4 调用流程
4.3.2 流媒体模块连接初始化
4.3.2.1 接口函数
void initializeStreamingService (StreamingInitParams params);
void streamingServiceConfirmation();
void streamingServiceError (int errorCode, String message, Integer serviceId);
4.3.2.2 先决条件
- MSDC 管理器模块连接初始化
- 添加流模块事件监听器
4.3.2.3 描述
添加 Streaming 模块事件侦听器后,应用程序必须使用 initializeStreamingService() 初始化与 Streaming 模块的连接。 这是应用程序注册流媒体服务并提供服务类信息的方式。
服务类信息是应用程序感兴趣的服务类列表。MSDC 只能为属于这组服务类的那些服务提供应用程序信息和数据。 服务类别列表必须在应用程序提供商和运营商/运营商之间进行管理。
建议:该应用程序可以设计为保持服务类信息可配置。 这可以在应用程序测试期间提供帮助,并使应用程序更加灵活。
如果 MSDC API 接受请求,并且流模块连接初始化成功,则 MSDC API 以 streamingServiceInitializeConfirmation 响应。
4.3.2.4 调用流程
4.3.2.4.1 流式连接初始化成功
4.3.2.4.2 连接初始化失败
如果 Streaming 模块连接初始化失败,MSDC API 会以 streamingServiceError() 和错误代码 ERROR_S_UNABLE_TO_INITIALIZE 进行响应。
4.3.2.4.3 流媒体服务类初始化失败
如果服务类初始化失败,MSDC API 会以 streamingServiceError() 和错误代码 ERROR_S_SERVICE_CLASS_INITIALIZATION_FAILED 进行响应。
服务类初始化失败的一个典型原因是服务类已被另一个应用程序使用。