Syntaxe
Membres
result PartyStateChangeResult
Indique que l’opération de transcription a réussi (Succeeded) ou fournit la raison de son échec.
En cas de réussite, le champ transcription est une chaîne de longueur non nulle. En cas d’échec, la chaîne est vide. Un échec indique qu’une opération de transcription a été tentée pour le locuteur, mais qu’elle n’a pas pu être terminée. Si la transcription est activée à la demande de l’utilisateur associé au contrôle de conversation et que les messages de transcription sont affichés dans l’interface utilisateur, il est recommandé d’indiquer également les échecs à l’utilisateur afin de lui faire savoir si les transcriptions sont en attente ou ont échoué.
errorDetail PartyError
Valeur de diagnostic fournissant des informations de dépannage supplémentaires sur toute condition d’erreur potentielle.
La forme lisible de ce détail d’erreur peut être obtenue via PartyManager::GetErrorMessage().
senderChatControl PartyChatControl*
L’objet de contrôle de conversation à l’origine du message de transcription.
receiverChatControlCount uint32_t
Le nombre de contrôles de conversation récepteurs locaux auxquels la transcription est adressée.
receiverChatControls PartyLocalChatControlArrayarray of size
receiverChatControlCount
Les contrôles de conversation récepteurs locaux auxquels la transcription est adressée.
sourceType PartyAudioSourceType
Le type de source audio que représente cette transcription.
Le type de source audio peut éventuellement être utilisé dans les scénarios de jeu où les transcriptions provenant de différents types de sources doivent être traitées différemment. Par exemple, une iconographie différente peut être affichée selon que la transcription est associée à l’audio du microphone ou à celui de la synthèse vocale.
languageCode PartyString
Le code de langue de la transcription.
Le code de langue est toujours fourni lorsque le champ result indique une réussite. Sinon, le code de langue est une chaîne vide. Le code de langue est au format BCP 47, par exemple en-US pour l’anglais (États-Unis). Les codes de langue pris en charge sont énumérés dans Prise en charge des langues.
transcription PartyString
Le texte de conversation vocale transcrit.
La chaîne peut contenir jusqu’à c_maxChatTextMessageLength caractères, sans compter le terminateur null. La chaîne est toujours vide lorsque le champ result indique des échecs.
type PartyVoiceChatTranscriptionPhraseType
Indique le type d’expression du texte fourni dans le champ transcription.
Le type est toujours PartyVoiceChatTranscriptionPhraseType::Final lorsque le champ result indique un échec.
translationCount uint32_t
Le nombre de traductions associées au texte de conversation vocale transcrit.
Les traductions sont fournies si PartyVoiceChatTranscriptionOptions::TranslateToLocalLanguage a été spécifié précédemment via PartyLocalChatControl::SetTranscriptionOptions() sur un contrôle de conversation local à cet appareil. Il peut y avoir plusieurs traductions si plusieurs contrôles de conversation locaux ont activé la traduction et ont spécifié des langues différentes via PartyLocalDevice::CreateChatControl(). Dans ce cas, l’application peut comparer le champ languageCode de chaque PartyTranslation de translations au code de langue, obtenu via PartyLocalChatControl::GetLanguage(), de chaque contrôle de conversation local de receiverChatControls afin de déterminer le contrôle de conversation local cible de chaque traduction.
translations PartyTranslation*array of size
translationCount
Tableau contenant les traductions de la chaîne de transcription de la conversation vocale.
Les traductions sont fournies si PartyVoiceChatTranscriptionOptions::TranslateToLocalLanguage a été spécifié précédemment via PartyLocalChatControl::SetTranscriptionOptions() sur un contrôle de conversation local à cet appareil. Il peut y avoir plusieurs traductions si plusieurs contrôles de conversation locaux ont activé la traduction et ont spécifié des langues différentes via PartyLocalDevice::CreateChatControl(). Dans ce cas, l’application peut comparer le champ languageCode de chaque PartyTranslation de translations au code de langue, obtenu via PartyLocalChatControl::GetLanguage(), de chaque contrôle de conversation local de receiverChatControls afin de déterminer le contrôle de conversation local cible de chaque traduction. Une traduction correspondant à la langue de chaque contrôle de conversation de
receiverChatControls ayant activé la traduction est fournie, même si la langue du contrôle de conversation qui parle est la même que celle du contrôle de conversation local. Dans ce cas, les chaînes de transcription et de traduction sont identiques.
Configuration requise
En-tête : Party.hVoir aussi
Membres de PartyPartyLocalDevice::CreateChatControl
PartyLocalChatControl::SetTranscriptionOptions