跳转到内容

Camera Encoder

camera_encoder 组件为基于软件的相机或没有 内置压缩功能的相机提供图像压缩支持。它允许将原始相机帧压缩为适合传输到 API 客户端(如 Home Assistant)的格式,这些客户端期望接收 JPEG 压缩图像。

它支持不同的编码器实现,例如 ESP32 Camera 软件 JPEG 编码器,可以通过 设置图像质量和增量编码等选项进行配置。这些设置使得根据使用场景平衡图像 质量和性能成为可能。

NOTE

默认的软件 JPEG 编码器使 ESP32-S3 等设备能够流式传输图像。 它主要适用于较小尺寸的图像,因为处理能力和内存有限, 且仅支持 ESP32 系列设备。

# 示例配置条目
camera_encoder:
  • type (可选):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。