文档

Unity 引擎

Unity 引擎

Web 请求低级 API 参考

使用关卡 Web 请求 API 执行更高级的 HTTP 操作。
阅读时间6 分钟最后更新于 5 天前

虽然高级关卡 Web 请求 API 最大限度地减少了对样板代码的需求,但低级关卡 Web 请求 API 提供了更多灵活性和 Control。
本部分列出了低级 API 的 Key 成员及其目标场景。一般来说,使用低级 API 涉及创建一个
UnityWebRequest
,您可以为特定 Download 和 Upload 案例附加专用
DownloadHandler
或
UploadHandler
对象。
高和关卡 API 并不相互排斥。如果需要对常见操作进行更多控制,可以随时自定义通过高级关卡 API 创建的
UnityWebRequest
对象。

实例化 UnityWebRequest 对象

UnityWebRequest
可以像任何其他对象一样通过其构造函数实例化。有几个构造函数签名可用于创建具有或不具有 Upload 或 Download 处理程序的
UnityWebRequest
。
UnityWebRequest
还有用于配置请求、跟踪其状态和检查结果的 Properties。
如需了解更多信息,请参阅
UnityWebRequest
API 参考。

Download处理程序

Specialist Download 处理程序允许您手柄指定的 Download 案例并控制 Incoming 数据的处理。以下 Download 处理程序可用,它们全都专门指定底部
DownloadHandler
类:

处理程序类型

描述

DownloadHandlerBuffer
用于Simple的数据存储。此下载处理程序程序是最简单的,可以处理大多数使用。它将收到的数据存储在原生代码缓冲区中。Download完成When,您可以将缓冲数据访问为字节数Array或文本字字符串。
DownloadHandlerFile
专用下载处理程序,用于将大文件下载并保存到内存占用低的磁盘。它将下载的字节直接写入文件,因此无论下载的文件的大小如何,Memory Usage量都低。与OtherDownload处理程序的不同之处在于,可以从保存的文件而不是从处理程序程序本身检索数据。
DownloadHandlerTexture
专门下载处理程序,针对下载图像以用作 Unity 纹理对象进行了优化。这是使用
DownloadHandlerBuffer
下载图像文件,然后使用
Texture.LoadImage
从原始字节创建纹理的更有效替代方法。
DownloadHandlerAssetBundle
专为下载 Unity AssetBundles 而优化的专用下载处理程序。它可以将数据直接流式传输到 Unity 的资源系统并作为结果生成一个
AssetBundle
对象。
DownloadHandlerAudioClip
专为下载音频文件而优化的专用下载处理程序。这是使用
DownloadHandlerBuffer
下载原始字节然后从中创建
AudioClip
的更有效替代方法。
DownloadHandlerScript
用于自定义可编程
DownloadHandler
实现的抽象底部类。从该类继承以接收来自
UnityWebRequest
System 的回调,您可以使用这些回调在数据从网络到达时对数据进行自定义处理。
UnityWebRequest
有一个
UnityWebRequest.disposeDownloadHandlerOnDispose
属性,默认为 true。如果此属性为 true,则对
UnityWebRequest.Dispose
的 Calls 也会调用所挂的下载处理程序的 ON
DownloadHandler.Dispose
。如果保持对下载处理程序的引用时间超过对关联
UnityWebRequest
的引用时间,请将
disposeDownloadHandlerOnDispose
设置为 false。

Upload处理程序

Upload处理程序允许您更DetailedControlUpload过程的各个方面。以下 Upload 处理程序可用,它们全都专门指定底部
UploadHandler
类:

处理程序类型

描述

UploadHandlerRaw
在构建时间接受数据缓冲区。当此缓冲区为字节数组时,将在内部复制到原生代码内存中。当远程 Server 准备好接收请求正文数据时,
UnityWebRequest
System 会使用此缓冲区。当缓冲区作为
NativeArray
提供时,不执行复制。
UploadHandlerFile
允许将文件内容作为请求正文发送。使用此处理程序,可以将大文件发送到 Server,而无需使用大量内存。由于处理程序程序不断从文件读取数据,然后发送数据,因此在Any给定时间,只有一小部分文件保留在内存中。
UploadHandler.contentType
属性的值用于 Web 请求的
Content-Type
标头的值(如果未直接 ON
UnityWebRequest
本身)。如果您确实设置了
UnityWebRequest
Object 的
Content-Type
标头,则上传处理程序 Object 的
Content-Type
将被忽略。如果未在
UnityWebRequest
或
UploadHandler
上设置
Content-Type
,则 System 默认设置
application/octet-stream``Content-Type
。
UnityWebRequest
有一个
disposeUploadHandlerOnDispose
,默认为 true。如果此属性为 true,则对
UnityWebRequest.Dispose
的 Calls 也会调用所挂的上传处理程序的 ON
UploadHandler.Dispose
。如果保持对上传处理程序的引用时间超过对
UnityWebRequest
的引用时间,请将
disposeUploadHandlerOnDispose
设置为 false。

其他资源