FaceOperations.GroupWithHttpMessagesAsync メソッド

定義

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

  • 出力は、1 つ以上の分離された顔グループと messyGroup です。 顔グループには、多くの場合、同じ人物に似た顔が含まれています。 顔グループは、グループ サイズ (顔の数) によってランク付けされます。 同じ人物に属する顔が、結果の複数のグループに分割される可能性があることに注意してください。
  • MessyGroup は、元の顔から類似した顔を見つけることができない顔を含む特殊な顔グループです。 すべての顔が対応する顔を見つけた場合、結果に messyGroup は表示されません。
  • グループ API には、少なくとも 2 つの候補顔と最大 1000 個が必要です。 顔の候補が 2 つしかない場合は 、Face - Verify を試してみることをお勧めします。
  • クエリの顔に関連付けられている 'recognitionModel' faceIds は同じである必要があります。
public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.GroupResult>> GroupWithHttpMessagesAsync (System.Collections.Generic.IList<Guid> faceIds, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);
abstract member GroupWithHttpMessagesAsync : System.Collections.Generic.IList<Guid> * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.GroupResult>>
override this.GroupWithHttpMessagesAsync : System.Collections.Generic.IList<Guid> * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.GroupResult>>
Public Function GroupWithHttpMessagesAsync (faceIds As IList(Of Guid), Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationResponse(Of GroupResult))

パラメーター

faceIds
IList<Guid>

Face - Detect によって作成された候補 faceId の配列。 最大は 1000 面です

customHeaders
Dictionary<String,List<String>>

要求に追加されるヘッダー。

cancellationToken
CancellationToken

キャンセル トークン。

戻り値

実装

例外

操作が無効な状態コードを返したときにスローされます

応答を逆シリアル化できない場合にスローされます

必須パラメーターが null の場合にスローされます

必須パラメーターが null の場合にスローされます

適用対象