PartyVoiceChatTranscriptionReceivedStateChange
Spezifische Informationen für die Zustandsänderungsart VoiceChatTranscriptionReceived .
Syntax
struct PartyVoiceChatTranscriptionReceivedStateChange : PartyStateChange {
PartyStateChangeResult result;
PartyError errorDetail;
PartyChatControl* senderChatControl;
uint32_t receiverChatControlCount;
PartyLocalChatControlArray receiverChatControls;
PartyAudioSourceType sourceType;
PartyString languageCode;
PartyString transcription;
PartyVoiceChatTranscriptionPhraseType type;
uint32_t translationCount;
PartyTranslation* translations;
}
Mitglieder
result
PartyStateChangeResult
Gibt an, dass der Transkriptionsvorgang erfolgreich war, oder gibt den Grund für den Fehler an.
Bei Erfolg ist das transcription Feld eine Zeichenfolge mit einer Länge ungleich 0 (null). Bei einem Fehler ist die Zeichenfolge leer. Fehler gibt an, dass ein Transkriptionsvorgang für den Sprecher versucht wurde, aber nicht abgeschlossen werden konnte. Wenn die Transkription auf Anforderung des Benutzers aktiviert wird, der dem Chat-Steuerelement zugeordnet ist, und die Transkriptionsnachrichten über die Benutzeroberfläche angezeigt werden, wird empfohlen, dem Benutzer auch Fehler anzuzeigen, um Feedback zu geben, ob Transkriptionen ausstehen oder fehlgeschlagen sind.
errorDetail PartyError
Ein Diagnosewert, der zusätzliche Informationen zur Problembehandlung für mögliche Fehlerzustände bereitstellt.
Die lesbare Form dieses Fehlerdetails kann über PartyManager::GetErrorMessage() abgerufen werden.
senderChatControl
PartyChatControl*
Das Chat-Steuerelementobjekt, das die Transkriptionsnachricht ausgelöst hat.
receiverChatControlCount uint32_t
Die Anzahl der lokalen Empfänger-Chatsteuerelemente, an die die Transkription adressiert wird.
receiverChatControls
PartyLocalChatControlArray
Array der Größe receiverChatControlCount
Der lokale Empfängerchat steuert, an welchen die Transkription adressiert wird.
sourceType
PartyAudioSourceType
Der Typ der Audioquelle, die diese Transkription darstellt.
Der Audioquellentyp kann optional für Spielszenarien verwendet werden, in denen Transkriptionen aus verschiedenen Quelltypen unterschiedlich behandelt werden sollen. Für instance können unterschiedliche Symbole angezeigt werden, je nachdem, ob die Transkription mit Mikrofon oder Sprachsynthese verbunden ist.
languageCode
PartyString
Der Sprachcode der Transkription.
Der Sprachcode wird immer bereitgestellt, wenn das result Feld den Erfolg anzeigt. Andernfalls ist der Sprachcode eine leere Zeichenfolge.
Der Sprachcode liegt im BCP 47-Format vor, z. B. en-US für Englisch (USA). Unterstützte Sprachcodes werden in der Sprachunterstützung aufgelistet.
transcription
PartyString
Der transkribierte Sprachchattext.
Die Zeichenfolge kann bis zu c_maxChatTextMessageLength zeichenlang sein, ohne dass das NULL-Abschlusszeichen enthalten ist. Die Zeichenfolge ist immer leer, wenn das result Feld auf Fehler hinweist.
type
PartyVoiceChatTranscriptionPhraseType
Gibt den Ausdruckstyp des im Feld bereitgestellten transcription Texts an.
Der Typ ist immer PartyVoiceChatTranscriptionPhraseType::Final , wenn das result Feld auf einen Fehler hinweist.
translationCount uint32_t
Die Anzahl der Übersetzungen, die dem transkribierten Sprachchattext zugeordnet sind.
Übersetzungen werden bereitgestellt, wenn PartyVoiceChatTranscriptionOptions::TranslateToLocalLanguage zuvor über PartyLocalChatControl::SetTranscriptionOptions() in einem auf diesem Gerät lokalen Chatsteuerelement angegeben wurde. Es kann mehrere Übersetzungen geben, wenn mehrere lokale Chatsteuerelemente die Übersetzung aktiviert haben und die lokalen Chatsteuerelemente unterschiedliche Sprachen über PartyLocalDevice::CreateChatControl() angegeben haben. In diesem Fall kann die App das languageCode Feld jeder PartyTranslation in translations mit dem Sprachcode vergleichen, der über PartyLocalChatControl::GetLanguage()für jedes lokale Chat-Steuerelement in receiverChatControls abgerufen wird, um das lokale Chat-Zielsteuerelement für jede Übersetzung zu bestimmen.
translations
PartyTranslation*
Array der Größe translationCount
Ein Array, das die Übersetzungen der Transkriptionszeichenfolge des Sprachchats enthält.
Übersetzungen werden bereitgestellt, wenn PartyVoiceChatTranscriptionOptions::TranslateToLocalLanguage zuvor über PartyLocalChatControl::SetTranscriptionOptions() in einem auf diesem Gerät lokalen Chatsteuerelement angegeben wurde. Es kann mehrere Übersetzungen geben, wenn mehrere lokale Chatsteuerelemente die Übersetzung aktiviert haben und die lokalen Chatsteuerelemente unterschiedliche Sprachen über PartyLocalDevice::CreateChatControl() angegeben haben. In diesem Fall kann die App das languageCode Feld jeder PartyTranslation in translations mit dem Sprachcode vergleichen, der über PartyLocalChatControl::GetLanguage()für jedes lokale Chat-Steuerelement in receiverChatControls abgerufen wird, um das lokale Chat-Zielsteuerelement für jede Übersetzung zu bestimmen.
Eine Übersetzung, die der Sprache für jedes Chatsteuerelement in entspricht, in receiverChatControls dem die Übersetzung aktiviert wurde, wird bereitgestellt, auch wenn die Sprache des sprechenden Chatsteuerelements mit der Sprache des lokalen Chatsteuerelements übereinstimmt. In einem solchen Fall sind die Transkriptions- und Übersetzungszeichenfolgen identisch.
Voraussetzungen
Header: Party.h
Weitere Informationen
Party-Mitglieder
PartyLocalDevice::CreateChatControl
PartyLocalChatControl::SetTranscriptionOptions