Version: 2022.1

DownloadHandler

class in UnityEngine.Networking

切换到手册

描述

管理和处理从远程服务器接收的 HTTP 响应体数据。

DownloadHandler 对象是 helper 对象。附加到 UnityWebRequest 后,它们会定义如何处理从远程服务器接收的 HTTP 响应体数据。通常,它们用于缓冲、流式传输和/或处理响应体。

DownloadHandler 是一个基类。可用的不同专门类将因使用场景而异。对于 TextureAssetBundle 下载,DownloadHandlerBuffer 提供基本缓冲,而 DownloadHandlerTextureDownloadHandlerAssetBundle 提供了更高效的解决方案。

有关自定义用例,请参阅 DownloadHandlerScript

另请参阅:UnityWebRequestDownloadHandlerBufferDownloadHandlerTextureDownloadHandlerAudioClipDownloadHandlerAssetBundleDownloadHandlerScript

变量

data返回从远程服务器下载的原始字节,或 null。(只读)
errorError message describing a failure that occurred inside the download handler.
isDone如果此 DownloadHandler 的父 UnityWebRequest 已通知它已接收所有数据,且此 DownloadHandler 已完成所有必要的下载后处理操作,则返回 true。(只读)
nativeDataProvides direct access to downloaded data.
text便捷属性。返回解释为 UTF8 字符串的 data 中的字节。(只读)

公共函数

Dispose表示不再使用此 DownloadHandler,并且应清理它使用的所有资源。

受保护的函数

CompleteContent在从远程服务器接收所有数据后调用的回调。
GetData访问 data 属性时调用的回调。
GetNativeDataProvides allocation-free access to the downloaded data as a NativeArray.
GetProgress访问 UnityWebRequest.downloadProgress 时调用的回调。
GetText访问 text 属性时调用的回调。
ReceiveContentLengthHeader在收到 Content-Length 标头调用的回调。
ReceiveData从远程服务器收到数据时调用的回调。