> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PartyChatTextReceivedStateChange

> *ChatTextReceived* 類型狀態變更的特定資訊。

*ChatTextReceived* 類型狀態變更的特定資訊。

## 語法

```cpp theme={null}
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;  
}  
```

### 成員

**`senderChatControl`**   [PartyChatControl](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyChatControl/partychatcontrol.md)\*

發出文字訊息的聊天控制項物件。

**`receiverChatControlCount`**   uint32\_t

文字訊息所傳送給的本機接收者聊天控制項數目。

**`receiverChatControls`**   [PartyLocalChatControlArray](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/typedefs.md)\
*大小為 `receiverChatControlCount` 的陣列*

文字訊息所傳送給的本機接收者聊天控制項。

**`languageCode`**   [PartyString](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/typedefs.md)

聊天文字的語言。

只有在啟用翻譯為本機語言時，才會提供語言。如果未啟用翻譯，或在翻譯期間發生失敗，語言代碼會是空字串。 \
\
 語言代碼採用 BCP 47 格式，例如英文 (美國) 為 en-US。支援的語言代碼列舉於[語言支援](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/language-support)中。

**`chatText`**   [PartyString](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/typedefs.md)

收到的聊天文字。

字串最長可達 `c_maxChatTextMessageLength` 個字元 (不含 null 結束字元)。 \
\
 啟用篩選時，此文字可能不是遠端使用者傳送的確切文字。確切的來源文字可以從 `originalChatText` 欄位擷取。

**`dataSize`**   uint32\_t

與此文字訊息相關聯之資料的大小。

**`data`**   const void\*\
*大小為 `dataSize` 位元組的緩衝區*

與此文字訊息相關聯的資料。

**`translationCount`**   uint32\_t

與聊天文字相關聯的翻譯數目。

如果先前已在此裝置的本機聊天控制項上透過 [PartyLocalChatControl::SetTextChatOptions()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions.md) 指定了 [PartyTextChatOptions::TranslateToLocalLanguage](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partytextchatoptions.md)，就會提供翻譯。如果有多個本機聊天控制項已啟用翻譯，且這些本機聊天控制項已透過 [PartyLocalDevice::CreateChatControl()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md) 指定不同的語言，則可能會有多個翻譯。在這種情況下，應用程式可以將 `translations` 中每個 PartyTranslation 的 `languageCode` 欄位，與 `receiverChatControls` 中每個本機聊天控制項透過 [PartyLocalChatControl::GetLanguage()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md) 取得的語言代碼進行比較，以判斷每個翻譯的目標本機聊天控制項。

**`translations`**   [PartyTranslation](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partytranslation.md)\*\
*大小為 `translationCount` 的陣列*

包含聊天文字字串翻譯的陣列。

如果先前已在此裝置的本機聊天控制項上透過 [PartyLocalChatControl::SetTextChatOptions()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions.md) 指定了 [PartyTextChatOptions::TranslateToLocalLanguage](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partytextchatoptions.md)，就會提供翻譯。如果有多個本機聊天控制項已啟用翻譯，且這些本機聊天控制項已透過 [PartyLocalDevice::CreateChatControl()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md) 指定不同的語言，則可能會有多個翻譯。在這種情況下，應用程式可以將 `translations` 中每個 PartyTranslation 的 `languageCode` 欄位，與 `receiverChatControls` 中每個本機聊天控制項透過 [PartyLocalChatControl::GetLanguage()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md) 取得的語言代碼進行比較，以判斷每個翻譯的目標本機聊天控制項。

**`options`**   [PartyChatTextReceivedOptions](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partychattextreceivedoptions.md)

描述聊天文字其他資訊的旗標。

**`originalChatText`**   [PartyString](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/typedefs.md)

傳入文字聊天的原始版本。

此欄位一律是遠端使用者傳送的未篩選來源文字。如果未啟用篩選，它就是指向 `chatText` 的指標。如果已啟用篩選但不需要篩選 (如 `options` 欄位中的 PartyChatTextReceivedOptions::None 所示)，則這是指向 `chatText` 的指標。

**`errorDetail`**   PartyError

診斷值，提供有關任何潛在錯誤狀況的其他疑難排解資訊。

此錯誤僅供診斷用途。如果發生錯誤，`options` 欄位中會出現 [PartyChatTextReceivedOptions::FilteredDueToError](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partychattextreceivedoptions.md) 旗標。

## 需求

**標頭：** Party.h

## 另請參閱

[Party 成員](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/party_members.md)\
[PartyLocalDevice::CreateChatControl](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md)\
[PartyLocalChatControl::SendText](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_sendtext.md)\
[PartyLocalChatControl::SetTextChatOptions](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions.md)


## Related topics

- [PartyChatTextReceivedOptions](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partychattextreceivedoptions.md)
- [PartyTextChatOptions](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partytextchatoptions.md)
- [PartyLocalChatControl::SendText](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_sendtext.md)
- [使用文字內容審核](https://docs.xbox.com/zh-TW/services/playfab/community/voice-communications/concepts-text-moderation.md)
- [PlayFab Party 版本資訊](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/release-notes.md)