网络

Networking Event

网络事件将由任何传入网络流量触发，并链接到网络函数。此事件将生成一个专用于此事件的DS map，该映射存储在特殊变量async_load中。此DS map将包含不同的信息，具体取决于生成它的网络事件的类型。

常见网络事件

async_load映射中始终存在以下密钥，这些密钥是所有接收到的网络函数通用的：

type：这将在下表中列出一个常量作为其返回值，并指定网络事件类型。
"id":接收事件的套接字ID(由network_create_server或network_create_socket函数返回的实数)。在大多数情况下，返回的套接字ID是触发事件的Tcp或Udp套接字的ID，但是，如果事件是在服务器中触发的，并且是数据事件(请参阅下文)，则套接字ID是发送数据的客户端的ID。
"ip":套接字的Ip地址(作为字符串)。
"port":与Ip地址关联的端口(使用Udp时有用)。

"type"键的可能返回值可以是下面列出的四个常量之一：

常量	描述
network_type_connect	The event was triggered by a connection.
network_type_disconnect	The event was triggered by a disconnection.
network_type_data	The event was triggered by incoming data.
network_type_non_blocking_connect	The event was triggered by a connection configured as non-blocking (you can use the function network_set_config() for this, or connect using network_connect_async() or network_connect_async_raw()).

当您有一个类型为 network_type_connect 或 network_type_disconnect 的事件时，Network_load 映射将具有以下附加键：

如果事件的类型为network_type_non_blocking_connect，则还会有以下密钥：

值得注意的是，当服务器断开连接时，不会在客户端中触发网络事件，并且当客户端连接到的服务器断开连接时，也不会在客户端中触发network_type_*事件，即使连接是基于Tcp的。

network_type_data类型的事件表示您的网络已收到数据时，创建的映射将具有以下键：

"buffer"：这是事件生成的缓冲区的句柄。创建一个 " 增长 " 类型的缓冲区，字节对齐为 1，以保存 ID，该 ID 应存储在变量中，并用于此事件中对缓冲区的所有进一步函数调用。就像 async_load 映射一样，在此事件结束时，创建的缓冲区将自动从内存中删除。有关缓冲区的详细信息，请参见参考-缓冲区。
"size":这是要接收的缓冲区数据的大小(以字节为单位)。
"message_type"：(仅限WebSockets)-如果收到的消息为二进制形式，则为network_send_binary;如果收到的消息为文本形式，则为network_send_text。

注意创建的缓冲区仅在这些事件中有效，并将在事件结束时自动释放。

如果在使用 network_connect_active 或 network_connect_passive 时 os_is_network_connected 函数返回 false，则在此事件中异步返回结果。 async_load 映射中的 type 键将为以下值之一：

常量	描述
network_type_up	The connection succeeded.
network_type_up_failed	The connection failed.

如果网络在任何时候出现故障，将 type 键设置为 network_type_down 时将再次触发此事件。