Share via


PersonGroupOperations Klasse

Definition

PersonGroupOperations-Vorgänge.

public class PersonGroupOperations : Microsoft.Azure.CognitiveServices.Vision.Face.IPersonGroupOperations, Microsoft.Rest.IServiceOperations<Microsoft.Azure.CognitiveServices.Vision.Face.FaceClient>
type PersonGroupOperations = class
    interface IServiceOperations<FaceClient>
    interface IPersonGroupOperations
Public Class PersonGroupOperations
Implements IPersonGroupOperations, IServiceOperations(Of FaceClient)
Vererbung
PersonGroupOperations
Implementiert

Konstruktoren

PersonGroupOperations(FaceClient)

Initialisiert eine neue instance der PersonGroupOperations-Klasse.

Eigenschaften

Client

Ruft einen Verweis auf den FaceClient ab.

Methoden

CreateWithHttpMessagesAsync(String, String, String, String, Dictionary<String,List<String>>, CancellationToken)

Hiermit erstellen Sie eine neue Personengruppe auf der Grundlage von Personengruppen-ID (personGroupId), Name und den benutzerseitigen Angaben für Benutzerdaten (userData) und Erkennungsmodell (recognitionModel). <br/> Eine Personengruppe ist der Container der hochgeladenen Personendaten, einschließlich Gesichtsbilder und Gesichtserkennungsfeatures. <br /> Verwenden Sie nach der Erstellung PersonGroup Person – Create , um Personen zur Gruppe hinzuzufügen, und rufen Sie dann PersonGroup - Trainieren auf, um diese Gruppe für Gesichtserkennung vorzubereiten. <br /> Das Gesicht, das Bild und die userData der Person werden auf dem Server gespeichert, bis PersonGroup Person – Delete oder PersonGroup – Delete aufgerufen wird. <Br/>

  • Free-Tarif-Abonnementkontingent: 1.000 Personengruppen. Jeder fasst bis zu 1.000 Personen.
  • S0-Tarif-Abonnementkontingent: 1.000.000 Personengruppen. Jeder fasst bis zu 10.000 Personen.
  • Um probleme mit der Gesichtserkennung in größerem Umfang zu behandeln, sollten Sie Die Verwendung von LargePersonGroup in Betracht ziehen. <br/> "recognitionModel" sollte angegeben werden, um dieser Personengruppe zuzuordnen. Der Standardwert für "recognitionModel" ist "recognition_01". Wenn das neueste Modell erforderlich ist, geben Sie in diesem Parameter explizit das modell an, das Sie benötigen. Neue Gesichter, die einer vorhandenen Personengruppe hinzugefügt werden, verwenden das Erkennungsmodell, das bereits der Sammlung zugeordnet ist. Vorhandene Gesichtsfeatures in einer Personengruppe können nicht auf Features aktualisiert werden, die von einer anderen Version des Erkennungsmodells extrahiert wurden.
DeleteWithHttpMessagesAsync(String, Dictionary<String,List<String>>, CancellationToken)

Löschen sie eine vorhandene Personengruppe. Persistente Gesichtsfeatures aller Personen in der Personengruppe werden ebenfalls gelöscht.

GetTrainingStatusWithHttpMessagesAsync(String, Dictionary<String,List<String>>, CancellationToken)

Rufen Sie die status einer Personengruppe (abgeschlossen oder fortlaufend) ab.

GetWithHttpMessagesAsync(String, Nullable<Boolean>, Dictionary<String,List<String>>, CancellationToken)

Hiermit rufen Sie den Namen der Personengruppe sowie Benutzerdaten (userData) und Erkennungsmodell (recognitionModel) ab. Um Personeninformationen unter dieser personGroup abzurufen, verwenden Sie PersonGroup Person – List.

ListWithHttpMessagesAsync(String, Nullable<Int32>, Nullable<Boolean>, Dictionary<String,List<String>>, CancellationToken)

Listet personGroupId, Name, userData und recognitionModel von Personengruppen auf.< Br/>

  • Personengruppen werden in alphabetischer Reihenfolge von personGroupId gespeichert.
  • Der Parameter "start" (Zeichenfolge, optional) ist ein vom Benutzer bereitgestellter personGroupId-Wert, der zurückgegebene Einträge nach Zeichenfolgenvergleich über größere IDs verfügt. "start" wird auf leer festgelegt, um die Rückgabe vom ersten Element anzugeben.
  • Der Parameter "top" (int, optional) gibt die Anzahl der zurückzugebenden Einträge an. In einem Aufruf können maximal 1.000 Einträge zurückgegeben werden. Um mehr abzurufen, können Sie "start" mit der ID des letzten geänderten Eintrags des aktuellen Aufrufs angeben. <br /> Zum Beispiel insgesamt 5 Personengruppen: "group1", ..., "group5". <br/> "start=&top=" gibt alle 5 Gruppen zurück. <br/> "start=&top=2" gibt "group1", "group2" zurück. <br/> "start=group2&top=3" gibt "group3", "group4", "group5" zurück.
TrainWithHttpMessagesAsync(String, Dictionary<String,List<String>>, CancellationToken)

Stellen Sie eine Trainingsaufgabe für eine Personengruppe in die Warteschlange ein. Die Trainingsaufgabe wird möglicherweise nicht sofort gestartet.

UpdateWithHttpMessagesAsync(String, String, String, Dictionary<String,List<String>>, CancellationToken)

Aktualisieren Sie den Anzeigenamen und userData einer vorhandenen Personengruppe. Die Eigenschaften, die nicht im Anforderungstext angezeigt werden, werden nicht aktualisiert.

Erweiterungsmethoden

CreateAsync(IPersonGroupOperations, String, String, String, String, CancellationToken)

Hiermit erstellen Sie eine neue Personengruppe auf der Grundlage von Personengruppen-ID (personGroupId), Name und den benutzerseitigen Angaben für Benutzerdaten (userData) und Erkennungsmodell (recognitionModel). <br/> Eine Personengruppe ist der Container der hochgeladenen Personendaten, einschließlich Gesichtsbilder und Gesichtserkennungsfeatures. <br /> Verwenden Sie nach der Erstellung PersonGroup Person – Create , um Personen zur Gruppe hinzuzufügen, und rufen Sie dann PersonGroup - Trainieren auf, um diese Gruppe für Gesichtserkennung vorzubereiten. <br /> Das Gesicht, das Bild und die userData der Person werden auf dem Server gespeichert, bis PersonGroup Person – Delete oder PersonGroup – Delete aufgerufen wird. <Br/>

  • Free-Tarif-Abonnementkontingent: 1.000 Personengruppen. Jeder fasst bis zu 1.000 Personen.
  • S0-Tarif-Abonnementkontingent: 1.000.000 Personengruppen. Jeder fasst bis zu 10.000 Personen.
  • Um probleme mit der Gesichtserkennung in größerem Umfang zu behandeln, sollten Sie Die Verwendung von LargePersonGroup in Betracht ziehen. <br/> "recognitionModel" sollte angegeben werden, um dieser Personengruppe zuzuordnen. Der Standardwert für "recognitionModel" ist "recognition_01". Wenn das neueste Modell erforderlich ist, geben Sie in diesem Parameter explizit das modell an, das Sie benötigen. Neue Gesichter, die einer vorhandenen Personengruppe hinzugefügt werden, verwenden das Erkennungsmodell, das bereits der Sammlung zugeordnet ist. Vorhandene Gesichtsfeatures in einer Personengruppe können nicht auf Features aktualisiert werden, die von einer anderen Version des Erkennungsmodells extrahiert wurden.
DeleteAsync(IPersonGroupOperations, String, CancellationToken)

Löschen sie eine vorhandene Personengruppe. Persistente Gesichtsfeatures aller Personen in der Personengruppe werden ebenfalls gelöscht.

GetAsync(IPersonGroupOperations, String, Nullable<Boolean>, CancellationToken)

Hiermit rufen Sie den Namen der Personengruppe sowie Benutzerdaten (userData) und Erkennungsmodell (recognitionModel) ab. Um Personeninformationen unter dieser personGroup abzurufen, verwenden Sie PersonGroup Person – List.

GetTrainingStatusAsync(IPersonGroupOperations, String, CancellationToken)

Rufen Sie die status einer Personengruppe (abgeschlossen oder fortlaufend) ab.

ListAsync(IPersonGroupOperations, String, Nullable<Int32>, Nullable<Boolean>, CancellationToken)

Listet personGroupId, Name, userData und recognitionModel von Personengruppen auf.< Br/>

  • Personengruppen werden in alphabetischer Reihenfolge von personGroupId gespeichert.
  • Der Parameter "start" (Zeichenfolge, optional) ist ein vom Benutzer bereitgestellter personGroupId-Wert, der zurückgegebene Einträge nach Zeichenfolgenvergleich über größere IDs verfügt. "start" wird auf leer festgelegt, um die Rückgabe vom ersten Element anzugeben.
  • Der Parameter "top" (int, optional) gibt die Anzahl der zurückzugebenden Einträge an. In einem Aufruf können maximal 1.000 Einträge zurückgegeben werden. Um mehr abzurufen, können Sie "start" mit der ID des letzten geänderten Eintrags des aktuellen Aufrufs angeben. <br /> Zum Beispiel insgesamt 5 Personengruppen: "group1", ..., "group5". <br/> "start=&top=" gibt alle 5 Gruppen zurück. <br/> "start=&top=2" gibt "group1", "group2" zurück. <br/> "start=group2&top=3" gibt "group3", "group4", "group5" zurück.
TrainAsync(IPersonGroupOperations, String, CancellationToken)

Stellen Sie eine Trainingsaufgabe für eine Personengruppe in die Warteschlange ein. Die Trainingsaufgabe wird möglicherweise nicht sofort gestartet.

UpdateAsync(IPersonGroupOperations, String, String, String, CancellationToken)

Aktualisieren Sie den Anzeigenamen und userData einer vorhandenen Personengruppe. Die Eigenschaften, die nicht im Anforderungstext angezeigt werden, werden nicht aktualisiert.

Gilt für: