Freigeben über

PartyChatTextReceivedStateChange

  • Artikel

Informationen, die für den ChatTextReceived-Typ der Zustandsänderung spezifisch sind.

Syntax

struct PartyChatTextReceivedStateChange : PartyStateChange {  
    PartyChatControl* senderChatControl;  
    uint32_t receiverChatControlCount;  
    PartyLocalChatControlArray receiverChatControls;  
    PartyString languageCode;  
    PartyString chatText;  
    uint32_t dataSize;  
    const void* data;  
    uint32_t translationCount;  
    PartyTranslation* translations;  
    PartyChatTextReceivedOptions options;  
    PartyString originalChatText;  
    PartyError errorDetail;  
}

Mitglieder

senderChatControl PartyChatControl*

Das Chat-Steuerelementobjekt, das von der SMS stammt.

receiverChatControlCount uint32_t

Die Anzahl der lokalen Empfänger-Chatsteuerelemente, an die die SMS adressiert wird.

receiverChatControls PartyLocalChatControlArray
Array der Größe receiverChatControlCount

Der lokale Empfängerchat steuert, an welche SMS adressiert wird.

languageCode PartyString

Die Sprache des Chattexts.

Die Sprache wird nur bereitgestellt, wenn die Übersetzung in die lokale Sprache aktiviert ist. Wenn die Übersetzung nicht aktiviert ist oder während der Übersetzung ein Fehler auftritt, 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.

chatText PartyString

Der empfangene Chattext.

Die Zeichenfolge kann bis zu c_maxChatTextMessageLength zeichenlang sein, ohne dass das NULL-Abschlusszeichen enthalten ist.

Wenn das Filtern aktiviert ist, handelt es sich bei diesem Text möglicherweise nicht um den genauen Text, der vom Remotebenutzer gesendet wird. Der genaue Quelltext kann aus dem originalChatText Feld abgerufen werden.

dataSize uint32_t

Die Größe der Daten, die dieser SMS zugeordnet sind.

data const void*
Puffer der Größe dataSize von Bytes

Die daten, die dieser SMS zugeordnet sind.

translationCount uint32_t

Die Anzahl der Übersetzungen, die dem Chattext zugeordnet sind.

Übersetzungen werden bereitgestellt, wenn PartyTextChatOptions::TranslateToLocalLanguage zuvor über PartyLocalChatControl::SetTextChatOptions() 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 Chattextzeichenfolge enthält.

Übersetzungen werden bereitgestellt, wenn PartyTextChatOptions::TranslateToLocalLanguage zuvor über PartyLocalChatControl::SetTextChatOptions() 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.

options PartyChatTextReceivedOptions

Flags, die zusätzliche Informationen zum Chattext beschreiben.

originalChatText PartyString

Die ursprüngliche Version des eingehenden Textchats.

Dieses Feld ist immer der ungefilterte Quelltext, der vom Remotebenutzer gesendet wird. Wenn die Filterung nicht aktiviert ist, handelt es sich um einen Zeiger auf chatText. Wenn die Filterung aktiviert ist, aber keine Filterung erforderlich war, wie durch PartyChatTextReceivedOptions::None im options Feld angegeben, ist dies ein Zeiger auf chatText.

errorDetail PartyError

Ein Diagnosewert, der zusätzliche Informationen zur Problembehandlung für mögliche Fehlerzustände bereitstellt.

Dieser Fehler ist nur für Diagnosezwecke vorgesehen. Wenn ein Fehler auftritt, ist das Flag PartyChatTextReceivedOptions::FilteredDueToError im options Feld vorhanden.

Voraussetzungen

Header: Party.h

Weitere Informationen

Party-Mitglieder
PartyLocalDevice::CreateChatControl
PartyLocalChatControl::SendText
PartyLocalChatControl::SetTextChatOptions