Camera Encoder
camera_encoder 组件为基于软件的相机或没有
内置压缩功能的相机提供图像压缩支持。它允许将原始相机帧压缩为适合传输到 API
客户端(如 Home Assistant)的格式,这些客户端期望接收 JPEG 压缩图像。
它支持不同的编码器实现,例如 ESP32 Camera 软件 JPEG 编码器,可以通过 设置图像质量和增量编码等选项进行配置。这些设置使得根据使用场景平衡图像 质量和性能成为可能。
NOTE
默认的软件 JPEG 编码器使 ESP32-S3 等设备能够流式传输图像。 它主要适用于较小尺寸的图像,因为处理能力和内存有限, 且仅支持 ESP32 系列设备。
# 示例配置条目camera_encoder:- type (可选):
esp32_camera
esp32_camera 选项
Section titled “esp32_camera 选项”-
quality (可选, int):设置 JPEG 压缩质量。 有效值范围为
1(最低质量,最高压缩)到100(最佳质量,最小压缩)。默认值为80。 -
buffer_size (可选, int):输出缓冲区的初始大小(字节),用于存储 JPEG 编码后的图像数据。
- 最小值:1024 字节
- 最大值:2097152 字节(2 MB),适用于 ESP32-S3 和 ESP32-P4
- 默认值:
4096。
-
buffer_expand_size (可选, int):如果输出缓冲区不足以容纳 JPEG 编码图像,则需要扩展的字节数。值为
0时禁用扩展。- 最大值:2097152 字节(2 MB),适用于 ESP32-S3 和 ESP32-P4
- 默认值:
1024。