赞
踩
本文节选自洪流学堂公众号技术专栏《大话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方法。GET一般用来获取信息,POST一般用来向服务器上传信息,比如表单、文件等。
UnityWebRequest类中封装了几种HTTP方法的高级操作:
UnityWebRequest.Get
UnityWebRequest.Post
UnityWebRequest.Head
UnityWebRequest.Put
UnityWebRequest.Delete
此外,还能使用底层的API来手动创建UnityWebRequest。
URL
上面的几行代码请求了https://www.baidu.com
这一URL对应的资源,返回的数据是一个html文件的文本内容。
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响应的第一行会显示使用的协议以及状态码。
状态代码有三位数字组成,第一个数字定义了响应的类别,共分五种类别:
常见状态码:
在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的朋友,也许能够帮到他。”
推荐阅读
洪流学堂公众号回复专栏
,查看更多专栏文章。
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。