Schéma de fichier d'entrée et de sortie pour le job d'inscription des conférenciers dans Amazon Connect Voice ID - Amazon Connect
Schéma de fichier d'entréeSchéma de fichier de sortie

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Schéma de fichier d'entrée et de sortie pour le job d'inscription des conférenciers dans Amazon Connect Voice ID

Schéma de fichier d'entrée

Voici le schéma du fichier manifeste d'entrée pour la tâche d'inscription de locuteur :

{
  "Version": "string",
  "SpeakerEnrollmentRequests": [
      {
          "RequestId": "string",
          "SpeakerId": "string",
          "AudioSpecifications": [
              {
                  "S3Uri": "string",
                  "ChannelId": number 
              }
           ] 
      }
   ]
}
Note

Tous les champs du schéma sont obligatoires.

Vous trouverez ci-dessous une description de chaque attribut du schéma d'entrée.

  • Version : version de document du schéma d'entrée. Actuellement, il s'agit normalement de la version 1.0.

  • SpeakerEnrollmentRequests : liste des demandes d'inscription de locuteur à traiter dans la tâche.

    • RequestId : identifiant pour cette demande d'inscription de locuteur. Il doit être unique dans le fichier d'entrée. Il sert à mapper et identifier les entrées dans le fichier de sortie.

    • SpeakerId : identifiant fourni par le client du locuteur qui doit être inscrit. Vous devez passer le CustomerSpeakerId dans ce champ. Le GeneratedSpeakerId n'est actuellement pas pris en charge.

    • AudioSpecifications : liste des fichiers audio que Voice ID peut utiliser pour inscrire ce locuteur. Voice ID utilise ces fichiers audio conjointement pour recueillir le temps de parole nécessaire pour l'inscription. Actuellement, le nombre maximal de fichiers audio autorisé pour une demande d'inscription est de 10. Chaque fichier peut être un fichier .wav d'une taille maximale de 20 Mo, contenant du son avec une fréquence d'KHzéchantillonnage de 8 et PCM un encodage de -16.

      • S3URI: emplacement Amazon S3 du fichier audio au format .wav qui doit être utilisé pour inscrire le locuteur.

      • ChannelId : canal audio à utiliser pour inscrire le locuteur contenu dans un fichier audio multicanal. Voice ID prend en charge les fichiers audio à deux canaux, au maximum. Cette valeur est donc limitée à 0 ou à 1.

Schéma de fichier de sortie

Voici le schéma du fichier de sortie généré pour la tâche d'inscription de locuteur :

{
  "Version": "string",
  "Errors": [
       {
          "RequestId": "string",
          "ErrorCode": number,
          "ErrorMessage": "string"
       }
   ],
   "SuccessfulEnrollments": [
       {
          "RequestId": "string",
          "GeneratedSpeakerId": "string",
          "CustomerSpeakerId": "string",
          "EnrollmentStatus": "DUPLICATE_SKIPPED" | "NEW_ENROLLMENT" | "ENROLLMENT_OVERWRITE"
       }
   ]   
}

Vous trouverez ci-dessous une description de chaque attribut du schéma de sortie.

  • Version : version de document du schéma de sortie. Actuellement, il s'agit normalement de la version 1.0.

  • Errors : liste d'erreurs relatives aux demandes d'inscription de locuteur qui ont échoué à un moment donné au cours de l'inscription.

    • RequestId : identifiant de demande associé à cette demande. Il correspond au RequestId spécifié dans le fichier d'entrée de cette demande.

    • ErrorCode: code HTTP d'erreur représentant le type d'erreur. Des exemples de scénarios d'erreur sont décrits ci-dessous.

      Note

      Cette liste n'est pas exhaustive.

      • 400 (exception de demande incorrecte) :

        • Le JSON fichier d'entrée est mal formé et ne peut pas être analysé.

        • Les fichiers audio fournis n'ont pas un temps de parole suffisant pour permettre l'inscription.

        • Les contrôles de vérification antifraude ont échoué pour le locuteur concerné.

      • 402 (ServiceQuotaLimitExceededException) :

        • Limite dépassée pour le locuteur.

      • 409 (exception de conflit) :

        • Action contradictoire : vous ne pouvez pas demander à inscrire un locuteur qui est désinscrit.

      • 500 (échec interne) :

        • Erreur de serveur interne (erreur inattendue côté service).

    • ErrorMessage : message décrivant la cause de l'échec d'inscription.

  • SuccessfulEnrollments : liste des demandes d'inscription ayant abouti.

    • RequestId : identifiant de demande associé à cette demande. Il correspond au RequestId spécifié dans le fichier d'entrée de cette demande.

    • CustomerSpeakerId : identifiant fourni par le client pour le locuteur qui a été inscrit.

    • GeneratedSpeakerId : identifiant généré par le service pour le locuteur qui a été inscrit.

    • EnrollmentStatus : statut d'inscription réussie pour le locuteur.

      • DUPLICATE_SKIPPED : le locuteur étant déjà inscrit, l'inscription a été ignorée.

      • NEW_ENROLLMENT : le locuteur a été dernièrement inscrit dans le système.

      • ENROLLMENT_OVERWRITE : le locuteur est déjà inscrit, mais il a été réinscrit/remplacé avec un nouvel enregistrement audio.