Text Dependent - Reset Profile

Servizio:

Azure AI Services

Versione API:

2021-09-05

Reimposta profilo
Reimposta lo stato di creazione originale del profilo esistente. L'operazione di reimpostazione esegue le operazioni seguenti:

• Aggiorna enrollmentStatus alla registrazione.
• Aggiornamenti lastUpdatedDateTime.
• Aggiorna enrollmentsCount su 0.
• Aggiorna le registrazioniLength a 0.
• Aggiorna le registrazioniSpeechLength a 0.
• Aggiorna remainingEnrollmentsCount al numero iniziale richiesto.
• Rimuove tutte le registrazioni associate dall'archiviazione.
• Rimuove l'associazione passphrase scelta.
• Reimposta il valore modelVersion.

POST {endpoint}/speaker-recognition/verification/text-dependent/profiles/{profileId}:reset?api-version=2021-09-05

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string	Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://westus.api.cognitive.microsoft.com).
profileId	path	True	string (uuid)	Identificatore univoco per l'ID del profilo (GUID).
api-version	query	True	string	Specifica la versione dell'operazione da utilizzare per questa richiesta.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Ocp-Apim-Subscription-Key	True	string

Risposte

Nome	Tipo	Descrizione
200 OK	TdProfileInfo	Reimpostazione del profilo voce completata. Il profilo viene restituito con valori di reimpostazione. Intestazioni Location: string
Other Status Codes	SpeakerErrorInfo	Fallimento Intestazioni x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Tipo: apiKey
In: header

Esempio

Successful Query

Esempio di richiesta

HTTP

POST https://westus.api.cognitive.microsoft.com/speaker-recognition/verification/text-dependent/profiles/49a36324-fc4b-4387-aa06-090cfbf0064f:reset?api-version=2021-09-05

Risposta di esempio

Codice di stato:

200

Content-Type: application/json

{
  "profileId": "49a36324-fc4b-4387-aa06-090cfbf0064f",
  "locale": "en-US",
  "enrollmentStatus": "Enrolling",
  "createdDateTime": "2015-04-23T18:25:43.41Z",
  "lastUpdatedDateTime": "2015-04-23T18:25:43.41Z",
  "enrollmentsCount": 0,
  "enrollmentsLengthInSec": 0,
  "enrollmentsSpeechLengthInSec": 0,
  "remainingEnrollmentsCount": 3,
  "modelVersion": "2019-12-05"
}

Codice di stato:

default

Content-Type: application/json
x-ms-error-code: Error Code

{
  "error": {
    "code": "Error Code",
    "message": "Erro Messae"
  }
}

Definizioni

Nome	Descrizione
Error
SpeakerErrorInfo	Messaggio di errore del parlante
TdProfileInfo	Text-Dependent informazioni sul profilo voce
TrainingStatusType	Stato che rappresenta lo stato corrente del profilo. I valori disponibili sono: Registrazione: il profilo non dispone di stampa vocale e non è pronto per le richieste di riconoscimento. Training: la stampa vocale del profilo viene creata e non può essere usata per il riconoscimento al momento. Registrato: il profilo ha una stampa vocale e pronto per le richieste di riconoscimento.

Error

Object

Nome	Tipo	Descrizione
code	string
message	string

SpeakerErrorInfo

Object

Messaggio di errore del parlante

Nome	Tipo	Descrizione
error	Error

TdProfileInfo

Object

Text-Dependent informazioni sul profilo voce

Nome	Tipo	Descrizione
createdDateTime	string (date-time)	Data/ora di creazione del profilo.
enrollmentStatus	TrainingStatusType	Stato che rappresenta lo stato corrente del profilo. I valori disponibili sono: Registrazione: il profilo non dispone di stampa vocale e non è pronto per le richieste di riconoscimento. Training: la stampa vocale del profilo viene creata e non può essere usata per il riconoscimento al momento. Registrato: il profilo ha una stampa vocale e pronto per le richieste di riconoscimento.
enrollmentsCount	integer	Numero di audio di registrazione accettati per questo profilo.
enrollmentsLengthInSec	number	Lunghezza totale degli audio di registrazione accettati per questo profilo in pochi secondi.
enrollmentsSpeechLengthInSec	number	Sommazione del parlato puro (ovvero la quantità di audio dopo la rimozione del silenzio e dei segmenti non vocali) in tutte le registrazioni del profilo in pochi secondi.
lastUpdatedDateTime	string (date-time)	Data e ora dell'ultimo aggiornamento del profilo.
locale	string pattern: ^[a-zA-Z]{2}-?[a-zA-Z]{2}$	Identificatore di lingua costituito da una combinazione di codice lingua e codice paese.
modelVersion	string (date)	Data in cui è specificato il modello assegnato a questo profilo. Il formato è yyyy-mm-dd. Se il profilo non ha registrazioni, questo valore sarà vuoto.
profileId	string (uuid)	Identificatore univoco per l'ID del profilo (GUID).
remainingEnrollmentsCount	integer	Numero di audio di registrazione necessari per completare la registrazione del profilo.

TrainingStatusType

Enumerazione

Stato che rappresenta lo stato corrente del profilo. I valori disponibili sono:

• Registrazione: il profilo non dispone di stampa vocale e non è pronto per le richieste di riconoscimento.
• Training: la stampa vocale del profilo viene creata e non può essere usata per il riconoscimento al momento.
• Registrato: il profilo ha una stampa vocale e pronto per le richieste di riconoscimento.

Valore	Descrizione
Enrolling
Training
Enrolled