PartyTranslation
Eine Übersetzung.
Syntax
struct PartyTranslation {
PartyStateChangeResult result;
PartyError errorDetail;
PartyString languageCode;
PartyTranslationReceivedOptions options;
PartyString translation;
}
Mitglieder
result
PartyStateChangeResult
Gibt an, ob der Übersetzungsvorgang erfolgreich war.
Bei Erfolg translation
ist eine Zeichenfolge mit einer Länge ungleich null, die den übersetzten Text enthält. Bei einem Fehler ist die Zeichenfolge leer.
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.
languageCode
PartyString
Der Sprachcode der Übersetzung.
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.
options
PartyTranslationReceivedOptions
Zusätzliche Optionen, die die Übersetzung beschreiben.
translation
PartyString
Die Übersetzungszeichenfolge.
Standardmäßig ist anstößige Maskierung aktiviert und ersetzt jedes Zeichen eines anstößigen Worts durch ein Sternchen. Anstößige Maskierung wird nach der Übersetzung der nicht maskierten Quelltranskription angewendet. Je nach Kontext ist es möglich, dass die Transkription maskierte Anstößigkeiten enthält, aber nicht die Übersetzung. Ebenso ist es möglich, dass die Übersetzung maskierte Anstößigkeiten enthält, aber nicht die ursprüngliche Transkription. Anstößige Maskierung kann über PartyVoiceChatTranscriptionOptions::D isableProfanityMasking deaktiviert werden.
Die Übersetzungszeichenfolge kann bis zu c_maxChatTextMessageLength
zeichenlang sein, ohne das NULL-Abschlusszeichen. Eine Kürzung tritt auf, wenn die übersetzte Zeichenfolgenlänge diesen Grenzwert überschreiten würde, was aufgrund von Sprachunterschieden auftreten kann, obwohl die ursprüngliche Zeichenfolgenlänge kleiner oder gleich c_maxChatTextMessageLength
ist. In einem solchen Fall options
enthält PartyTranslationReceivedOptions::Truncated. Kürzungen können an einem beliebigen Punkt in der UTF-8-Bytesequenz auftreten und nicht zu einem vollständigen, gültigen Zeichen oder Wort führen. Zeichenfolgen werden immer null beendet, auch wenn sie abgeschnitten werden.
Voraussetzungen
Header: Party.h