Freigeben über


FaceOperations Klasse

Definition

FaceOperations-Vorgänge.

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)
Vererbung
FaceOperations
Implementiert

Konstruktoren

FaceOperations(FaceClient)

Initialisiert eine neue instance der FaceOperations-Klasse.

Eigenschaften

Client

Ruft einen Verweis auf den FaceClient ab.

Methoden

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

FaceOperations-Vorgänge.

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

FaceOperations-Vorgänge.

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

Hiermit können Sie anhand der faceId des abgefragten Gesichts ähnliche Gesichter aus einem faceId-Array, einer Gesichterliste oder einer umfangreichen Gesichterliste suchen. das faceId-Array enthält die von Face – Detect erstellten Gesichter, die 24 Stunden nach der Erstellung ablaufen. Eine "faceListId" wird von FaceList – Create erstellt, die persistedFaceIds enthält, die nicht ablaufen. Und eine "largeFaceListId" wird von LargeFaceList erstellt– Create mit persistedFaceIds, die ebenfalls nicht ablaufen. Abhängig von der Eingabe enthält die zurückgegebene Liste ähnlicher Gesichter faceIds oder persistedFaceIds, die nach Ähnlichkeit sortiert werden. <br/>Find similar hat zwei Arbeitsmodi, "matchPerson" und "matchFace". "matchPerson" ist der Standardmodus, in dem versucht wird, Gesichter derselben Person wie möglich mithilfe interner Schwellenwerte derselben Person zu finden. Es ist nützlich, die anderen Fotos einer bekannten Person zu finden. Beachten Sie, dass eine leere Liste zurückgegeben wird, wenn keine Gesichter die internen Schwellenwerte überschreiten. Der "matchFace"-Modus ignoriert Schwellenwerte für die gleiche Person und gibt trotzdem ranggleiche Gesichter zurück, selbst wenn die Ähnlichkeit gering ist. Es kann in Fällen verwendet werden, wie z. B. das Durchsuchen von Prominenten aussehenden Gesichtern. <br/>Das "recognitionModel", das der faceId der Abfragegesicht zugeordnet ist, sollte mit dem "recognitionModel" identisch sein, das vom FaceId-Array, der Gesichtsliste oder der großen Gesichtsliste des Ziels verwendet wird.

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

Teilen Sie Kandidatengesichter basierend auf der Gesichtsähnlichkeit in Gruppen auf.< Br/>

  • Die Ausgabe ist eine oder mehrere getrennte Gesichtsgruppen und eine messyGroup. Eine Gesichtsgruppe enthält Gesichter, die ähnlich aussehen, oft von derselben Person. Gesichtsgruppen werden nach Gruppengröße sortiert, d. h. nach Anzahl der Gesichter. Beachten Sie, dass Gesichter, die zu einer person gehören, im Ergebnis in mehrere Gruppen aufgeteilt werden können.
  • MessyGroup ist eine spezielle Gesichtsgruppe, die Gesichter enthält, die keine ähnlichen Entsprechungsgesichtsflächen von originalen Gesichtern finden können. Die messyGroup wird nicht im Ergebnis angezeigt, wenn alle Gesichter ihre Entsprechungen gefunden haben.
  • Die Gruppen-API benötigt mindestens 2 Kandidaten gesichter und höchstens 1000. Es wird empfohlen, Gesichtserkennung – Überprüfen Sie, wenn Sie nur über 2 Kandidatengesichter verfügen.
  • Das "recognitionModel", das den FaceIds der Abfragegesichten zugeordnet ist, sollte identisch sein.
IdentifyWithHttpMessagesAsync(IList<Guid>, String, String, String, IList<String>, Nullable<Int32>, Nullable<Double>, Dictionary<String, List<String>>, CancellationToken)

FaceOperations-Vorgänge.

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

Hiermit überprüfen Sie, ob zwei Gesichter zu derselben Person gehören oder ob je ein Gesicht zu einer Person gehört. <br/> Hinweise:<br />

  • Eine höhere Qualität der Gesichtsbilder bedeutet eine bessere Identifizierungsgenauigkeit. Bitte berücksichtigen Sie hochwertige Gesichter: Frontal, Klar und Gesichtsgröße beträgt 200 x 200 Pixel (100 Pixel zwischen den Augen) oder größer.
  • Für die Szenarien, die empfindlich auf Genauigkeit sind, treffen Sie bitte Ihr eigenes Urteil.
  • Das "recognitionModel", das den FaceIds der Abfragegesichter zugeordnet ist, sollte mit dem "recognitionModel" identisch sein, das vom Zielgesicht, der Personengruppe oder einer großen Personengruppe verwendet wird.
VerifyFaceToPersonWithHttpMessagesAsync(Guid, Guid, String, String, Dictionary<String,List<String>>, CancellationToken)

Überprüfen Sie, ob zwei Gesichter zu einer person gehören. Vergleicht eine Gesichts-ID mit einer Personen-ID

Erweiterungsmethoden

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

FaceOperations-Vorgänge.

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

FaceOperations-Vorgänge.

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

Hiermit können Sie anhand der faceId des abgefragten Gesichts ähnliche Gesichter aus einem faceId-Array, einer Gesichterliste oder einer umfangreichen Gesichterliste suchen. das faceId-Array enthält die von Face – Detect erstellten Gesichter, die 24 Stunden nach der Erstellung ablaufen. Eine "faceListId" wird von FaceList – Create erstellt, die persistedFaceIds enthält, die nicht ablaufen. Und eine "largeFaceListId" wird von LargeFaceList erstellt– Create mit persistedFaceIds, die ebenfalls nicht ablaufen. Abhängig von der Eingabe enthält die zurückgegebene Liste ähnlicher Gesichter faceIds oder persistedFaceIds, die nach Ähnlichkeit sortiert werden. <br/>Find similar hat zwei Arbeitsmodi, "matchPerson" und "matchFace". "matchPerson" ist der Standardmodus, in dem versucht wird, Gesichter derselben Person wie möglich mithilfe interner Schwellenwerte derselben Person zu finden. Es ist nützlich, die anderen Fotos einer bekannten Person zu finden. Beachten Sie, dass eine leere Liste zurückgegeben wird, wenn keine Gesichter die internen Schwellenwerte überschreiten. Der "matchFace"-Modus ignoriert Schwellenwerte für die gleiche Person und gibt trotzdem ranggleiche Gesichter zurück, selbst wenn die Ähnlichkeit gering ist. Es kann in Fällen verwendet werden, wie z. B. das Durchsuchen von Prominenten aussehenden Gesichtern. <br/>Das "recognitionModel", das der faceId der Abfragegesicht zugeordnet ist, sollte mit dem "recognitionModel" identisch sein, das vom FaceId-Array, der Gesichtsliste oder der großen Gesichtsliste des Ziels verwendet wird.

GroupAsync(IFaceOperations, IList<Guid>, CancellationToken)

Teilen Sie Kandidatengesichter basierend auf der Gesichtsähnlichkeit in Gruppen auf.< Br/>

  • Die Ausgabe ist eine oder mehrere getrennte Gesichtsgruppen und eine messyGroup. Eine Gesichtsgruppe enthält Gesichter, die ähnlich aussehen, oft von derselben Person. Gesichtsgruppen werden nach Gruppengröße sortiert, d. h. nach Anzahl der Gesichter. Beachten Sie, dass Gesichter, die zu einer person gehören, im Ergebnis in mehrere Gruppen aufgeteilt werden können.
  • MessyGroup ist eine spezielle Gesichtsgruppe, die Gesichter enthält, die keine ähnlichen Entsprechungsgesichtsflächen von originalen Gesichtern finden können. Die messyGroup wird nicht im Ergebnis angezeigt, wenn alle Gesichter ihre Entsprechungen gefunden haben.
  • Die Gruppen-API benötigt mindestens 2 Kandidaten gesichter und höchstens 1000. Es wird empfohlen, Gesichtserkennung – Überprüfen Sie, wenn Sie nur über 2 Kandidatengesichter verfügen.
  • Das "recognitionModel", das den FaceIds der Abfragegesichten zugeordnet ist, sollte identisch sein.
IdentifyAsync(IFaceOperations, IList<Guid>, String, String, String, IList<String>, Nullable<Int32>, Nullable<Double>, CancellationToken)

FaceOperations-Vorgänge.

VerifyFaceToFaceAsync(IFaceOperations, Guid, Guid, CancellationToken)

Hiermit überprüfen Sie, ob zwei Gesichter zu derselben Person gehören oder ob je ein Gesicht zu einer Person gehört. <br/> Hinweise:<br />

  • Eine höhere Qualität der Gesichtsbilder bedeutet eine bessere Identifizierungsgenauigkeit. Bitte berücksichtigen Sie hochwertige Gesichter: Frontal, Klar und Gesichtsgröße beträgt 200 x 200 Pixel (100 Pixel zwischen den Augen) oder größer.
  • Für die Szenarien, die empfindlich auf Genauigkeit sind, treffen Sie bitte Ihr eigenes Urteil.
  • Das "recognitionModel", das den FaceIds der Abfragegesichter zugeordnet ist, sollte mit dem "recognitionModel" identisch sein, das vom Zielgesicht, der Personengruppe oder einer großen Personengruppe verwendet wird.
VerifyFaceToPersonAsync(IFaceOperations, Guid, Guid, String, String, CancellationToken)

Überprüfen Sie, ob zwei Gesichter zu einer person gehören. Vergleicht eine Gesichts-ID mit einer Personen-ID

Gilt für: