MSDC 4.3 接口规范（10）

4.4.7 警告提示

4.4.7.1 接口方法

4.4.7.2 描述

如果MSDC API想要将任何流式处理服务警告通知应用程序，它将使用重载的streamingServiceWarning()通知。

有关不同类型警告通知的更多信息，请参见第9.4节。

4.4.8 信息调用

4.4.8.1 获取播放URL

4.4.8.1.1 接口方法

4.4.8.1.2 前置条件

流模块初始化

4.4.8.1.3 描述

要获取MPD文件的URL，应用程序可以使用getPlaybackUrl（）。返回值的URL为MPD文件。

此功能通常在应用程序启动流式处理服务或收到更新MPD文件可用（见第4.4.5.2节）。

4.4.8.1.4 调用流

4.4.8.2 获取服务列表

4.4.8.2.1 接口方法

4.4.8.2.2 前置条件

流模块初始化

4.4.8.2.3 描述

要获取可用流媒体服务的列表，应用程序应使用getStreamingServiceList（）。

返回值包含数据，包括服务列表和相应的服务ID。对于列表中的每个服务，MSDC等字段在“serviceAvailability”字段中包括可用性模式。

可以接受的值包括：

• 0（STREAMING_SERVICE_AVAILABLE）–服务在广播模式下可用。

• 1（STREAMING_SERVICE_NOT_AVAILABLE_IN_BC）–服务在广播模式下不可用，但在单播模式下可用。

• 2（STREAMING_SERVICE_NOT_AVAILABLE）–服务在单播或广播模式下均不可用。

有关返回数据的完整列表，请参阅第9.17节。有关代码示例，请参阅A.3.2节。

getStreamingServiceList（）提供所有服务组中所有服务的列表。有关服务组的更多信息，请参阅第4.4.8.5节。

4.4.8.2.4 调用流

4.4.8.3 获取在运行的服务

4.4.8.3.1 接口方法

4.4.8.3.2 前置条件

流模块初始化

4.4.8.3.3 描述

要获取处于STARTED状态的流媒体服务列表，应用程序应使用getRunningStreamingService（）。返回值包含服务ID列表。

4.4.8.3.4 调用流

4.4.8.4 获取流服务状态

4.4.8.1.1 接口方法

4.4.8.4.2 前置条件

流模块初始化

4.4.8.4.3 描述

要获取特定流服务的状态，应用程序应使用getStreamingServiceState。返回值具有服务的状态。

有关各种流媒体服务状态的更多信息，请参阅第4.4.1节

4.4.8.4.4 调用流

4.4.8.5 获得常驻组

4.4.8.5.1 接口方法

4.4.8.5.2 前置条件

流模块初始化

4.4.8.5.3 描述

UE可以访问在给定地理位置的多个频率载波上广播的服务，即使它可能驻扎在单个频率上。

露营频率上的服务称为露营组。同样，UE可以访问的所有频率上的服务可以按频率分组为多个服务组。因此，露营组是所有服务组的相同或子集。

服务组是UE可以并发访问的一组服务。露营组中的服务可以立即访问，而无需UE切换/获取另一个频率载波。

要从MSDC获取露营组信息，应用程序应使用getCampedGroup（）。返回值定义了以下内容：

• 组名称

• 服务区域ID列表

• 服务句柄列表

注：

*如果应用程序尝试访问露营组之外的服务，则会导致额外的延迟。

*在应用程序的多视图UI中，无法显示来自不同服务组的服务

4.4.8.1.4 调用流

4.4.8.6 活动流组列表

4.4.8.6.1 接口方法

4.4.8.6.2 前置条件

流模块初始化

4.4.8.6.3 描述

要获取露营组以外的所有服务组的列表，应用程序应使用getStreamingGroupList()（请参阅第4.4.8.5节）。返回值包含其他服务组的列表例如常驻组

4.4.8.6.4 调用流

4.4.8.7 活动流组列表按组获取

4.4.8.6.1 接口方法

4.4.8.6.2 前置条件

流模块初始化

4.4.8.6.3 描述

要获取特定服务组的所有流媒体服务列表，应用程序应使用getStreamingServiceListByGroup（）。有关服务组的更多信息，请参见第4.4.8.5节

4.4.8.6.4 调用流