缓冲区使用指南

一个简单的例子是如何在任何平台的任何GameMaker游戏中使用缓冲区，函数game_save_buffer()。该函数将获取当前游戏状态的"快照"并将其保存到预定义的缓冲区，然后可以从该缓冲区读取以再次加载游戏。

注意此功能非常有限，它是为初学者设计的，用于快速启动和运行检查点系统，但更高级的用户可能更喜欢使用File功能编写自己的系统，因为游戏不会保存任何您可以在运行时创建的动态资源，如数据结构，表面，添加的精灵等。

我们需要做的第一件事是创建一个新的对象来控制保存和加载，所以你可以创建一个并给予它一个Create Event。在这个事件中，你可以放置以下代码：

SaveBuffer = buffer_create(1024, buffer_grow, 1);
StateSaved = false;

第一行创建了一个1024字节的增长缓冲区(因为我们不知道保存数据的最终大小)，并以1字节对齐。然后创建一个变量来检查游戏是否已保存(这将用于加载)。

接下来，我们将添加按键事件(例如)，其中我们将保存当前游戏状态到创建的缓冲区：

StateSaved = true;
buffer_seek(SaveBuffer, buffer_seek_start, 0);
game_save_buffer(SaveBuffer);

上面将首先将控制变量设置为true(这样当我们将游戏保存到缓冲区时，它就被保存了)，然后在将当前保存状态写入缓冲区之前搜索到缓冲区的开头。为什么我们要使用buffer_seek()？正如本页所述，从数据添加到缓冲区的最后一个位置读取和写入缓冲区。这意味着，如果您不将缓冲区设置回起始位置，则当您保存时，因此，我们使用函数buffer_seek()将tell移动到缓冲区的起始位置。

我们现在已经将当前游戏状态保存到了一个缓冲区中。下一步将是编写如何加载它的代码，可能是在另一个Keypress Event中：

if (StateSaved)
{
    buffer_seek(SaveBuffer, buffer_seek_start, 0);
    game_load_buffer(SaveBuffer);
}

然后，游戏将在放置上述代码的事件结束时加载。

注意这仅适用于在同一房间内使用，而不是用于在游戏关闭或重新启动后生成完整的已保存游戏！

最后要添加到控制器对象的是一些"清理"代码。缓冲区存储在内存中，因此，如果您在使用完它们后不清理它们，您可能会得到内存泄漏，最终会延迟并导致游戏崩溃。因此，您可能会添加房间结束事件(来自其他事件类别)：

buffer_delete(SaveBuffer);

这个对象现在可以被放置到一个房间里，然后按下保存键，从一个缓冲区加载房间状态。

当使用GameMaker网络功能时，您必须使用缓冲区来创建通过网络连接发送的数据包。本示例旨在展示如何完成此操作，但由于网络可能性的范围，它仅旨在展示如何使用缓冲区本身，而不是完整的网络系统。

我们首先要展示的是为网络连接的客户端创建和使用缓冲区。此缓冲区将用于创建小数据包，然后将其发送到服务器，因此在实例的Create Event中，我们将像这样分配缓冲区：

send_buff = buffer_create(256, buffer_grow, 1);

我们将缓冲区设置得较小(256个字节)-因为它不适合保存大量数据-然后我们将其设置为增长缓冲区，以确保在任何时候都不会出现错误，并且为了方便起见，将对齐设置为1。

现在，假设我们希望我们的客户端发送数据到服务器。为此，我们需要创建一个缓冲区"数据包"，在这个例子中，我们将发送一个按键事件，就像当玩家按下左箭头在游戏中移动时一样。为此，我们首先将必要的数据写入缓冲区，然后发送它：

buffer_seek(buff, buffer_seek_start, 0);
buffer_write(buff, buffer_u8, 1);
buffer_write(buff, buffer_s16, vk_left);
buffer_write(buff, buffer_bool, true);
network_send_packet(client, buff, buffer_tell(buff));

在写入缓冲区之前，我们已将“tell”设置为缓冲区的开头，因为网络始终从缓冲区的开头获取数据。 然后我们写入检查值（服务器将使用它来确定要处理的事件类型），然后写入正在使用的键，然后写入键的状态（在本例中为按下状态）。 然后，该缓冲区由网络功能作为数据包发送。 请注意，我们不会发送整个缓冲区！ 我们只发送写入的数据，使用 buffer_tell 函数返回缓冲区的当前读/写位置（请记住，写入缓冲区会将“tell”移动到已写入内容的末尾）。 这只是为了避免发送过多的字节。

那么在服务器上接收数据呢？ 接收到的数据包必须写入服务器上的缓冲区，然后用于更新游戏。 为此，我们将在服务器的网络控制器对象中使用网络异步事件，如下面的简化代码所示：

var buff = ds_map_find_value(async_load, "buffer");
if (cmd == buffer_read(buff, buffer_u8))
{
    key = buffer_read(buff, buffer_s16);
    key_state = buffer_read(buff, buffer_bool);
}

异步事件将包含一个特殊的临时 DS 映射 async_load（它会在事件结束时自动从内存中删除），其中包含不同的信息，具体取决于来自网络的传入数据的类型。 在这种情况下，我们假设该地图已被检查并发现是从客户端发送的缓冲区数据包。 我们现在检查缓冲区中的第一条数据，以查看已发送的事件类型 - 在本例中，值“1”代表关键事件，但是在编码这些内容时，您应该定义常量来保存这些值 简化操作 - 然后存储按下的按键及其状态（true = 按下，false = 释放）。 然后，该信息将用于向所有客户端更新发送客户端玩家的新状态。

注意从 DS 映射创建的缓冲区会在网络异步事件结束时自动删除，因此此处无需使用 buffer_delete()。