home-assistant.io/source/_components/image_processing.microsoft_face_identify.markdown
2019-03-10 04:45:59 -07:00

1.9 KiB

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

The microsoft_face_identify image processing platform lets you use Microsoft Face identify API through Home Assistant. This platform allow you do identify persons on camera and fire an event with attributes.

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

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

The free version of the Microsoft Face identify API limits the number of requests possible per month. Therefore, it is strongly recommended that you limit the `scan_interval` when setting up an instance of this entity as detailed on the main [Image Processing component](/components/image_processing/) page.

{% linkable_title Configuration %}

# Example configuration.yaml entry
image_processing:
  - platform: microsoft_face_identify
    group: family
    source:
      - entity_id: camera.door

{% configuration %} group: description: Micrsoft face group to detect person from it. required: true type: string confidence: description: The minimum of confidence in percent to process with Home Assistant. required: false type: integer default: 80 source: description: List of image sources. required: true type: list keys: entity_id: description: A camera entity id to get picture from. required: true type: string name: description: This parameter allows you to override the name of your image_processing entity. required: false type: string {% endconfiguration %}