Freigeben über


PersonGroupOperationsExtensions.CreateAsync Methode

Definition

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 - Train auf, um diese Gruppe für Face - Identify vorzubereiten. <br /> Gesicht, Bild und UserData der Person werden auf dem Server gespeichert, bis PersonGroup Person – Delete oder PersonGroup – Delete aufgerufen wird. <Br/>

  • Abonnementkontingent für den kostenlosen Tarif: 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 ein größeres Problem mit der Gesichtserkennung zu behandeln, sollten Sie Die Verwendung von LargePersonGroup in Erwägung 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 bitte explizit das modell an, das Sie in diesem Parameter 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.
public static System.Threading.Tasks.Task CreateAsync (this Microsoft.Azure.CognitiveServices.Vision.Face.IPersonGroupOperations operations, string personGroupId, string name, string userData = default, string recognitionModel = default, System.Threading.CancellationToken cancellationToken = default);
static member CreateAsync : Microsoft.Azure.CognitiveServices.Vision.Face.IPersonGroupOperations * string * string * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
<Extension()>
Public Function CreateAsync (operations As IPersonGroupOperations, personGroupId As String, name As String, Optional userData As String = Nothing, Optional recognitionModel As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

operations
IPersonGroupOperations

Die Vorgangsgruppe für diese Erweiterungsmethode.

personGroupId
String

Id, die auf eine bestimmte Personengruppe verweist.

name
String

Benutzerdefinierter Name, maximale Länge ist 128.

userData
String

Vom Benutzer angegebene Daten. Die Länge sollte 16 KB nicht überschreiten.

recognitionModel
String

Mögliche Werte: "recognition_01", "recognition_02"

cancellationToken
CancellationToken

Das Abbruchtoken.

Gibt zurück

Gilt für: