UnityWebRequest 高级API常用的操作

1. 接收文件或二进制数据

从标准的Http或Https服务端接收简单的文本或二进制数据,可以使用UnityWebRequest.GET方法。这个方法只需要传入获取数据的服务端URL即可。这个功能和标准的WWW的构造方法类似,如下面代码所示:

WWW myWww = new WWW("http://www.myserver.com/foo.txt");
// ... is analogous to ...
UnityWebRequest myWr = UnityWebRequest.Get("http://www.myserver.com/foo.txt");

上面代码的详细流程是这样的:

  • 创建一个UnityWebRequest对象,并设置目标URL做为字符串参数,但是没有设置自定义的数据和包头信息
  • UnityWebRequest会默认绑定一个标准的DownloadHandlerBuffer对象,当请求完成之后,这个Handler缓存从服务端接收到的数据,这些数据可以在代码中直接使用。
  • UnityWebRequest默认不会绑定一个UploadHandler对象,如果你需要的话,可以手动操作。

完整的例子如下所示:

using UnityEngine;
using System.Collections;
using UnityEngine.Networking;
 
public class MyBehaviour : MonoBehaviour {
    void Start() {
        StartCoroutine(GetText());
    }
 
    IEnumerator GetText() {
        UnityWebRequest www = UnityWebRequest.Get("http://www.my-server.com");
        yield return www.SendWebRequest();
 
        if(www.isNetworkError || www.isHttpError) {
            Debug.Log(www.error);
        }
        else {
            // 接收文本数据,并打印到日志中
            Debug.Log(www.downloadHandler.text);
 
            // 接收二进制数据
            byte[] results = www.downloadHandler.data;
        }
    }
}

2. 接收Texture

 可以使用UnityWebRequest.Texture方法,从远程服务端获取一个Texture文件。这个功能和UnityWebRequest.GET方法非常类似,但是它对下载和存储Texture文件做了优化,提高了处理效率。UnityWebRequest.Texture同样需要一个字符串参数,这个参数就是要下载的资源的URL地址。

详细的处理过程是这样的:

 

  • 创建一个UnityWebRequest对象,并设置目标URL做为字符串参数,但是没有设置自定义的数据和包头信息
  • UnityWebRequest会默认绑定一个标准的DownloadHandlerTexture对象,DownloadHandlerTexture是一个特定的Download Handler,它会优化在Unity引擎中使用的图片的存储,相对来说,在下载二进制数据和创建在代码中手动创建Texture对象时,它可以大大的减少内存的再分配。
  • UnityWebRequest默认不会绑定一个UploadHandler对象,如果你需要的话,可以手动操作。

完整的例子如下所示:

using UnityEngine;
using System.Collections;
using UnityEngine.Networking;
 
public class MyBehaviour : MonoBehaviour {
    void Start() {
        StartCoroutine(GetTexture());
    }
 
    IEnumerator GetTexture() {
        UnityWebRequest www = UnityWebRequestTexture.GetTexture("http://www.my-server.com/image.png");
        yield return www.SendWebRequest();

        if(www.isNetworkError || www.isHttpError) {
            Debug.Log(www.error);
        }
        else {
//获取并创建Texture Texture myTexture
= ((DownloadHandlerTexture)www.downloadHandler).texture; } } }

另外,也可以使用一个工具类,从UnityWebRequest中读取Texture,如下所示:

IEnumerator GetTexture() {
        UnityWebRequest www = UnityWebRequestTexture.GetTexture("http://www.my-server.com/image.png");
        yield return www.SendWebRequest();
     //获取Texture对象
        Texture myTexture = DownloadHandlerTexture.GetContent(www);
    }

3. 下载AssetBundle

 

   可以使用UnityWebRequest.GetAssetBundle方法,从远程服务器下载一个AssetBundle,这个方法会在工作线程中,将下载的数据流解码,解压缩,并放到一个内部的buffer之中。这个方法有多种的参数形式,最简单的方式它只需要一个下载AssetBundle文件的URL地址,你也可以选择性的对下载的数据进行checksum校验数据的完整性。另外,如果你想使用AssetBundle的缓存系统,你需要提供一个版本号或一个128位的Hash结构,这和旧系统中WWW.LoadFromCacheOrDownload提供的版本号和128位Hash对象是一样的。

详细的处理过程是这样的:

  • 这个方法会创建一个UnityWebRequest,并且设置目标URL和指定Http Get行为,不会再设置其它的标记或自定义包头数据。
  • 这个方法会给UnityWebRequest绑定一个DownloadHandlerAssetBundle对象,这个下载Handler有一个特殊的assetBundle属性,它可以保证从下载的数据中,一次性提取出一个完整的AssetBundle,并解码成AssetBundle对象,可以访问这个AssetBundle中的资源。
  • 如果你提供一个128位的Hash对象或一个版本号做为参数,这些参数也会被传到DownloadHandlerBundle中,这个下载Handler然后就会使用缓存系统

下面是一个完整的例子:

 

using UnityEngine;
using UnityEngine.Networking;
using System.Collections;
 
public class MyBehaviour : MonoBehaviour {
    void Start() {
        StartCoroutine(GetAssetBundle());
    }
 
    IEnumerator GetAssetBundle() {
        UnityWebRequest www = UnityWebRequest.GetAssetBundle("http://www.my-server.com/myData.unity3d");
        yield return www.SendWebRequest();
 
        if(www.isNetworkError || www.isHttpError) {
            Debug.Log(www.error);
        }
        else {
            AssetBundle bundle = DownloadHandlerAssetBundle.GetContent(www);
        }
    }
}

 

4. 向服务端发送form数据

  在UnityWebRequest中,有两种基本的方法可以向服务端发送HTML form格式的数据,在web开发中,这种方式叫提交一个表单数据。

第一种方式:使用 IMultipartFormSection

为了更好的控制form数据,UnityWebRequest系统提供了一个用户可以实现的接口:IMultipartFormSection,对于一般的应用程序,Unity也提供了两个默认实现的类,MultipartFormDataSection,用于提交form表单数据,MultipartFormFileSection,用于上传文件。

 

 UnityWebRequest.POST的一个重载方式,接收一个List参数,做为该方法的第二个参数,但是这个List的成员必须是IMultipartFormSections的子类,如下面代码所示:

UnityWebRequest.Post(string url, List<IMultipartFormSection> formSections);

详细过程是这样的:

  • 这个方法会创建一个新的UnityWebRequest对象,并设置目标URL做为第一个参数,也可以给这次本提交的IMultipartFormSection 列表form数据在Header中设置合适的Content-Type值。
  • 这个方法默认会给UnityWebRequest绑定一个DownloadHandlerBuffer,这样做是为了方便获取服务器响应的数据。
  • 和WWWForm Post方法类型,这个HLAPI方法也是按顺序调每一个IMultipartFormSection ,将它们组装成一个符合RFC 2616标准的multipart form格式的数据。
  • 这些预定义好的Form数据会被存储在UploadHanlderRaw对象中,然后把这个对象绑定到UnityWebRequest中,所以,当调用UnityWebRequest.POST方法之后,再修改IMultipartFormSection 对象的数据,将不会影响到发送给服务器的数据。

如下面代码所示:

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

public class MyBehavior : MonoBehaviour
{
    void Start()
    {
        StartCoroutine(Upload());
    }

    IEnumerator Upload()
    {
        List<IMultipartFormSection> formData = new List<IMultipartFormSection>();
        formData.Add(new MultipartFormDataSection("field1=foo&field2=bar"));
        formData.Add(new MultipartFormFileSection("my file data", "myfile.txt"));

        UnityWebRequest www = UnityWebRequest.Post("http://www.my-server.com/myform", formData);
        yield return www.SendWebRequest();

        if (www.isNetworkError || www.isHttpError)
        {
            Debug.Log(www.error);
        }
        else
        {
            Debug.Log("Form upload complete!");
        }
    }
}

 第二种方式使用WWWForm(遗留的方法)

为了方便从 WWW 系统中迁移,UnityWebRequest允许你使用WWWForm 对象提供form数据,如下面代码所示:

UnityWebRequest.Post(string url, WWWForm formData);

详细过程是这样的:

  • 这个方法会创建一个新的UnityWebRequest对象,并设置目标URL做为第一个参数,它也会读取WWWForm中自定义的包头信息,并将它们复制到UnityWebRequest中
  • 这个方法默认会给UnityWebRequest绑定一个DownloadHandlerBuffer,这样做是为了方便获取服务器响应的数据。
  • 这个方法会读取WWWForm对象中原始的数据,并将它们缓存到一个UploadHandlerRaw对象中,然后将它绑定到UntiyWebRequest中,因此,在调用UnityWebRequest.POST方法之后,再修改原来WWWForm中的数据,将不会改变UntiyWebRequest中的内容。

如下面例子所示:

using UnityEngine;
using UnityEngine.Networking;
using System.Collections;
 
public class MyBehavior : public MonoBehaviour {
    void Start() {
        StartCoroutine(Upload());
    }
 
    IEnumerator Upload() {
        WWWForm form = new WWWForm();
        form.AddField("myField", "myData");
 
        UnityWebRequest www = UnityWebRequest.Post("http://www.my-server.com/myform", form);
        yield return www.SendWebRequest();
 
        if(www.isNetworkError || www.isHttpError) {
            Debug.Log(www.error);
        }
        else {
            Debug.Log("Form upload complete!");
        }
    }
}

 

转载于:https://www.cnblogs.com/wgslucky/p/11523575.html

表情包
插入表情
评论将由博主筛选后显示,对所有人可见 | 还能输入1000个字符
相关推荐
©️2020 CSDN 皮肤主题: 编程工作室 设计师:CSDN官方博客 返回首页