# 音频系统 ALSA / PulseAudio / PipeWire

URL: https://caijiao.org/gentoo/audio
Source: docs/gentoo/audio.md
Description: 本章介绍 Gentoo 系统音频配置，包括 ALSA、PulseAudio 与 PipeWire 的安装与设置。

在完成字体与输入法配置后，下一步是 **配置 Gentoo 音频系统**，实现系统声音输出、输入和多媒体播放功能。

## 一、ALSA 配置

1. 安装 ALSA 驱动与工具：

```bash
emerge --ask media-sound/alsa-utils
````

2. 启用系统服务（可选，部分发行版自动加载）：

```bash
rc-update add alsasound default
```

3. 查看和设置声卡设备：

```bash
aplay -l       # 列出播放设备
arecord -l     # 列出录音设备
alsamixer      # 调整音量
```

## 二、PulseAudio 配置

1. 安装 PulseAudio：

```bash
emerge --ask media-sound/pulseaudio
```

2. 安装图形管理工具（可选）：

```bash
emerge --ask media-sound/pavucontrol
```

3. 启动 PulseAudio：

```bash
pulseaudio --start
```

4. 配置自动启动（在桌面环境）：

* GNOME：默认集成 PulseAudio
* KDE / XFCE：添加 `pulseaudio --start` 到会话启动

## 三、PipeWire 配置（现代音频与视频处理）

1. 安装 PipeWire：

```bash
emerge --ask media-video/pipewire media-sound/pipewire-pulse
```

2. 启用服务（OpenRC）：

```bash
rc-update add pipewire default
rc-update add pipewire-pulse default
```

3. 配置桌面环境使用 PipeWire：

* KDE / GNOME / XFCE 桌面环境可自动识别 PipeWire
* 通过 `pavucontrol` 或 `helvum` 管理音频路由

## 四、切换音频系统

* 如果同时安装 PulseAudio 与 PipeWire，可通过 USE 标志或服务启用其中一个
* 确保 `alsa` 基础驱动正常工作，避免无声或冲突

## 五、建议操作

* 根据桌面环境选择合适音频系统：PipeWire 更现代，兼容 PulseAudio
* 使用 `alsamixer` 调整音量和声道设置
* 安装图形管理工具方便音量调节和设备选择