文档

Unity 引擎

Unity 引擎

Web 网络

如何在 Web 中使用网络。
阅读时间4 分钟最后更新于 5 天前

您可以通过以下方式在 Web 中使用网络:

在 Web 使用 UnityWebRequest 类

Unity 支持 Web 中的 UnityWebRequest 类。为了实现 UnityWebRequest 类,Unity 使用 JavaScript Fetch API,该 API 使用浏览器来手柄 Web 请求。这会对访问跨域资源施加 SECURITY 限制。
如果向托管 Unity 内容的ServerOther的服务器发送 Web 请求,则发送到的Server器必须Authorize Unity 内容。
要访问 Web 中的跨域 Web 资源,尝试访问的服务器需要使用 CORS 来授权跨域 Web 资源。
如果您尝试使用 UnityWebRequest 访问内容,但远程Server器未正确设置或Configured CORS,则浏览器控制控制台会显示如下报错:
Cross-Origin 请求的阻止:Same Origin policy 禁止读取 http://myserver.COM/ 上的远程资源。可通过将Resource移动到同一域或启用 CORS 来解已修复此问题。
Server需要将 访问-Control 标头添加到其发出的 http 响应中,以指示哪些网页权限从 Web 浏览器读取该信息。
有关如何添加 访问-Control 标头的演示,允许 Unity Web 从AnyOrigin访问 Web ServerON的资源,请参阅以下示例。此示例包含常见的请求标头,允许使用 GET、POST 或选项方法:
"Access-Control-Allow-Credentials": "true","Access-Control-Allow-Headers":"Accept, X-Access-Token, X-Application-Name, X-Request-Sent-Time",“Access-Control-Allow-Methods”:"GET, POST 选项","Access-Control-Allow-Origin": "*",

UnityWebRequest 下载

不要使用阻止 UnityWebRequest Download 的代码,例如:
while(!www.isDone) {}
Web 浏览器不允许同步阻挡代码执行以等待网络 Transfer。因此,如果需要执行 Synchronous 样式 UnityWebRequest,请使用 coroutine 和 yield 语句等待 Download 完成。有关更多信息,请参阅使用 UnityWebRequest 的协程示例。

使用 Unity Netcode 网络包

由于 SECURITY 限制,Web 浏览器不允许直接访问 TCP 或 Unity 分发平台套接字。相反,您可以使用支持 Web 平台的 Unity Netcode 网络包。有关更多信息,请参阅关于 Netcode for GameObjects (Unity Multiplayer Networking) 的文档。
有关 ON Web 浏览器网络标准的更多信息,您可能希望探讨以下内容:

Web 网络的限制

有一些网络Features是 Web 平台不Support的。

不Support .NET 网络类

Web 平台不支持 .NET 网络 I/O 类,例如
System.Net.Sockets
、
System.Net.Http
和
System.Net.WebSockets
中的类,因为浏览器沙盒不提供对 IP 套接字的直接访问。有关 .NET API 限制的完整列表,请参阅 ON .NET API 支持。

不Support原生套接字接字访问

由于浏览器内的SECURITY限制,Web 平台不Support原生套接字访问。因此,Web 也不支持 UnityEngine.Ping (ICMP) 之类的 Features。