# 序列化追踪数据

`Frame` 类提供了学历恶化一帧中的数据的方法。你可以反序列化这个字节序列来创建一个原始帧的新拷贝。

## 序列化一帧

创建一个 `Frame` 的序列化示例，可以使用 `Frame.serialize`。

下面的代码展示了如何将一帧保存到文件中：

```python
import ctypes

frame = controller.frame()

serialized_tuple = frame.serialize
serialized_data = serialized_tuple[0]
serialized_length = serialized_tuple[1]
data_address = serialized_data.cast().__long__()
buffer = (ctypes.c_ubyte * serialized_length).from_address(data_address)
with open(os.path.realpath('frame.data'), 'wb') as data_file:
    data_file.write(buffer)
```

## 反序列化一帧

在你反序列化一个 `Frame` 数据之前，你必须创建一个 `Controller`对象。如果你想要访问恢复帧中的任何 `Gesture` 数据，你也必须使用 `Controller.enable_gesture()` 函数。访问帧里存储的图像目前还不支持。反序列化来自不同 LeapMotion SDK 版本的数据并没有获得官方支持，如果两个版本中的数据模型没有差异，那么它可能有效。

反序列化帧数据需要以下几个步骤：

1. 创建一个 `Controller` 实例；
2. 获取数据，如果有必要的话将其转换成合适的数据类型；
3. 创建一个 Frame 对象；
4. 调用新帧的 `deserialize()` 方法。

注意，重建后的数据会替换帧中现有的数据。如果使用了已经存在且有效的 `Frame` 实例，那么已经存在的数据会被覆盖。然而任何子对象，例如手、手指等，只要你保持对它们的单独引用。

下面的例子展示了如何从一个文件中反序列化并创建一个 `Frame` 对象。

当你从磁盘加载这个数据，你会获得一个 Python 的字符串对象，然而 deserialize() 函数需要传入一个元组，其中包含一个 Leap.byte\_array 对象（一个简单的有限的数组）。你可以使用数据的长度，构造这个 byte\_array 对象，然后一个字节一个字节的复制数据或使用 ctypes.memmove() 函数。将字节数组放在元组的第一个位置，并把数据的长度放在第二个位置，再传递给 deserialize() 函数。

```
import ctypes, numpy

frame = Leap.Frame()
filename = "frame.data"
with open(os.path.realpath(filename), 'rb') as data_file:
    data = data_file.read()

leap_byte_array = Leap.byte_array(len(data))
address = leap_byte_array.cast().__long__()
ctypes.memmove(address, data, len(data))

frame.deserialize((leap_byte_array, len(data)))
```

## 保存和读取多个帧

如果你希望保存多个帧，那么你必须相处一个方法来表示一个帧的结束和下一个帧的开始。每一帧数据大小都可能不同。下面的代码展示了一个方法，使用的是存储一个4字节的证书来保存数据的大小：

```
with open("frames.data", "wb") as data_file:
    for f in range(0, 10):
        frame_to_save = controller.frame(9 - f)
        serialized_tuple = frame_to_save.serialize
        data = serialized_tuple[0]
        size = serialized_tuple[1]
        data_file.write(struct.pack("i", size))

        data_address = data.cast().__long__()
        buffer = (ctypes.c_ubyte * size).from_address(data_address)
        data_file.write(buffer)
```

从保存的文件中读取帧，你可以先读取四个字节来获得接下来要读取的帧数据的总长度。然后再重复这个过程直到完成整个文件的读取。

```
with open("frames.data", "rb") as data_file:
    next_block_size = data_file.read(4)
    while next_block_size:
        size = struct.unpack('i', next_block_size)[0]
        data = data_file.read(size)
        leap_byte_array = Leap.byte_array(size)
        address = leap_byte_array.cast().__long__()
        ctypes.memmove(address, data, size)

        frame = Leap.Frame()
        frame.deserialize((leap_byte_array, size))
        next_block_size = data_file.read(4)
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://changkun.gitbook.io/leapmotion_v2_cn/yu-yan/cpp/shi-yong-zhui-zong-api/leap_serialization.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.