---
title: 设置
description: Pika 全部配置项及其对应的 dconf 键名：快捷键、视频帧率与分辨率、系统声音与麦克风、动图参数、输出目录，以及如何用 gsettings 直接改。
---

设置窗口从顶栏菜单的「设置…」打开。所有设置存在 dconf 里，路径
`/io/github/hungtcs/Pika/`，扩展和录制进程读的是同一份。

## 快捷键

| 键名 | 默认 | 说明 |
| --- | --- | --- |
| `record-region` | `<Super><Shift>r` | 唤起选区遮罩，选定范围后开始录制 |
| `record-screen` | 无 | 不经过选区，直接开始录制整个屏幕 |
| `stop-recording` | 无 | 结束当前录制并保存文件 |

## 视频

| 键名 | 默认 | 说明 |
| --- | --- | --- |
| `output-format` | `mp4` | 输出格式：`mp4` / `gif` / `apng` |
| `video-framerate` | `30` | 视频帧率上限 |
| `video-max-size` | `0` | 画面最长边的像素上限，0 表示保持原始分辨率 |

## 音频

只对 MP4 有效，动图格式没有音轨。系统声音和麦克风**混成一条音轨**，
不是两条独立音轨。

| 键名 | 默认 | 说明 |
| --- | --- | --- |
| `audio-system` | `false` | 录制系统声音 |
| `audio-microphone` | `false` | 录制麦克风 |
| `microphone-device` | 空 | PipeWire 的 `node.name`，留空表示跟随系统默认输入设备 |

系统声音跟随默认输出设备自动切换，不需要配置。

设置窗口里的麦克风选择旁边有个电平条，可以用来确认麦克风真的在收声。
它不常驻 —— 一旦开着 GNOME 顶栏就会亮起「正在使用麦克风」的指示器，
所以由开关显式控制。

## 动图

| 键名 | 默认 | 说明 |
| --- | --- | --- |
| `animation-framerate` | `10` | 动图帧率 |
| `animation-max-size` | `1280` | 画面最长边的像素上限，0 表示保持原始分辨率 |
| `animation-max-duration` | `30` | 动图时长上限（秒） |

## 输出

| 键名 | 默认 | 说明 |
| --- | --- | --- |
| `output-directory` | 空 | 留空表示 XDG「视频」目录下的 `Pika` 子目录 |

## 直接改 dconf

```bash
gsettings --schemadir ~/.local/share/gnome-shell/extensions/pika@hungtcs.github.io/schemas \
  set io.github.hungtcs.Pika video-framerate 60
```

装的是 RPM 的话 schema 在系统目录里，`--schemadir` 可以省掉。