Unity Web Request Sending Form

Send HTML form data to a server using the UnityWebRequest form APIs.

阅读时间4 分钟

最后更新于 1 个月前

有两个主要函数可用于将数据作为 HTML 表单格式发送到服务器。如果是从 WWW 系统进行迁移，请参阅下文中的使用 WWWForm。

使用 IMultipartFormSection

为了在更大程度上控制表单数据的指定方式，

UnityWebRequest

系统包含了一个可由用户实现的

IMultipartFormSection

接口。对于标准应用程序，Unity 还提供了数据和文件部分的默认实现：

MultipartFormDataSection

和

MultipartFormFileSection

。

UnityWebRequest.POST

的重载可接受成员必须全部是

IMultipartFormSections

的列表参数（作为第二个参数）。函数签名为：


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

详细信息

此函数将创建
```
UnityWebRequest
```
并将目标 URL 设置为第一个字符串参数。此函数还会为
```
IMultipartFormSection
```
对象列表中所指定的表单数据相应设置
```
UnityWebRequest
```
的 Content-Type 标头。
默认情况下，此函数将
```
DownloadHandlerBuffer
```
附加到
```
UnityWebRequest
```
。这是为了方便起见，可用于检查服务器的应答。
类似于
```
WWWForm POST
```
函数，此 HLAPI 函数依次调用每个提供的
```
IMultipartFormSection
```
，然后将它们的格式设置为标准多部分表单（符合 RFC 2616 中的规定）。
已预先设置格式的表单数据存储在标准
```
UploadHandlerRaw
```
对象中，此对象随后附加到
```
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()    {        var formData = new List<IMultipartFormSection>();        formData.Add(new MultipartFormDataSection("field1=foo&field2=bar"));        formData.Add(new MultipartFormFileSection("my file data", "myfile.txt"));        using var www = UnityWebRequest.Post("https://www.my-server.com/myform", formData);        yield return www.SendWebRequest();        if (www.result != UnityWebRequest.Result.Success)        {            Debug.Log(www.error);        }        else        {            Debug.Log("Form upload complete!");        }    }}

使用 WWWForm（旧版函数）

为了帮助从 WWW 系统进行迁移，UnityWebRequest 系统允许使用旧的 WWWForm 对象来提供表单数据。

在这种情况下，函数签名为：


UnityWebRequest.Post(string url, WWWForm formData);

详细信息

此函数创建新的
```
UnityWebRequest
```
并将目标 URL 设置为第一个字符串参数的值。此函数还读取由
```
WWWForm
```
参数生成的所有自定义标头（比如 Content-Type），然后将这些标头复制到
```
UnityWebRequest
```
中。
默认情况下，此函数将
```
DownloadHandlerBuffer
```
附加到
```
UnityWebRequest
```
。这是为了方便起见，可用于检查服务器的应答。
此函数读取由
```
WWWForm object
```
生成的原始数据，然后将其缓冲在
```
UploadHandlerRaw
```
对象中，此对象将附加到
```
UnityWebRequest
```
。因此，调用
```
UnityWebRequest.POST
```
之后对
```
WWWForm
```
对象进行的更改不会改变
```
UnityWebRequest
```
的内容。

示例


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

Unity Engine

User Manual

Script Reference

Unity Engine

Unity Web Request Sending Form

使用 IMultipartFormSection

详细信息

示例

使用 WWWForm（旧版函数）

详细信息

示例