home-assistant.io/source/_components/image_processing.microsoft_face_detect.markdown

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, featured, ha_release

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	featured	ha_release
page	Microsoft Face Detect	Instructions how to integrate Microsoft Face Detect into Home Assistant.	2017-01-25 00:00	true	false	true	true	microsoft.png	Image Processing	false	0.38

The microsoft_face_detect image processing platform allows you to use the Microsoft Face Identify API through Home Assistant. This platform enables you do detect face on camera and fire a event with attributes.

Please refer to the component configuration on how to setup the API key.

For using the result inside an automation rule, take a look at the component page.

{% linkable_title Configuration Home Assistant %}

# Example configuration.yaml entry
image_processing:
  - platform: microsoft_face_detect
    source:
      - entity_id: camera.door

Configuration variables:

• group (Required): Microsoft Face group used to detect the person.
• confidence (Optional): The minimum of confidence in percent to process with Home Assistant. Defaults to 80.
• source array (Required): List of image sources.
  • entity_id (Required): A camera entity id to get picture from.
  • name (Optional): This parameter allows you to override the name of your image_processing entity.
• attributes array (Optional): The image search attributes. Supported: age, gender, glasses. Default age, gender.