> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 如何使用流式传递和文件传递

> 配置流式传递以实时批量接收大型快照结果，或使用文件传递来检索原始页面文件以及您的抓取数据。

本指南向您展示如何使用抓取器的两个高级传递功能：用于大型快照的**流式传递**，以及用于检索原始页面文件的**文件传递**。

<Info>
  **前置条件：**

  * 拥有活跃抓取器的 Bright Data 账户
  * 传递方法设置为**存储**或 **Webhook**（两个功能都需要这样设置）
</Info>

***

## 流式传递

当快照很大时，流式传递让您可以立即以批次方式接收收集的结果，而不必等待完整快照完成。

### 如何启用流式传递

**选项 1：控制面板**

1. 打开您的抓取器的**传递设置**选项卡。
2. 打开**流式传递结果**。
3. 输入每个批次应包含的数据行数。

<Frame>
  <img src="https://mintcdn.com/brightdata/0sd4eqxAli7ENzfc/images/Screenshot2025-12-23120416.png?fit=max&auto=format&n=0sd4eqxAli7ENzfc&q=85&s=d0af5172a801eabac58238414de9b4fc" alt="传递设置中的流式传递结果开关" style={{ width:"100%" }} width="643" height="98" data-path="images/Screenshot2025-12-23120416.png" />
</Frame>

**选项 2：WSAPI 参数**

在您的 WSAPI 请求中添加 `&stream_max_lines=10`：

```bash theme={null}
curl "https://api.brightdata.com/datasets/v3/trigger?dataset_id=<DATASET_ID>&stream_max_lines=10" \
  -H "Authorization: Bearer API_KEY"
```

### 限制

| 设置     | 值         |
| ------ | --------- |
| 最小批次大小 | 10 行      |
| 最大批次大小 | 100,000 行 |

<Warning>
  流式传递需要**存储**或 **Webhook** 传递方法。它与 API 下载不兼容。
</Warning>

***

## 文件传递

文件传递让您可以检索原始页面文件（HTML 快照、WARC 档案或屏幕截图）以及您的抓取数据。

### 如何启用文件传递

在您的 WSAPI 请求中添加 `&download_fields=` 并使用一个或多个可用的文件类型：

```bash theme={null}
curl "https://api.brightdata.com/datasets/v3/trigger?dataset_id=<DATASET_ID>&download_fields=html" \
  -H "Authorization: Bearer API_KEY"
```

要请求多个文件类型，请将其作为逗号分隔列表传递：

```bash theme={null}
curl "https://api.brightdata.com/datasets/v3/trigger?dataset_id=<DATASET_ID>&download_fields=html,screenshot" \
  -H "Authorization: Bearer API_KEY"
```

### 可用的文件类型

| 类型           | 可用性   | 描述                  |
| ------------ | ----- | ------------------- |
| `html`       | 始终可用  | 抓取页面的原始 HTML        |
| `warc`       | 不总是可用 | 完整的 WARC 档案，包括请求和响应 |
| `screenshot` | 不总是可用 | 抓取时页面的屏幕截图          |

<Warning>
  文件传递仅在传递方法设置为**存储**或 **Webhook** 时有效。
</Warning>

***

## 相关内容

<CardGroup cols={2}>
  <Card title="传递选项" icon="truck" href="/cn/datasets/scrapers/scrapers-library/delivery-options">
    配置您的存储目标和输出格式
  </Card>

  <Card title="API 参考" icon="code" href="/cn/datasets/scrapers/scrapers-library/api-reference">
    用于触发和管理快照的完整 API 参数
  </Card>
</CardGroup>