# 自动亮度功能使用指南

## 功能介绍

自动亮度功能可以根据周围环境的光线强度，自动调整笔记本电脑或一体机屏幕的亮度，让您的眼睛更舒适，同时节省电量。

## 配置工具说明

本功能使用 `dde-dconfig` 工具进行配置管理。`dde-dconfig` 是 Deepin 桌面环境的统一配置管理工具。

**基本语法**：
```bash
dde-dconfig -a <应用ID> -r <资源名称> -k <配置键> --set -v <值>  # 设置配置
dde-dconfig -a <应用ID> -r <资源名称> -k <配置键> --get          # 查询配置
```

**自动亮度配置参数**：
- 应用ID：`org.deepin.startdde`
- 资源名称：`org.deepin.Display.AutoBrightness`
- 配置键：`enabled`, `sensitivity`, `polling-interval`, `change-threshold`, `manual-override-duration`

## 使用前准备

### 检查设备是否支持

您的设备需要满足以下条件：

1. **有环境光传感器**（大部分现代笔记本都有）
2. **是内置屏幕**（外接显示器不支持）
3. **系统服务正常**

### 快速检查方法

打开终端，输入以下命令检查：

```bash
# 检查是否支持自动亮度
dbus-send --session --print-reply --dest=com.deepin.daemon.Display \
  /com/deepin/daemon/Display org.freedesktop.DBus.Properties.Get \
  string:com.deepin.daemon.Display string:AutoBrightnessSupported
```

如果返回 `boolean true`，说明您的设备支持此功能。

## 基本使用

### 启用自动亮度

```bash
# 启用自动亮度
dbus-send --session --dest=com.deepin.daemon.Display \
  /com/deepin/daemon/Display com.deepin.daemon.Display.SetAutoBrightnessEnabled \
  boolean:true
```

### 关闭自动亮度

```bash
# 关闭自动亮度
dbus-send --session --dest=com.deepin.daemon.Display \
  /com/deepin/daemon/Display com.deepin.daemon.Display.SetAutoBrightnessEnabled \
  boolean:false
```

### 查看当前状态

```bash
# 查看是否已启用
dbus-send --session --print-reply --dest=com.deepin.daemon.Display \
  /com/deepin/daemon/Display org.freedesktop.DBus.Properties.Get \
  string:com.deepin.daemon.Display string:AutoBrightnessEnabled

# 查看当前环境光强度
dbus-send --session --print-reply --dest=com.deepin.daemon.Display \
  /com/deepin/daemon/Display org.freedesktop.DBus.Properties.Get \
  string:com.deepin.daemon.Display string:CurrentLightLevel
```

## 个性化设置

### 设置参数说明

| 设置项 | 配置键 | 说明 | 取值范围 | 推荐值 |
|-------|--------|------|---------|--------|
| **启用状态** | enabled | 是否启用自动亮度功能 | true/false | true |
| **敏感度** | sensitivity | 控制亮度调节的敏感程度，值越大亮度变化越明显 | 0.1-3.0 | 0.5（标准）|
| **检测间隔** | polling-interval | 多久检测一次环境光（秒） | 1-60秒 | 3秒（标准）|
| **变化阈值** | change-threshold | 环境光变化多少才调节亮度（绝对值） | 1.0-50.0 | 20.0（标准）|
| **暂停时间** | manual-override-duration | 手动调节后暂停自动调节的时间（秒） | 60-1800秒 | 300秒（5分钟）|

### 单独设置配置项

每个配置项都可以使用 `dde-dconfig` 命令单独设置：

```bash
# 设置敏感度
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k sensitivity --set -v 0.5

# 设置检测间隔（秒）
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k polling-interval --set -v 3

# 设置变化阈值
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k change-threshold --set -v 20.0

# 设置手动调节暂停时间（秒）
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k manual-override-duration --set -v 300
```

### 查询单个配置项

```bash
# 查询敏感度
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k sensitivity --get

# 查询检测间隔
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k polling-interval --get

# 查询变化阈值
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k change-threshold --get

# 查询暂停时间
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k manual-override-duration --get

# 查询所有配置
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness --list
```

### 常用配置示例

**注意**：配置修改后会立即生效，无需重启服务。

#### 标准配置（推荐）
```bash
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k sensitivity --set -v 0.5
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k polling-interval --set -v 3
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k change-threshold --set -v 20.0
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k manual-override-duration --set -v 300
```

#### 快速响应配置（适合移动办公）
```bash
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k sensitivity --set -v 0.8
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k polling-interval --set -v 2
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k change-threshold --set -v 15.0
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k manual-override-duration --set -v 180
```

#### 稳定配置（适合固定办公）
```bash
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k sensitivity --set -v 0.4
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k polling-interval --set -v 5
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k change-threshold --set -v 25.0
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k manual-override-duration --set -v 600
```

#### 节能配置（最大化省电）
```bash
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k sensitivity --set -v 0.3
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k polling-interval --set -v 10
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k change-threshold --set -v 30.0
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k manual-override-duration --set -v 900
```

## 使用技巧

### 1. 手动调节与自动调节的配合

- **手动调节后**：系统会自动暂停5分钟，避免冲突
- **立即恢复**：关闭后重新开启自动亮度即可立即恢复
- **调整暂停时间**：可以修改 `manual_override_duration` 参数

### 2. 不同环境的优化

**明亮办公室**：
- 敏感度：0.4-0.6
- 检测间隔：5-10秒
- 变化阈值：20.0-30.0

**昏暗环境**：
- 敏感度：0.6-0.8
- 检测间隔：3-5秒
- 变化阈值：15.0-20.0

**户外使用**：
- 敏感度：0.8-1.2
- 检测间隔：2-3秒
- 变化阈值：10.0-15.0

### 3. 省电优化

如果您更关心电池续航：
- 增加检测间隔（10-30秒）
- 提高变化阈值（25.0-40.0）
- 降低敏感度（0.3-0.5）

## 常见问题解决

### 问题1：功能不可用

**现象**：显示不支持自动亮度

**解决方法**：
```bash
# 检查传感器服务
sudo systemctl status iio-sensor-proxy

# 如果服务未运行，启动它
sudo systemctl start iio-sensor-proxy
sudo systemctl enable iio-sensor-proxy
```

### 问题2：亮度不调节

**现象**：环境光变化但屏幕亮度不变

**解决方法**：
1. 检查是否在手动调节暂停期间
2. 降低变化阈值
3. 重新启用功能

```bash
# 方法1：降低变化阈值（更敏感）
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k change-threshold --set -v 10.0

# 方法2：重新启用（清除暂停状态）
dbus-send --session --dest=com.deepin.daemon.Display \
  /com/deepin/daemon/Display com.deepin.daemon.Display.SetAutoBrightnessEnabled \
  boolean:false
dbus-send --session --dest=com.deepin.daemon.Display \
  /com/deepin/daemon/Display com.deepin.daemon.Display.SetAutoBrightnessEnabled \
  boolean:true
```

### 问题3：调节太频繁

**现象**：屏幕亮度变化太频繁，影响使用

**解决方法**：
```bash
# 方法1：提高变化阈值（降低敏感度）
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k change-threshold --set -v 30.0

# 方法2：增加检测间隔
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k polling-interval --set -v 10

# 方法3：使用完整稳定配置
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k sensitivity --set -v 0.4
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k polling-interval --set -v 5
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k change-threshold --set -v 25.0
```

### 问题4：反应太慢

**现象**：环境光变化后很久才调节亮度

**解决方法**：
```bash
# 方法1：降低变化阈值（更敏感）
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k change-threshold --set -v 10.0

# 方法2：减少检测间隔
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k polling-interval --set -v 2

# 方法3：使用完整快速响应配置
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k sensitivity --set -v 0.8
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k polling-interval --set -v 2
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k change-threshold --set -v 15.0
```

## 高级功能

### 查看详细状态

```bash
# 查看所有配置项
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness --list

# 查看单个配置项
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k enabled --get
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k sensitivity --get
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k polling-interval --get
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k change-threshold --get
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k manual-override-duration --get

# 查看运行状态（通过 D-Bus）
dbus-send --session --print-reply --dest=com.deepin.daemon.Display \
  /com/deepin/daemon/Display org.freedesktop.DBus.Properties.Get \
  string:com.deepin.daemon.Display string:AutoBrightnessSupported

dbus-send --session --print-reply --dest=com.deepin.daemon.Display \
  /com/deepin/daemon/Display org.freedesktop.DBus.Properties.Get \
  string:com.deepin.daemon.Display string:AutoBrightnessEnabled
```

### 监控环境光变化

```bash
# 实时监控环境光强度变化
watch -n 1 'dbus-send --session --print-reply --dest=com.deepin.daemon.Display \
  /com/deepin/daemon/Display org.freedesktop.DBus.Properties.Get \
  string:com.deepin.daemon.Display string:CurrentLightLevel'
```

### 查看日志

如果遇到问题，可以查看系统日志：

```bash
# 查看自动亮度相关日志
journalctl --user -u startdde -f | grep AutoBrightness

# 查看传感器服务日志
journalctl -u iio-sensor-proxy -f
```

## 注意事项

1. **仅限内置屏幕**：外接显示器不支持此功能
2. **传感器位置**：不要遮挡设备上的光线传感器
3. **电量消耗**：频繁检测会增加电量消耗，建议合理设置检测间隔
4. **手动优先**：手动调节亮度后会自动暂停功能一段时间
5. **重启保持**：设置会自动保存，重启后依然有效
6. **敏感度说明**：敏感度参数控制环境光到屏幕亮度的映射关系，值越大屏幕亮度变化越明显。推荐范围 0.3-1.0，默认 0.5

## 配置参数详解

### 敏感度 (sensitivity)

敏感度控制环境光强度到屏幕亮度的转换比例：

- **0.1-0.3**：低敏感度，适合希望屏幕亮度变化较小的用户
- **0.4-0.6**：标准敏感度，适合大多数使用场景（推荐）
- **0.7-1.0**：高敏感度，适合需要明显亮度变化的场景
- **1.1-3.0**：超高敏感度，仅在特殊场景使用

**计算公式**：屏幕亮度 = (环境光强度 × 敏感度) / 255

### 检测间隔 (polling_interval)

控制多久检测一次环境光强度：

- **1-2秒**：快速响应，适合移动办公，但会增加电量消耗
- **3-5秒**：标准响应，平衡响应速度和电量消耗（推荐）
- **6-10秒**：慢速响应，适合固定办公环境
- **11-60秒**：省电模式，适合电池续航优先的场景

### 变化阈值 (change_threshold)

环境光强度变化超过此值才会触发亮度调节：

- **1.0-10.0**：低阈值，对环境光变化敏感，调节频繁
- **11.0-25.0**：标准阈值，适合大多数场景（推荐）
- **26.0-50.0**：高阈值，只在环境光明显变化时才调节

**注意**：阈值过低会导致频繁调节，阈值过高会导致响应迟钝

### 暂停时间 (manual_override_duration)

手动调节亮度后，自动调节功能暂停的时间：

- **60-180秒**：短暂停，适合频繁切换环境的场景
- **181-600秒**：标准暂停，适合大多数场景（推荐 300秒）
- **601-1800秒**：长暂停，适合希望手动控制优先的场景

## 推荐设置

### 日常办公
```bash
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k sensitivity --set -v 0.5
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k polling-interval --set -v 3
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k change-threshold --set -v 20.0
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k manual-override-duration --set -v 300
```

### 移动办公
```bash
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k sensitivity --set -v 0.8
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k polling-interval --set -v 2
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k change-threshold --set -v 15.0
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k manual-override-duration --set -v 180
```

### 省电模式
```bash
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k sensitivity --set -v 0.3
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k polling-interval --set -v 10
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k change-threshold --set -v 30.0
dde-dconfig -a org.deepin.startdde -r org.deepin.Display.AutoBrightness -k manual-override-duration --set -v 600
```

---

**提示**：如果您不熟悉命令行操作，建议使用系统设置界面进行配置（如果可用）。如有问题，可以随时关闭此功能，不会影响正常的手动亮度调节。
