FaceOperations クラス

定義

FaceOperations 操作。

public class FaceOperations : Microsoft.Azure.CognitiveServices.Vision.Face.IFaceOperations, Microsoft.Rest.IServiceOperations<Microsoft.Azure.CognitiveServices.Vision.Face.FaceClient>
type FaceOperations = class
    interface IServiceOperations<FaceClient>
    interface IFaceOperations
Public Class FaceOperations
Implements IFaceOperations, IServiceOperations(Of FaceClient)
継承
FaceOperations
実装

コンストラクター

FaceOperations(FaceClient)

FaceOperations クラスの新しいインスタンスを初期化します。

プロパティ

Client

FaceClient への参照を取得します

メソッド

DetectWithStreamWithHttpMessagesAsync(Stream, Nullable<Boolean>, Nullable<Boolean>, IList<FaceAttributeType>, String, Nullable<Boolean>, String, Nullable<Int32>, Dictionary<String,List<String>>, CancellationToken)

FaceOperations 操作。

DetectWithUrlWithHttpMessagesAsync(String, Nullable<Boolean>, Nullable<Boolean>, IList<FaceAttributeType>, String, Nullable<Boolean>, String, Nullable<Int32>, Dictionary<String,List<String>>, CancellationToken)

FaceOperations 操作。

FindSimilarWithHttpMessagesAsync(Guid, String, String, IList<Nullable<Guid>>, Nullable<Int32>, FindSimilarMatchMode, Dictionary<String,List<String>>, CancellationToken)

与えられたクエリの顔の faceId に対して、faceId 配列、顔リスト、または大規模顔リストから類似の顔を検索します。 faceId 配列には、 Face - Detect によって作成された顔が含まれています。これは、作成後 24 時間後に期限切れになります。 "faceListId" は 、FaceList - 有効期限が切れない persistedFaceIds を含む作成によって作成されます。 また、"largeFaceListId" は LargeFaceList - Create によって作成され、また期限切れにならない persistedFaceIds を含みます。 入力に応じて、返される類似した顔の一覧には、類似性によってランク付けされた faceIds または persistedFaceId が含まれます。 <br/>Find similar には、"matchPerson" と "matchFace" の 2 つの動作モードがあります。 "matchPerson" は、内部の同一人物しきい値を使用して、可能な限り同じ人物の顔を検索しようとする既定のモードです。 これは、既知の人の他の写真を見つけるのに役立ちます。 内部しきい値を超える顔がない場合は、空のリストが返されることに注意してください。 "matchFace" モードでは、同一人物のしきい値が無視され、ランク付けされた類似した顔が返されます。類似性が低い場合でも同様です。 有名人のような顔を検索する場合に使用できます。 <br/>クエリ顔の faceId に関連付けられている 'recognitionModel' は、ターゲット faceId 配列、顔リスト、または大きな顔リストで使用される 'recognitionModel' と同じである必要があります。

GroupWithHttpMessagesAsync(IList<Guid>, Dictionary<String,List<String>>, CancellationToken)

顔の類似性に基づいて候補の顔をグループに分割します。<Br/>

  • 出力は、1 つ以上の分離された顔グループと messyGroup です。 顔グループには、よく同じ人物の似た顔が含まれています。 顔グループは、グループ サイズ (顔の数) によってランク付けされます。 同じ人物に属する顔が、結果内の複数のグループに分割される可能性があることに注意してください。
  • MessyGroup は、元の顔から類似した対応する顔を見つけることができない顔を含む特殊な顔グループです。 すべての顔が対応する顔を見つけた場合、結果に messyGroup は表示されません。
  • グループ API には、少なくとも 2 人の候補顔と最大 1000 人が必要です。 顔の候補が 2 つしかない場合は 、Face - Verify を試してみることをお勧めします。
  • クエリの顔に関連付けられている 'recognitionModel' faceIds は同じである必要があります。
IdentifyWithHttpMessagesAsync(IList<Guid>, String, String, String, IList<String>, Nullable<Int32>, Nullable<Double>, Dictionary<String, List<String>>, CancellationToken)

FaceOperations 操作。

VerifyFaceToFaceWithHttpMessagesAsync(Guid, Guid, Dictionary<String,List<String>>, CancellationToken)

2 つの顔が同一人物に属しているか 1 つの顔が 1 人の人物に属しているかを確認します。 <br/> 解説:<br />

  • 顔の画質が高いほど、識別精度が向上します。 正面、透明、顔のサイズは 200 x 200 ピクセル (目の間に 100 ピクセル) 以上の高品質の顔を検討してください。
  • 精度に敏感なシナリオについては、ご自身で判断してください。
  • クエリの顔に関連付けられている 'recognitionModel' faceIds は、ターゲットの顔、人物グループ、または大きな人物グループで使用される "recognitionModel" と同じである必要があります。
VerifyFaceToPersonWithHttpMessagesAsync(Guid, Guid, String, String, Dictionary<String,List<String>>, CancellationToken)

2 つの顔が同じ人物に属しているかどうかを確認します。 顔 ID と人物 ID を比較します

拡張メソッド

DetectWithStreamAsync(IFaceOperations, Stream, Nullable<Boolean>, Nullable<Boolean>, IList<FaceAttributeType>, String, Nullable<Boolean>, String, Nullable<Int32>, CancellationToken)

FaceOperations 操作。

DetectWithUrlAsync(IFaceOperations, String, Nullable<Boolean>, Nullable<Boolean>, IList<FaceAttributeType>, String, Nullable<Boolean>, String, Nullable<Int32>, CancellationToken)

FaceOperations 操作。

FindSimilarAsync(IFaceOperations, Guid, String, String, IList<Nullable<Guid>>, Nullable<Int32>, FindSimilarMatchMode, CancellationToken)

与えられたクエリの顔の faceId に対して、faceId 配列、顔リスト、または大規模顔リストから類似の顔を検索します。 faceId 配列には、 Face - Detect によって作成された顔が含まれています。これは、作成後 24 時間後に期限切れになります。 "faceListId" は 、FaceList - 有効期限が切れない persistedFaceIds を含む作成によって作成されます。 また、"largeFaceListId" は LargeFaceList - Create によって作成され、また期限切れにならない persistedFaceIds を含みます。 入力に応じて、返される類似した顔の一覧には、類似性によってランク付けされた faceIds または persistedFaceId が含まれます。 <br/>Find similar には、"matchPerson" と "matchFace" の 2 つの動作モードがあります。 "matchPerson" は、内部の同一人物しきい値を使用して、可能な限り同じ人物の顔を検索しようとする既定のモードです。 これは、既知の人の他の写真を見つけるのに役立ちます。 内部しきい値を超える顔がない場合は、空のリストが返されることに注意してください。 "matchFace" モードでは、同一人物のしきい値が無視され、ランク付けされた類似した顔が返されます。類似性が低い場合でも同様です。 有名人のような顔を検索する場合に使用できます。 <br/>クエリ顔の faceId に関連付けられている 'recognitionModel' は、ターゲット faceId 配列、顔リスト、または大きな顔リストで使用される 'recognitionModel' と同じである必要があります。

GroupAsync(IFaceOperations, IList<Guid>, CancellationToken)

顔の類似性に基づいて候補の顔をグループに分割します。<Br/>

  • 出力は、1 つ以上の分離された顔グループと messyGroup です。 顔グループには、よく同じ人物の似た顔が含まれています。 顔グループは、グループ サイズ (顔の数) によってランク付けされます。 同じ人物に属する顔が、結果内の複数のグループに分割される可能性があることに注意してください。
  • MessyGroup は、元の顔から類似した対応する顔を見つけることができない顔を含む特殊な顔グループです。 すべての顔が対応する顔を見つけた場合、結果に messyGroup は表示されません。
  • グループ API には、少なくとも 2 人の候補顔と最大 1000 人が必要です。 顔の候補が 2 つしかない場合は 、Face - Verify を試してみることをお勧めします。
  • クエリの顔に関連付けられている 'recognitionModel' faceIds は同じである必要があります。
IdentifyAsync(IFaceOperations, IList<Guid>, String, String, String, IList<String>, Nullable<Int32>, Nullable<Double>, CancellationToken)

FaceOperations 操作。

VerifyFaceToFaceAsync(IFaceOperations, Guid, Guid, CancellationToken)

2 つの顔が同一人物に属しているか 1 つの顔が 1 人の人物に属しているかを確認します。 <br/> 解説:<br />

  • 顔の画質が高いほど、識別精度が向上します。 正面、透明、顔のサイズは 200 x 200 ピクセル (目の間に 100 ピクセル) 以上の高品質の顔を検討してください。
  • 精度に敏感なシナリオについては、ご自身で判断してください。
  • クエリの顔に関連付けられている 'recognitionModel' faceIds は、ターゲットの顔、人物グループ、または大きな人物グループで使用される "recognitionModel" と同じである必要があります。
VerifyFaceToPersonAsync(IFaceOperations, Guid, Guid, String, String, CancellationToken)

2 つの顔が同じ人物に属しているかどうかを確認します。 顔 ID と人物 ID を比較します

適用対象