# 截图、录屏与文件命名

> 真机实验室怎样拍摄、命名和打码截图与录屏：文件命名规则、与之配套的环境信息，以及保存文件之前要去掉哪些内容。

import LabProvenance from '@components/lab/LabProvenance.astro';

事后分析的截图或录屏属于 S 类证据。iOS 18.6.2 上各测试应用状态栏那一条的颜色（例如实验室应用里是 `#161616`，它的 theme-red 页面是 `#d00000`）和主屏图标上的角标，都是从截图里测出来的（[主要发现](https://openpwa.net/research/2026-10-ios18-home-screen-web-apps/data/FINDINGS.md)第 10、12 条）。给文件记好设备与构建号，注明对应的测试步骤。用来作证据前，去掉画面里其他人的内容。

## 拍摄

带面容 ID 的 iPhone，同时按下侧边按钮和音量加按钮，然后一起松开（[Take a screenshot on your iPhone](https://support.apple.com/en-us/102616)，apple.com）。录屏要先把**屏幕录制**加进控制中心，轻点它，等三秒倒计时结束（[Record the screen on your iPhone, iPad, or iPod touch](https://support.apple.com/en-us/102653)，apple.com）。录屏时不要开麦克风。和测试流程一样，用隔空投送把文件传到 Mac。

测试要求在哪个时刻截哪张图，就在那个时刻截那张图。权限弹窗，或者其他截图难以抓住的时刻，改用录屏，事后再逐帧读取。

## 给每个文件命名

处理文件之前先按这个格式改名。

```text
<YYYY-MM-DD>_<device-slug>_<os-version>_<test-id>_<n>.png
```

| 字段 | 含义 |
|---|---|
| `YYYY-MM-DD` | 测试日期，不是传输日期。 |
| `device-slug` | 设备的小写简称，同一台设备在所有文件、所有测试里都用同一个：`iphone16pro`。 |
| `os-version` |  `ios` 或 `ipados` 加版本号：`ios18.6.2`。 |
| `test-id` | 测试编号，与[测试列表](/zh/lab/tests/)一致：`T4`、`T7`、`T4b`。 |
| `n` | 测试步骤给出的截图编号（例如 `12`）；同一步骤的变体用字母后缀区分（`12a`、`12b`）。 |

例如 `2026-10-20_iphone16pro_ios18.6.2_T4_12a.png` 就是 iOS 18.6.2 那次测试中 T4 编号 12 的 a 变体。录屏沿用同样的格式，只换扩展名。在测试的 `screenshots:` 字段里按文件名引用；按打码规则改动过的文件，在文件名里加上 `_redacted`。

## 填写环境信息

截图要附环境信息，每台设备每次测试填一次，包括日期、时间与时区；设备市场名称和型号号码；系统版本与构建号；发布渠道；Safari 版本与 UA；设备语言与地区；改动过默认值的 Safari 功能标志；内容拦截器、VPN 与 iCloud 专用代理；如果用了 Web Inspector，再写上所用的 Mac。外观设置（浅色或深色）也要写上。[iPhone 与 iPad 指南](/zh/lab/guides/iphone-ipad/)里有一段可以直接复制的模板。拍摄时间记在实验笔记里，所以文件本身的元数据可以去掉。

## 保存或发送之前先打码

不属于测试的内容要涂掉、裁掉，或避开不拍。

- 主屏截图里其他 App 的图标和程序坞，以及其他 App 的通知横幅；
- 联系人、运营商名称、位置信息，以及「设置」里其他 App 的那几行；
- Safari 标签栏里其他网站的标题，以及第三方输入法的工具栏；
- 推送端点主机名以外的部分；[lab.js](https://openpwa.net/lab/device-tests/lab.js) 和 [T7 权限应用](https://openpwa.net/lab/device-tests/t7/perm/)只打印主机名（例如 `web.push.apple.com`），但画面其余部分仍要检查；
- 标识符：序列号、UDID、Apple 账户名、手机号。

打码区域用纯灰色填充，测试本身的图标、横幅和面板不要动。每张图片都重新编码，去掉 EXIF 和 XMP 元数据。录屏要剪掉出现无关 App 的片段，去掉音轨，替换容器元数据，并记下剪掉了多长，方便校正实验笔记里的帧时间。iOS 18.6.2 数据包的 README 列出了每个打过码的文件及其原因。

## 测试开始之前

测试前后怎样核对下发测试页文件的哈希，见 [iPhone 与 iPad 指南](/zh/lab/guides/iphone-ipad/)。测试要求时先恢复干净状态（删图标、清网站数据），免得截图里出现上一次测试留下的图标或数据。

<LabProvenance locale="zh" />