Partager via


FaceOperations.GroupWithHttpMessagesAsync Méthode

Définition

Divisez les visages candidats en groupes en fonction de la similarité des visages.< Br/>

  • La sortie est un ou plusieurs groupes de visages disjoints et un messyGroup. Un groupe de visages contient des visages qui ont une apparence similaire, souvent de la même personne. Les groupes de visages sont classés par taille de groupe, c’est-à-dire par nombre de visages. Notez que les visages appartenant à une même personne peuvent être divisés en plusieurs groupes dans le résultat.
  • MessyGroup est un groupe spécial de visages contenant des visages qui ne peuvent trouver aucun visage équivalent similaire à celui des visages d’origine. Le messyGroup n’apparaîtra pas dans le résultat si tous les visages trouvaient leurs équivalents.
  • L’API de groupe a besoin d’au moins 2 visages candidats et de 1 000 au maximum. Nous vous suggérons d’essayer Visage - Vérifier lorsque vous n’avez que 2 visages candidats.
  • Les faceIds « recognitionModel » associés aux visages de requête doivent être identiques.
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))

Paramètres

faceIds
IList<Guid>

Tableau de faceId candidat créé par Visage - Détecter. Le maximum est de 1 000 visages

customHeaders
Dictionary<String,List<String>>

En-têtes qui seront ajoutés à la demande.

cancellationToken
CancellationToken

Jeton d'annulation.

Retours

Implémente

Exceptions

Levée lorsque l’opération a retourné un code de status non valide

Levée en cas d’impossibilité de désérialiser la réponse

Levée lorsqu’un paramètre obligatoire a la valeur Null

Levée lorsqu’un paramètre obligatoire a la valeur Null

S’applique à