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.6.1.2 Prerequisites
  - 5.4.6.1.3 Description
  - 5.4.6.1.4 Call flows
- 5.4.6.2 Get available file list
- - 5.4.6.2.1 Interface functions
  - 5.4.6.2.2 Prerequisites
  - 5.4.6.2.3 Description
  - 5.4.6.2.4 Call flows
- 5.4.6.3 Get running File Delivery services
- - 5.4.6.3.1 Interface functions
  - 5.4.6.3.2 Prerequisites
  - 5.4.6.3.3 Description
  - 5.4.6.3.4 Call flows
- 5.4.6.4 Get camped group
- - 5.4.6.4.1 nterface functions
  - 5.4.6.4.2 Prerequisites
  - 5.4.6.4.3 Description
  - 5.4.6.4.4 Call flows
- 5.4.6.5 Get File Delivery group list
- - 5.4.6.5.1 Interface functions
  - 5.4.6.5.2 Prerequisites
  - 5.4.6.5.3 Description
  - 5.4.6.5.4 Call flows
- 5.4.6.6 Get File Delivery service list by group
- - 5.4.6.6.1 Interface functions
  - 5.4.6.6.2 Prerequisites
  - 5.4.6.5.3 Description
  - 5.4.6.6.4 Call flows
- 5.4.6.7 Get active file download state list
- - 5.4.6.7.1 Interface functions
  - 5.4.6.7.2 Get active file download state list
  - 5.4.6.7.3 Description
  - 5.4.6.7.4 Call flows

5.4.6 Information calls

5.4.6.1 Get service list

5.4.6.1.1 Interface functions

Map<Integer, FDService> getFileDeliveryServiceList ();

5.4.6.1.2 Prerequisites

文件传递模块连接初始化

5.4.6.1.3 Description

要获得可用的文件交付服务的列表，应用程序应该使用getFileDeliveryServiceList()。返回值有服务的列表和相应的服务ID。
getFileDeliveryServiceList()提供所有服务组中的所有服务的列表。关于服务组的更多信息，见第5.4.6.4节。
有关代码示例，请参见第A.4.1节。

5.4.6.1.4 Call flows

5.4.6.2 Get available file list

5.4.6.2.1 Interface functions

List<FDFile> getAvailableFileList (int serviceId);

5.4.6.2.2 Prerequisites

文件传递模块连接初始化

5.4.6.2.3 Description

要获得已经被文件传递服务下载的可用文件的列表，应用程序应该使用getAvailableFileList()。返回值是可用文件的列表。

5.4.6.2.4 Call flows

5.4.6.3 Get running File Delivery services

5.4.6.3.1 Interface functions

List<Integer> getRunningFileDeliveryService ();

5.4.6.3.2 Prerequisites

文件传递模块连接初始化

5.4.6.3.3 Description

要获得有活动文件下载的文件交付服务的列表，应用程序应该使用getRunningFileDeliveryService()。返回值有服务ID的列表。

5.4.6.3.4 Call flows

5.4.6.4 Get camped group

5.4.6.4.1 nterface functions

GroupItem getCampedGroup();
getCampedGroup() returns the GroupItem object which contains the following member variables:
String groupName;
List<Integer> serviceAreaIdList;
List<Integer> serviceHandleList;

成员变量groupName是当前营建的网络类型的名称。serviceHandleList是流媒体服务的列表，这些服务在该组的serviceAreaIdList中列出的服务区是可用/有效的。

5.4.6.4.2 Prerequisites

添加文件传递模块事件监听器

5.4.6.4.3 Description

UE可能能够访问在给定地理位置的多个频率载体上广播的服务，即使它可能在一个频率上驻扎。
驻扎频率上的服务被称为驻扎组。同样，UE可以访问的所有频率上的服务可以按频率分组为多个服务组。因此，一个营建组是所有服务组的相同或子集。
服务组是UE可以并发访问的一组服务。营地组中的服务可以立即访问，而不需要UE切换/获取另一个频率载体。
为了从MSDC获得营地组的信息，应用程序应该使用getCampedGroup()。其返回值定义如下。

组名
服务区ID列表 - 服务手柄列表
注意。
如果应用程序试图访问营地组以外的服务，会有一个额外的延迟。- 在应用程序的多视图用户界面中，不能显示来自不同服务组的服务。

5.4.6.4.4 Call flows

5.4.6.5 Get File Delivery group list

5.4.6.5.1 Interface functions

List< GroupItem > getFileDeliveryGroupList ()
getFileDeliveryGroupList() returns the list of available groups (GroupItem) where File Delivery
services are available. Each GroupItem class contains the following member variables:
String groupName;
List<Integer> serviceAreaIdList;
List<Integer> serviceHandleList;

成员变量groupName是当前营的网络类型的名称。serviceHandleList是文件传送服务的列表，这些服务在该组的serviceAreaIdList中列出的服务区是可用/有效的。

5.4.6.5.2 Prerequisites

添加文件传递模块事件监听器

5.4.6.5.3 Description

要获得除已入营组以外的所有服务组的列表（见5.4.6.4节），应用程序应该使用getFileDeliveryGroupList()。返回值有除已入营组以外的服务组列表。

5.4.6.5.4 Call flows

5.4.6.6 Get File Delivery service list by group

5.4.6.6.1 Interface functions

Map <Integer, FDService> getFileDeliveryServiceListByGroup(String groupName)

5.4.6.6.2 Prerequisites

添加文件传递模块事件监听器

5.4.6.5.3 Description

To get the list of all File Delivery services for a particular service group, the app should use getFileDeliveryServiceListByGroup(). For more information on service groups, see Section 5.4.6.4.

5.4.6.6.4 Call flows

5.4.6.7 Get active file download state list

5.4.6.7.1 Interface functions

public Map<String, Enum<ActiveFileDownloadState>>
getActiveFileDownloadInfoList(int serviceHandle, String fileUri);

5.4.6.7.2 Get active file download state list

添加文件传递模块事件监听器

5.4.6.7.3 Description

要获得活动文件下载状态的列表，应用程序应该使用getActiveFileDownloadInfoList()。返回值有文件URI地图和所请求服务的相应状态。
如果应用程序没有指定任何文件URI，该地图包含所请求服务的所有活动文件的状态。如果应用程序请求一个特定文件URI的状态，返回的地图将根据请求的文件URI和服务ID进行过滤。
/exampples/
这个函数的结果可用于确定所请求的文件是否仍在进行中，或是否已被BM-SC取消。假设应用程序开始对F1（列在文件URI列表中）进行捕获。后来，应用程序收到服务列表的更新，说F1已经不在了。在服务列表更新中，F1可以从文件URI列表中删除，原因如下。

F1计划过期
F1计划被BM-SC取消了
在F1从服务列表更新中被删除后，应用程序可以检查F1的状态，以确保文件下载仍在进行，并等待文件修复。

5.4.6.7.4 Call flows