跳转到内容

摄像头编码器

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

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

NOTE

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

# 示例配置条目
camera_encoder:
  • type (可选): esp32_camera
  • quality (可选, 整数): 设置 JPEG 压缩质量。 有效值范围从 1(最低质量,最高压缩)到 100(最佳质量,最低压缩)。默认值:80

  • buffer_size (可选, 整数): 输出缓冲区的初始大小(字节),用于存储 JPEG 编码的图像数据。

    • 最小值:1024 字节
    • 最大值:2097152 字节(2 MB),适用于 ESP32-S3 和 ESP32-P4
    • 默认值:4096
  • buffer_expand_size (可选, 整数): 当输出缓冲区太小无法容纳 JPEG 编码图像时,扩展的字节数。值为 0 时禁用扩展。

    • 最大值:2097152 字节(2 MB),适用于 ESP32-S3 和 ESP32-P4
    • 默认值:1024