For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /home-assistant/integrations/microsoft_face_detect.md.

Microsoft Face Detect

Microsoft Face Detect 集成允许您通过 Home Assistant 使用 Microsoft Face Identify API。该平台可让您检测摄像头画面中的人脸,并触发带有属性的事件。

有关如何设置 API 密钥,请参阅 Microsoft Face 集成 的配置说明。

如需在自动化规则中使用结果,请参阅 Image Processing 集成 页面。

Important

Microsoft Face identify API 的免费版本会限制每月可发起的请求数量。因此,强烈建议您在设置此实体实例时限制 scan_interval,具体说明请参阅 Image Processing 集成 主页面。

配置

要启用此集成,请将以下内容添加到 configuration.yaml 文件中。 :::tip 更改配置后需要重启 Home Assistant。 :::

# Example configuration.yaml entry
image_processing:
  - platform: microsoft_face_detect
    source:
      - entity_id: camera.door
confidence:
  description: 由 Home Assistant 处理所需的最小置信度百分比。
  required: false
  type: integer
  default: 80
source:
  description: 图像来源列表。
  required: true
  type: list
  keys:
    entity_id:
      description: 用于获取图片的摄像头实体 ID。
      required: true
      type: string
    name:
      description: 此参数允许您覆盖 `image_processing` 实体的名称。
      required: false
      type: string
attributes:
  description: "图像搜索属性。支持:`age`、`gender`、`glasses`。"
  required: false
  type: list
  default: "[age, gender]"