【专栏精选】Unity中的HTTP网络通信

本文节选自洪流学堂公众号技术专栏《大话Unity2019》，未经允许不可转载。

洪流学堂公众号回复专栏，查看更多专栏文章。

洪流学堂，让你快人几步。你好，我是郑洪智。

大智：“小新，今天开始，我们来学习Unity中的HTTP通信。”
小新：“为啥不先学Tcp和Udp呢？这俩不是基础么？”
大智：“虽然这俩是基础，但是难度也更大。Http是应用层协议，使用起来会比较方便，可以快速入门。”

Unity中的HTTP编程

Unity中的HTTP通信主要依赖的是Unity自带的UnityWebRequest类（虽然也有一些第三方插件，但一般使用这个就足够了）。

小新：“UnityWebRequest类我们之前学过呀，是不是复习一下就行啦”
大智：“之前我们使用UnityWebRequest类主要用file协议来加载本地的文件，和真正的HTTP请求还有所不同。”

我们用一个最简单的HTTP请求，来学习整个请求的流程。

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

public class UnityPageRequest : MonoBehaviour
{
    // Start is called before the first frame update
    IEnumerator Start()
    {
        var url = "https://www.baidu.com";
        var www = UnityWebRequest.Get(url);
        yield return www.SendWebRequest();

        if (www.isHttpError || www.isNetworkError)
        {
            Debug.Log(www.error);
        }
        else
        {
            Debug.Log(www.downloadHandler.text);
        }
    }
}

HTTP是请求-响应模型，所以通信的过程主要分为请求部分和响应部分。

HTTP请求（Request）

客户端发送一个HTTP请求到服务器的请求消息包括以下格式：

请求行（request line）、请求头部（header）、空行和请求数据四个部分组成。

HTTP请求方法

本例中我们使用了UnityWebRequest.Get(url)来获取对应的信息。
这里的Get方法对应了HTTP方法中的GET。

什么是HTTP方法呢？

根据HTTP标准，HTTP请求可以使用多种请求方法。
HTTP1.0定义了三种请求方法： GET, POST 和 HEAD方法。
HTTP1.1新增了五种请求方法：OPTIONS, PUT, DELETE, TRACE 和 CONNECT 方法。

• GET 请求指定的页面信息，并返回实体主体。
• POST 向指定资源提交数据进行处理请求（例如提交表单或者上传文件）。数据被包含在请求体中。POST请求可能会导致新的资源的建立和/或已有资源的修改。
• HEAD 类似于get请求，只不过返回的响应中没有具体的内容，用于获取报头
• PUT 从客户端向服务器传送的数据取代指定的文档的内容。
• DELETE 请求服务器删除指定的页面。
• CONNECT HTTP/1.1协议中预留给能够将连接改为管道方式的代理服务器。
• OPTIONS 允许客户端查看服务器的性能。
• TRACE 回显服务器收到的请求，主要用于测试或诊断。

通常我们用的比较多的是GET和POST方法。GET一般用来获取信息，POST一般用来向服务器上传信息，比如表单、文件等。

UnityWebRequest类中封装了几种HTTP方法的高级操作：

• GET对应UnityWebRequest.Get
• POST对应UnityWebRequest.Post
• HEAD对应UnityWebRequest.Head
• PUT对应UnityWebRequest.Put
• DELETE对应UnityWebRequest.Delete

此外，还能使用底层的API来手动创建UnityWebRequest。

URL

上面的几行代码请求了https://www.baidu.com这一URL对应的资源，返回的数据是一个html文件的文本内容。

URL我们上一节中学过，它是一个资源地址，就本例来说：

1. 协议部分：该URL的协议部分为“https：”，这代表网页使用的是HTTPS协议，S代表Secure，安全的，是一种加密传输的HTTP协议，在"https"后面的“//”为分隔符。
2. 域名部分：该URL的域名部分为“www.baidu.com”。一个URL中，也可以使用IP地址作为域名使用
3. 端口部分：端口不是一个URL必须的部分，如果省略，将采用默认端口80。本例中就省略了端口号。
4. 虚拟目录部分：从域名后的第一个“/”开始到最后一个“/”为止，是虚拟目录部分。虚拟目录也不是一个URL必须的部分。本例中的虚拟目录是根目录“/”
5. 文件名部分：文件名部分也不是一个URL必须的部分，可以在服务端配置和开发。

如果你不参与服务端开发的话，一般只需要知道URL地址是什么就可以了。

HTTP headers（头部）

请求头部经常用来设置请求的一些属性参数。

比如我们想告诉服务器给我们返回json格式的数据，通常要设置：

Content-type:application/json

在Unity中需要这么设置：

www.SetRequestHeader("Content-Type", "application/json");

请求数据

有些请求方法如POST和PUT还可以携带请求数据，通常用于上传文件。

在Unity中，请求数据通常以这种方式添加，例如上传一张图片：

IEnumerator UploadTexture()
{
    var tex = new Texture2D(1,1);
    tex.ReadPixels(new Rect(0, 0, Screen.width, Screen.height), 0, 0);
    tex.Apply();
    // tex.Apply() 对性能影响较大，故等待一帧再执行
    yield return null;
    var bytes = tex.EncodeToPNG();
    var form = new WWWForm();
    form.AddBinaryData("screenshot", bytes);
    var www = UnityWebRequest.Post("server url", form);
    yield return www.SendWebRequest();
    // ...
}

HTTP响应（Response）

Http请求的结果都是字节流。

那么为什么我们能看到在浏览器上有的能呈现文字，还有图片、视频呢？

这是因为响应结果中都有Content-Type报头，浏览器会根据报头来解析接收到的数据，显示为不同的内容。

HTTP状态码

HTTP响应的第一行会显示使用的协议以及状态码。

状态代码有三位数字组成，第一个数字定义了响应的类别，共分五种类别:

• 1xx：指示信息–表示请求已接收，继续处理
• 2xx：成功–表示请求已被成功接收、理解、接受
• 3xx：重定向–要完成请求必须进行更进一步的操作
• 4xx：客户端错误–请求有语法错误或请求无法实现
• 5xx：服务器端错误–服务器未能实现合法的请求

常见状态码：

• 200 OK //客户端请求成功
• 400 Bad Request //客户端请求有语法错误，不能被服务器所理解
• 401 Unauthorized //请求未经授权，这个状态代码必须和WWW-Authenticate报头域一起使用
• 403 Forbidden //服务器收到请求，但是拒绝提供服务
• 404 Not Found //请求资源不存在，eg：输入了错误的URL
• 500 Internal Server Error //服务器发生不可预期的错误
• 503 Server Unavailable //服务器当前不能处理客户端的请求，一段时间后可能恢复正常

在Unity中可以使用如下代码获取状态码：

Debug.Log(www.responseCode);

这个状态码也决定了www.isHttpError的返回值

isHttpError = reponseCode >= 400;

Unity中的HTTP响应

但是在Unity中，UnityWebRequest并没有自动帮我们处理这个过程，我们需要手动来处理。

通常我们使用：

var text = www.downloadHandler.text; // 文本信息，使用UTF8编码解析
var bytes = www.downloadHandler.data; // 字节数组

注意www.downloadHandler.text实际上是自动使用UTF8编码解析了字节数组，如果发送的数据不是采用UTF8编码，需要获取字节数组自行解析。

另外在Unity中，Unity结合游戏开发中的常见需求，也加入了请求图片、音频请求的接口。

请求图片：

IEnumerator RequestTexture()
{
    var url = "https://www.baidu.com/img/bd_logo1.png";
    var www = UnityWebRequestTexture.GetTexture(url);
    yield return www.SendWebRequest();
    Debug.Log("status code:" + www.responseCode);
    if (www.isHttpError || www.isNetworkError)
    {
        Debug.Log(www.error);
    }
    else
    {
        var tex = DownloadHandlerTexture.GetContent(www);
    }
}

请求音频：

IEnumerator RequestMedia()
{
    var url = "https://www.xxx.com/music.ogg";
    var www = UnityWebRequestMultimedia.GetAudioClip(url, AudioType.OGGVORBIS);
    yield return www.SendWebRequest();
    Debug.Log("status code:" + www.responseCode);
    if (www.isHttpError || www.isNetworkError)
    {
        Debug.Log(www.error);
    }
    else
    {
        var audio = DownloadHandlerAudioClip.GetContent(www);
    }
}

请求视频：

目前Unity的VideoPlayer中支持直接从file或http协议直接播放视频，如果你想将这个视频下载到本地，可以使用UnityWebRequest.Get方法获取到所有字节再将字节保存到本地。

请求Assetbundle：

IEnumerator InstantiateObject(string assetBundleName)
{
    string uri = "file:///" + Application.dataPath + "/AssetBundles/" + assetBundleName;
    UnityWebRequest request = UnityWebRequestAssetBundle.GetAssetBundle(uri, 0);
    yield return request.SendWebRequest();
    AssetBundle bundle = DownloadHandlerAssetBundle.GetContent(request);
    GameObject cube = bundle.LoadAsset<GameObject>("Cube");
    GameObject sprite = bundle.LoadAsset<GameObject>("Sprite");
    Instantiate(cube);
    Instantiate(sprite);
}

总结

大智：“Unity有一个旧的Web请求API是WWW，但是对HTTP请求不完善。建议你还是学习新的UnityWebRequest类，拥有更好的性能和更完善的HTTP请求。”

今日思考题

大智：“试一试本文中的这些例子。”
小新：“好嘞！”
大智：“收获别忘了分享出来！也别忘了分享给你学Unity的朋友，也许能够帮到他。”

洪流学堂公众号回复专栏，查看更多专栏文章。

《大话Unity2019》，大智带小新学Unity2019的有趣经历，让你学Unity更简单。