MSDC 4.3 接口规范（17）

5.4.5.6 文件下载进度暂停
- 5.4.5.6.1 接口函数
- 5.4.5.6.2 先决条件
- 5.4.5.6.3 描述
5.4.5.7 存储不足
- 5.4.5.7.1 接口函数
- 5.4.5.7.2 先决条件
- 5.4.5.7.3 描述
- 5.4.5.7.4 调用流程
5.4.5.8 无法到达的位置
- 5.4.5.8.1 接口函数
- 5.4.5.8.2 先决条件
- 5.4.5.8.3 描述
- 5.4.5.8.4 调用流程
5.4.5.9 其他错误通知
- 5.4.5.9.1 接口函数
5.4.5.9.2 先决条件
- 5.4.5.9.3 描述
5.4.5.9.4 调用流程
5.4.5.10 警告通知
- 5.4.5.10.1 接口函数
- 5.4.5.10.2 先决条件
- 5.4.5.10.3 描述
- 5.4.5.10.4 调用流程

5.4.5.6 文件下载进度暂停

5.4.5.6.1 接口函数

public void fileDownloadProgress (int serviceHandle, String fileUri, Long receivedBytes, Long receivedBytesTarget,Long decodedBytes, Long decodedBytesTarget, int receptionType);
void fileDownloadProgressSuspended(int serviceHandle , String uri);

5.4.5.6.2 先决条件

文件传递模块连接初始化
开始文件捕获

5.4.5.6.3 描述

如果文件下载进度因任何原因停止，应用程序会收到文件下载进度暂停通知。
通知中包含以下信息：

服务ID – 为其捕获文件的文件传递服务的ID。
文件URI – 下载文件的唯一路径标识符。

5.4.5.7 存储不足

5.4.5.7.1 接口函数

public void insufficientStorage(int serviceHandle ,String uri,String path,Long totalStorageNeeded);

5.4.5.7.2 先决条件

文件传递模块连接初始化
开始文件捕获

5.4.5.7.3 描述

如果 MSDC 确定在指定位置没有足够的空间来下载请求的文件，它会通知应用程序不足 Storage()。

5.4.5.7.4 调用流程

5.4.5.8 无法到达的位置

5.4.5.8.1 接口函数

public void insufficientStorage(int serviceHandle ,String uri, String path,Long totalStorageNeeded);

5.4.5.8.2 先决条件

文件传递模块连接初始化

5.4.5.8.3 描述

如果 MSDC 无法访问指定位置来存储下载的文件，它会通过 inaccessibleLocation() 通知应用程序。

5.4.5.8.4 调用流程

5.4.5.9 其他错误通知

5.4.5.9.1 接口函数

void fileDeliveryServiceError(int errorCode,String message, int service Id);

5.4.5.9.2 先决条件

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

5.4.5.9.3 描述

如果 MSDC API 想要通知应用程序任何文件传递服务错误，它会使用 fileDeliveryServiceError()。有关不同类型的错误通知的更多信息，请参阅第 9.4 节。

5.4.5.9.4 调用流程

如果应用程序尝试请求文件传递服务操作，MSDC API 将使用 fileDeliveryServiceError() 和错误代码 ERROR_FD_INVALID_SERVICE_ID 进行响应。

如果文件传递服务不可用，MSDC API 将使用 fileDeliveryServiceError() 和错误代码 ERROR_FD_SERVICE_UNAVAILABLE 以及受影响服务的服务 ID 响应应用程序。

但是，如果所有文件传递服务都不可用，则服务 ID 将为 NULL。

错误代码为 ERROR_FD_SERVICE_RESET 的错误通知告诉应用程序服务相关信息（如服务 ID）已被重置，应用程序应使用 getFileDeliveryServiceList() 获取新的服务信息（参见第 5.4.6.1 节）。

5.4.5.10 警告通知

5.4.5.10.1 接口函数

void fileDeliveryServiceWarning(int warningCode,String message,Integer serviceId);

5.4.5.10.2 先决条件

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

5.4.5.10.3 描述

如果 MSDC API 想要将任何文件传递服务警告通知应用程序，它会使用重载的 fileDeliveryServiceWarning() 通知。

有关不同类型的错误通知的更多信息，请参阅第 9.4 节。

5.4.5.10.4 调用流程

当尝试开始文件下载（例如，S1）时，应用程序可能会收到带有警告代码 WARNING_FD_FREQUENCY_CONFLICT 的错误通知。这意味着另一个应用程序已经在使用文件传递服务（例如，S2），该服务属于与其中包含 S1 的服务组不同的服务组（参见第 5.4.6.4 节）。

这是一个警告，因为如果频率冲突得到解决，MSDC 会继续尝试开始文件下载。如果未解决，则 MSDC 无法开始下载。

如果在应用程序启动文件捕获后文件传递因任何原因停止，应用程序会收到带有警告代码 WARNING_FD_STALLED 的警告通知。

这是一个警告，因为 MSDC 会继续尝试下载文件，以防服务再次可用。如果以后该服务不可用，则 MSDC 无法完成下载。

如果 MSDC 未能将文件复制到指定的存储位置，则会向 UI 应用程序发送带有 WARNING_FD_STORAGE_LOCATION_COPY_FAILED 的警告通知。