FaceOperations.GroupWithHttpMessagesAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.CognitiveServices.Vision.Face

Ensamblado:

Microsoft.Azure.CognitiveServices.Vision.Face.dll

Paquete:

Microsoft.Azure.CognitiveServices.Vision.Face v2.8.0-preview.3

Source:

FaceOperations.cs

Divida las caras candidatas en grupos en función de la similitud facial.< Br/>

• La salida es uno o varios grupos de caras separados y un messyGroup. Un grupo de caras contiene caras que tienen un aspecto similar, a menudo de la misma persona. Los grupos de caras se clasifican por tamaño de grupo, es decir, el número de caras. Observe que las caras que pertenecen a una misma persona pueden dividirse en varios grupos en el resultado.
• MessyGroup es un grupo de caras especial que contiene caras que no pueden encontrar ninguna cara equivalente similar de caras originales. El messyGroup no aparecerá en el resultado si todas las caras encontraron sus homólogos.
• La API de grupo necesita al menos 2 caras candidatas y 1000 como máximo. Se recomienda probar Face- Verify cuando solo tenga 2 caras candidatas.
• El "recognitionModel" asociado a las caras de consulta" faceIds debe ser el mismo.

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))

Parámetros

faceIds

IList<Guid>

Matriz de faceId candidata creada por Face - Detect. El máximo es de 1000 caras

customHeaders

Dictionary<String,List<String>>

Encabezados que se agregarán a la solicitud.

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task<HttpOperationResponse<GroupResult>>

Implementaciones

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

Excepciones

APIErrorException

Se produce cuando la operación devolvió un código de estado no válido

SerializationException

Se produce cuando no se puede deserializar la respuesta

ValidationException

Se produce cuando un parámetro obligatorio es NULL

ArgumentNullException

Se produce cuando un parámetro obligatorio es NULL