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
。