创建上传处理器

多人游戏

创建下载处理器

存在几种类型的 DownloadHandlers

DownloadHandlerBuffer 适用于简单的数据存储。
DownloadHandlerFile 用于将文件下载到磁盘并使用低内存占用。
DownloadHandlerTexture 用于下载图像。
DownloadHandlerAssetBundle 用于获取AssetBundles。
DownloadHandlerAudioClip 用于下载音频文件。
DownloadHandlerMovieTexture 用于下载视频文件。由于MovieTexture已被弃用，因此建议您使用 VideoPlayer 来进行视频下载和电影播放。
DownloadHandlerScript 是一个特殊类。它本身并不做什么。然而，这个类可以被用户定义的类继承。这个类从UnityWebRequest系统接收回调，然后可以用来执行来自网络数据的完全自定义处理。

API与DownloadHandlerTexture的接口相似。

UnityWebRequest有一个属性disposeDownloadHandlerOnDispose，默认值为true。如果这个属性为true，当UnityWebRequest对象被处置时，还会在附着的下载处理器上调用Dispose()，使其变得无用。如果您保持对下载处理器的引用时间比UnityWebRequest的引用时间更长，应将disposeDownloadHandlerOnDispose设置为false。

DownloadHandlerBuffer

这是一个最简单的下载处理器，适用于大多数用例。它将接收到的数据存储在本地代码缓冲区中。下载完成后，您可以以字节数组或文本字符串的形式访问缓冲数据。

示例

using UnityEngine;
using UnityEngine.Networking;
using System.Collections;


public class MyBehaviour : MonoBehaviour {
    void Start() {
        StartCoroutine(GetText());
    }

    IEnumerator GetText() {
        UnityWebRequest www = new UnityWebRequest("https://www.my-server.com");
        www.downloadHandler = new DownloadHandlerBuffer();
        yield return www.SendWebRequest();

        if (www.result != UnityWebRequest.Result.Success) {
            Debug.Log(www.error);
        }
        else {
            // Show results as text
            Debug.Log(www.downloadHandler.text);

            // Or retrieve results as binary data
            byte[] results = www.downloadHandler.data;
        }
    }
}

DownloadHandlerFile

这是一个适用于大文件的特殊下载处理器。它将下载的字节直接写入文件，因此不管下载的文件大小如何，内存使用量都很低。与其他下载处理器相比的区别是，您不能从中获取数据，所有数据都保存到文件中。

示例

using System.Collections;
using System.IO;
using UnityEngine;
using UnityEngine.Networking;

public class FileDownloader : MonoBehaviour {

    void Start () {
        StartCoroutine(DownloadFile());
    }

    IEnumerator DownloadFile() {
        var uwr = new UnityWebRequest("https://unity3d.com/", UnityWebRequest.kHttpVerbGET);
        string path = Path.Combine(Application.persistentDataPath, "unity3d.html");
        uwr.downloadHandler = new DownloadHandlerFile(path);
        yield return uwr.SendWebRequest();
        if (uwr.result != UnityWebRequest.Result.Success)
            Debug.LogError(uwr.error);
        else
            Debug.Log("File successfully downloaded and saved to " + path);
    }
}

DownloadHandlerTexture

使用DownloadHandlerBuffer下载图像文件然后使用Texture.LoadImage从原始字节创建纹理，使用DownloadHandlerTexture更高效。

这个下载处理器将接收到的数据存储在UnityEngine.Texture中。 download完成后，它将JPEG和PNG解码成有效的UnityEngine.Texture对象。每个DownloadHandlerTexture对象只创建一个UnityEngine.Texture副本。这减少了垃圾回收的性能影响。该处理器在本地代码中执行缓冲、解压缩和纹理创建。另外，解压缩和纹理创建在工作线程上而不是主线程上执行，这可以在加载大型纹理时提高帧时间。

最后，仅在最终创建纹理本身时，DownloadHandlerTexture才会分配托管内存，这消除了与脚本中执行字节到纹理转换相关的垃圾回收开销。

示例

以下示例从互联网下载PNG文件，将其转换为 Sprite一个2D图形对象。如果您习惯于3D工作，Sprite本质上是标准的纹理，但在开发过程中有特殊的技巧来提高效率和便利性。更多信息
在词汇表中查看，并将其分配给一个图像

using UnityEngine;
using UnityEngine.UI;
using UnityEngine.Networking;
using System.Collections;

[RequireComponent(typeof(Image))]
public class ImageDownloader : MonoBehaviour {
    Image _img;

    void Start () {
        _img = GetComponent<UnityEngine.UI.Image>();
        Download("https://www.mysite.com/myimage.png");
    }

    public void Download(string url) {
        StartCoroutine(LoadFromWeb(url));
    }

    IEnumerator LoadFromWeb(string url)
    {
        UnityWebRequest wr = new UnityWebRequest(url);
        DownloadHandlerTexture texDl = new DownloadHandlerTexture(true);
        wr.downloadHandler = texDl;
        yield return wr.SendWebRequest();
        if (wr.result == UnityWebRequest.Result.Success) {
            Texture2D t = texDl.texture;
            Sprite s = Sprite.Create(t, new Rect(0, 0, t.width, t.height),
                Vector2.zero, 1f);
            _img.sprite = s;
        }
    }
}

DownloadHandlerAssetBundle

这种专业的下载处理器的优势在于它可以将数据流式传输到Unity的AssetBundle系统中。一旦AssetBundle系统接收到了足够的数据，AssetBundle就以UnityEngine.AssetBundle对象的形式可用。只创建一个UnityEngine.AssetBundle对象。这大大减少了运行时内存分配以及加载AssetBundle的内存影响。此外，它还允许AssetBundles在未完全下载的情况下部分使用，从而可以流式传输资源。

所有下载和解压缩操作都在工作线程上执行。

AssetBundles通过DownloadHandlerAssetBundle对象下载，该对象具有专门的assetBundle属性来检索AssetBundle。

由于AssetBundle系统的工作方式，所有AssetBundle都必须与一个地址相关联。通常，这是它们所在的名义URL（这意味着重定向之前的URL）。在几乎所有情况下，您都应该传递与您传递给UnityWebRequest相同的URL。在高级别API一个用于为Unity游戏构建多人游戏功能系统。它建立在低级别传输实时通信层之上，并处理许多多人游戏所需的常见任务。更多信息
在术语表中查看 (HLAPI)中使用时，这项工作会自动完成。

示例

using UnityEngine;
using UnityEngine.Networking;
using System.Collections;

public class MyBehaviour : MonoBehaviour {
    void Start() {
        StartCoroutine(GetAssetBundle());
    }

    IEnumerator GetAssetBundle() {
        UnityWebRequest www = new UnityWebRequest("https://www.my-server.com");
        DownloadHandlerAssetBundle handler = new DownloadHandlerAssetBundle(www.url, uint.MaxValue);
        www.downloadHandler = handler;
        yield return www.SendWebRequest();

        if (www.result != UnityWebRequest.Result.Success) {
            Debug.Log(www.error);
        }
        else {
            // Extracts AssetBundle
            AssetBundle bundle = handler.assetBundle;
        }
    }
}

DownloadHandlerAudioClip

这个下载处理器针对音频文件的下载进行了优化。您可以使用这个下载处理器以更方便的方式下载，而不是使用DownloadHandlerBuffer下载原始字节数据，然后再从中创建AudioClip。

示例

using System.Collections;
using UnityEngine;
using UnityEngine.Networking;

public class AudioDownloader : MonoBehaviour {

    void Start () {
        StartCoroutine(GetAudioClip());
    }

    IEnumerator GetAudioClip() {
        using (var uwr = UnityWebRequestMultimedia.GetAudioClip("https://myserver.com/mysound.ogg", AudioType.OGGVORBIS)) {
            yield return uwr.SendWebRequest();
            if (uwr.result != UnityWebRequest.Result.Success) {
                Debug.LogError(uwr.error);
                yield break;
            }

            AudioClip clip = DownloadHandlerAudioClip.GetContent(uwr);
            // use audio clip
        }
    }
}

DownloadHandlerScript

对于需要完全控制下载数据处理的用户，Unity提供了DownloadHandlerScript类。

默认情况下，这个类的实例不执行任何操作。但是，如果您从DownloadHandlerScript派生自己的类，您可以覆盖某些函数，并使用它们在数据从网络到达时接收回调。

注意：实际的下载在工作线程上执行，但所有DownloadHandlerScript回调操作都在主线程上。在这些回调期间避免执行计算量大的操作。

要重载的函数

ReceiveContentLength()

protected void ReceiveContentLength(long contentLength);

当接收到Content-Length标头时，会调用此函数。请注意，如果您的服务器在处理UnityWebRequest的过程中发送一个或多个重定向响应，这个回调可能发生多次。

OnContentComplete()

protected void OnContentComplete();

当UnityWebRequest已经从服务器完全下载所有数据，并将接收到的所有数据转发到ReceiveData回调时，会调用此函数。

ReceiveData()

protected bool ReceiveData(byte[] data, long dataLength);

在从远程服务器接收数据后，会调用此函数，并且每帧调用一次。参数data包含从远程服务器接收的原始字节数据，而dataLength表示数据数组中新数据长度。

当不使用预分配的数据缓冲区时，系统每次调用此回调时都会创建一个新的字节数组，并且dataLength始终等于data.Length。当使用预分配的数据缓冲区时，数据缓冲区会重用，而且必须使用dataLength来查找更新的字节数。

此函数需要返回值为true或false。如果您返回false，则系统会立即终止UnityWebRequest。如果您返回true，则处理会继续正常进行。

避免垃圾回收开销

许多更高级的Unity用户都关注减少由于垃圾收集导致的CPU峰值。对于这些用户，UnityWebRequest系统允许预先分配托管代码的字节数组，该数组用于将下载的数据传递到DownloadHandlerScript的ReceiveData回调。

使用此函数将在使用派生自 DownloadHandlerScript 的类来捕获下载数据时，完全消除托管代码的内存分配。

要使 DownloadHandlerScript 使用预分配的托管缓冲区运行，请向 DownloadHandlerScript 的构造函数提供一个字节数组。

注意： 字节数组的大小限制了每帧传送到 ReceiveData 回调的数据量。如果您的数据很慢地到来，分布到很多帧上，那么您可能提供了一个太小的字节数组。

示例

using UnityEngine;
using UnityEngine.Networking;

public class LoggingDownloadHandler : DownloadHandlerScript {

    // Standard scripted download handler - allocates memory on each ReceiveData callback

    public LoggingDownloadHandler(): base() {
    }

    // Pre-allocated scripted download handler
    // reuses the supplied byte array to deliver data.
    // Eliminates memory allocation.

    public LoggingDownloadHandler(byte[] buffer): base(buffer) {
    }

    // Required by DownloadHandler base class. Called when you address the 'bytes' property.

    protected override byte[] GetData() { return null; }

    // Called once per frame when data has been received from the network.

    protected override bool ReceiveData(byte[] data, int dataLength) {
        if(data == null || data.Length < 1) {
            Debug.Log("LoggingDownloadHandler :: ReceiveData - received a null/empty buffer");
            return false;
        }

        Debug.Log(string.Format("LoggingDownloadHandler :: ReceiveData - received {0} bytes", dataLength));
        return true;
    }

    // Called when all data has been received from the server and delivered via ReceiveData.

    protected override void CompleteContent() {
        Debug.Log("LoggingDownloadHandler :: CompleteContent - DOWNLOAD COMPLETE!");
    }

    // Called when a Content-Length header is received from the server.

    protected override void ReceiveContentLengthHeader(ulong contentLength) {
        Debug.Log(string.Format("LoggingDownloadHandler :: ReceiveContentLength - length {0}", contentLength));
    }
}

创建上传处理器

多人游戏

Unity 用户手册

创建下载处理器

DownloadHandlerBuffer

示例

DownloadHandlerFile

示例

DownloadHandlerTexture

示例

DownloadHandlerAssetBundle

示例

DownloadHandlerAudioClip

示例

DownloadHandlerScript

要重载的函数

ReceiveContentLength()

OnContentComplete()

ReceiveData()

避免垃圾回收开销

示例