| name | 待设置的标题的键。区分大小写。 |
| value | 标题的预期值。 |
将 HTTP 请求标题设置为自定义值。
标题键和值必须按照 HTTP 协议规范有效。两个字符串均不得包含某些非法字符,如控制字符。两个字符串均不得为 null,且至少包含 1 个字符。有关详细信息,请参阅 HTTP 规范。
在调用 SendWebRequest 后,无法调用此方法。
不建议将这些标题设置为这些自定义值:Accept-Charset、Accept-Encoding、Access-Control-Request-Headers、Access-Control-Request-Method、Connection、Date、Dnt、Expect、Host、Keep-Alive、Origin、Referer、Te、Trailer、Transfer-Encoding、Upgrade、Via。由于跨平台的各种限制,自定义值可能会被覆盖、忽略或不受支持,因此产生的行为可能不可靠。强烈建议保留对这些标题的自动处理,除非您希望查看任何意外的结果。Accept-Encoding 标题会自动设置为受支持的编码。使用其他值会被忽略,或者可能导致请求失败。有关详细信息,请参阅有关接受编码的 [Mozilla 文档](https://mdn.org.cn/en-US/docs/Web/HTTP/Headers/Accept-Encoding)。
如果存在附加 DownloadHandler,Content-Length 标题会自动根据其内容填充,并且无法设置为自定义值。X-Unity-Version 标头是由 Unity 自动设置的,可能不会设置为自定义值。User-Agent 标头是由 Unity 自动设置的,不建议将其设置为自定义值。Cookie 和 Cookie2 标头由底层的 Cookie 引擎自动管理。虽然具体行为取决于所使用的平台,但通常情况下,通过此标头设置 Cookie 会将它们添加到由引擎设置的 Cookie 中。更多资源:ClearCookieCache。
此外,在 Web 平台上,以下标头由 Web 浏览器填充,因此可能没有任何设置的自定义值:Cookie、Cookie2、User-Agent。