次の方法で共有

FaceOperationsExtensions.FindSimilarAsync メソッド

  • リファレンス

定義

名前空間:
Microsoft.Azure.CognitiveServices.Vision.Face
アセンブリ:
Microsoft.Azure.CognitiveServices.Vision.Face.dll
パッケージ:
Microsoft.Azure.CognitiveServices.Vision.Face v2.8.0-preview.3
ソース:
FaceOperationsExtensions.cs

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

public static System.Threading.Tasks.Task<System.Collections.Generic.IList<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SimilarFace>> FindSimilarAsync (this Microsoft.Azure.CognitiveServices.Vision.Face.IFaceOperations operations, Guid faceId, string faceListId = default, string largeFaceListId = default, System.Collections.Generic.IList<Guid?> faceIds = default, int? maxNumOfCandidatesReturned = 20, Microsoft.Azure.CognitiveServices.Vision.Face.Models.FindSimilarMatchMode mode = Microsoft.Azure.CognitiveServices.Vision.Face.Models.FindSimilarMatchMode.MatchPerson, System.Threading.CancellationToken cancellationToken = default);
static member FindSimilarAsync : Microsoft.Azure.CognitiveServices.Vision.Face.IFaceOperations * Guid * string * string * System.Collections.Generic.IList<Nullable<Guid>> * Nullable<int> * Microsoft.Azure.CognitiveServices.Vision.Face.Models.FindSimilarMatchMode * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Collections.Generic.IList<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SimilarFace>>
<Extension()>
Public Function FindSimilarAsync (operations As IFaceOperations, faceId As Guid, Optional faceListId As String = Nothing, Optional largeFaceListId As String = Nothing, Optional faceIds As IList(Of Nullable(Of Guid)) = Nothing, Optional maxNumOfCandidatesReturned As Nullable(Of Integer) = 20, Optional mode As FindSimilarMatchMode = Microsoft.Azure.CognitiveServices.Vision.Face.Models.FindSimilarMatchMode.MatchPerson, Optional cancellationToken As CancellationToken = Nothing) As Task(Of IList(Of SimilarFace))

パラメーター

operations
IFaceOperations

この拡張メソッドの操作グループ。

faceId
Guid

クエリ顔の FaceId。 ユーザーは Face を呼び出す必要があります- 有効な faceId を取得するには、最初に検出します。 この faceId は永続化されず、検出呼び出しの 24 時間後に期限切れになることに注意してください

faceListId
String

顔リストで作成された既存のユーザー指定の一意の顔リスト

  • 顔リストを作成します。 Face リストには、永続化され、期限切れになることのない一連の persistedFaceId が含まれています。 パラメーター faceListId、largeFaceListId、および faceId を同時に指定しないでください。
largeFaceListId
String

LargeFaceList - Create で作成された既存のユーザー指定の一意の候補の大きな顔リスト。 大きな顔リストには、永続化され、期限切れになることのない一連の persistedFaceId が含まれています。 パラメーター faceListId、largeFaceListId、および faceId を同時に指定しないでください。

faceIds
IList<Nullable<Guid>>

候補の faceId の配列。 これらはすべて Face - Detect によって作成され、faceId は検出呼び出しの 24 時間後に期限切れになります。 faceId の数は 1000 に制限されています。 パラメーター faceListId、largeFaceListId、および faceId を同時に指定しないでください。

maxNumOfCandidatesReturned
Nullable<Int32>

返される上位の類似顔の数。 有効な範囲は [1, 1000] です。

mode
FindSimilarMatchMode

同様の顔検索モード。 "matchPerson" または "matchFace" を指定できます。 使用できる値は、'matchPerson'、'matchFace' です。

cancellationToken
CancellationToken

キャンセル トークン。

戻り値

Task<IList<SimilarFace>>

適用対象