# 了解快照

在决定如何发送、组织或查询捕获事件之前，请使用此页面了解 Luxonis Hub 的数据模型。

## 快照的重要性

快照是将设备捕获的数据发送到 Luxonis Hub 的主要方式。它们使您能够将设备输出转换为可搜索的记录，以支持调试、分析和模型改进。

 * 记录设备检测到的现场事件。
 * 捕获真实世界的数据 进行分析和验证。
 * 收集用于模型改进的媒体，通过标注和审查工作流程。

## 快照包含的内容

每个快照将事件本身与稍后组织它所需的元数据结合在一起。

 * 快照名称，标识捕获类型，例如 "image"、"data_collection" 或 "inspection_event"。
 * 一个或多个附件，例如静态图像、视频序列或立体数据。
 * 可选的 标签 和 附加信息，以便您大规模地组织、搜索和过滤捕获的数据。

## 选择创建快照的方式

根据您对捕获和发布所需的控制程度，选择适合的路径。

### 使用现成的应用

从 Luxonis Hub 应用商店开始使用无代码或低代码的捕获工作流程，当您需要快速收集数据时。

[使用现成的应用](https://docs.luxonis.com/cloud/features/application-management/app-store.md)

### 使用 Snaps 生产者节点

将快照创建添加到基于 DepthAI 节点的流水线中，当您需要一个结构化的自定义应用路径，而又不想从头编写完整流程时。

[使用 Snaps 生产者节点](https://docs.luxonis.com/software-v3/ai-inference/inference/depthai-nodes.md)

### 在 DepthAI 中集成快照

使用 DepthAI 教程，当您希望完全控制快照的发送、标记、缓存和上传时。

[在 DepthAI 中集成快照](https://docs.luxonis.com/software-v3/depthai/tutorials/snaps.md)

## 组织和搜索快照

标签和附加信息有助于长期保持大量捕获数据的可用性。

 * 标签，用于分组相关快照（例如 night、validation、dataset_v2）。
 * 附加信息，任意键值对，用于可搜索的元数据（例如 scene:warehouse、lighting:low）。

在 Luxonis Hub 中使用这些字段来搜索、过滤和组织跨项目、设备和捕获运行的数据。

如需编程访问，请参阅 [快照 API 指南](https://docs.luxonis.com/cloud/api/guides/snaps.md)，以查询、过滤和删除工作区中的快照。

## 相关指南

### 从 DepthAI 发送快照

了解如何在 DepthAI 应用中发送快照、配置上传和处理缓存。

[从 DepthAI 发送快照](https://docs.luxonis.com/software-v3/depthai/tutorials/snaps.md)

### 通过 API 管理快照

使用 Luxonis Hub GraphQL API 以编程方式查询、过滤和删除快照。

[通过 API 管理快照](https://docs.luxonis.com/cloud/api/guides/snaps.md)