HTTP

HTTP 事件是由来自 http_*() 函数 之一的 回调 触发的事件，如 http_post_string。它实际上会生成一个 DS Map，该映射专用于此事件，并存储在特殊变量 async_load 中 (请参阅各个函数，了解有关此事件使用的详细代码示例)。此 DS 映射具有以下一般结构：

• "id"：从命令返回的id。如果您发出一系列http_请求，那么您需要知道您正在得到哪个回复，因此您将使用此值与最初发送请求时存储的值进行比较，以找到正确的请求。
• "status"：返回小于0的错误值，0表示成功，1表示正在下载内容。
• "result"：接收到的数据 (仅限字符串)，或下载文件的路径 (如果您使用了 http_get_file. 您只能在状态为 0 时获得此密钥，但这取决于平台。
• "url"：您请求的完整URL。
• "http_status"：原始超文本传输协议状态码(如果可用)。这将返回大多数浏览器的标准Web状态代码，例如：304代表"未修改"或204代表"无内容"等…

上面显示了使用 http_post_string 函数时得到的结果，但每个 http_ 函数可能返回略有不同的映射，因此请参考每个函数的手动条目以查找为其返回的精确数据。

注意：当 async_load 创建 DS 映射时，这些函数与 json_encode 和 json_decode 函数结合使用时特别有用。

如果您请求下载文件，此地图还可能提供其他数据。在这种情况下，"状态"的值为1，DS映射将保存这些额外的键：

• "contentLength"：这是Web服务器表示您应该收到的文件大小(如果服务器不返回此数据，可能是-1)。
• "sizeDownloaded"：已下载数据的大小。

请注意，该事件不会为收到的每个封包触发，而是会在主游戏循环中的下载过程中随时更新。另请注意，目前此功能仅适用于常规Windows目标平台。