Freigeben über


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_maxChatTextMessageLengthist. 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

Weitere Informationen

Party-Mitglieder