Microsoft Cognitive Services Face API を使った顔認証に関する個人的なメモ。
https://azure.microsoft.com/ja-jp/services/cognitive-services/face/
事前準備
Person Group の作成（Create a Person Group）
ユーザの顔を登録するために、Person Group を作成する必要があります。
後続で作成する Person オブジェクトを束ねるグループオブジェクトです。
Person Group > Person > Face という流れで登録していきます。
作成した Person Group へ Person を新規作成（Create a Person）
Person オブジェクトを作成し、 前述で作成した Person Group へ追加します。
作成した Person へ顔情報（画像）を追加（Add a Person Face）
作成した Person オブジェクトに顔情報を追加します。
顔が含まれる画像を読み込み、 Person オブジェクトと紐づけます。
ここで永続ID（PersistedFaceId）を取得することができます。
Person の PersonId と PersistedFaceId の関連付け（Upload person face）
Person Id は Person オブジェクトの一意の ID。 PersistedFaceId は顔情報の一意の ID。
これらを紐づけるための処理ですが、実際には前述の顔情報追加時に関連付けされているため、不要。
Person Group の学習開始（Train person group）
顔パターンを学習します。
これにより、顔の特徴を学習し顔認識が可能となります。
学習状況の確認しつつ、完了するまで待機（Get Person Group Training Status）
学習には時間がかかるため、学習状況を確認するための API が存在します。
Training Status が完了になるまで、顔認識ができません。
顔認証処理
顔検出（Detect）
カメラなどで撮影した画像から顔を検出（Detect）する。
顔が検出されると FaceId が取得できる。
顔識別（Identify）
取得した FaceId を使って、Person Group に登録されている顔情報を検索（Identify）する。
顔情報が検出されると PersonId が取得できる。
ユーザ情報の取得（Get a Person）
PersonId を使って、ユーザ情報を取得する。