> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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](/services/playfab/multiplayer/networking/reference/classes/PartyChatControl/partychatcontrol)\*

テキスト メッセージの送信元であるチャット コントロール オブジェクト。

**`receiverChatControlCount`**   uint32\_t

テキスト メッセージのあて先となるローカル受信側チャット コントロールの数。

**`receiverChatControls`**   [PartyLocalChatControlArray](/services/playfab/multiplayer/networking/reference/typedefs)\
*サイズ `receiverChatControlCount` の配列*

テキスト メッセージのあて先となるローカル受信側チャット コントロール。

**`languageCode`**   [PartyString](/services/playfab/multiplayer/networking/reference/typedefs)

チャット テキストの言語。

言語は、ローカル言語への翻訳が有効な場合にのみ提供されます。翻訳が有効でない場合、または翻訳中にエラーが発生した場合、言語コードは空の文字列になります。<br /><br /> 言語コードは、英語 (米国) の場合 en-US のような BCP 47 形式です。サポートされている言語コードは [言語のサポート](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/language-support) に列挙されています。

**`chatText`**   [PartyString](/services/playfab/multiplayer/networking/reference/typedefs)

受信したチャット テキスト。

文字列は、null 終端文字を含めずに最大 `c_maxChatTextMessageLength` 文字の長さになる場合があります。<br /><br /> フィルタリングが有効な場合、このテキストはリモート ユーザーが送信した正確なテキストとは異なる場合があります。正確な送信元テキストは `originalChatText` フィールドから取得できます。

**`dataSize`**   uint32\_t

このテキスト メッセージに関連付けられたデータのサイズ。

**`data`**   const void\*\
*サイズ `dataSize` バイトのバッファー*

このテキスト メッセージに関連付けられたデータ。

**`translationCount`**   uint32\_t

チャット テキストに関連付けられた翻訳の数。

このデバイスでローカルのチャット コントロールに対して [PartyLocalChatControl::SetTextChatOptions()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions) を通じて [PartyTextChatOptions::TranslateToLocalLanguage](/services/playfab/multiplayer/networking/reference/enums/partytextchatoptions) が既に指定されている場合、翻訳が提供されます。複数のローカル チャット コントロールで翻訳が有効になっており、ローカル チャット コントロールが [PartyLocalDevice::CreateChatControl()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol) を通じて異なる言語を指定している場合、複数の翻訳が存在する可能性があります。その場合、アプリは `translations` 内の各 PartyTranslation の `languageCode` フィールドを、`receiverChatControls` 内の各ローカル チャット コントロールについて [PartyLocalChatControl::GetLanguage()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage) 経由で取得した言語コードと比較して、各翻訳の対象となるローカル チャット コントロールを特定できます。

**`translations`**   [PartyTranslation](/services/playfab/multiplayer/networking/reference/structs/partytranslation)\*\
*サイズ `translationCount` の配列*

チャット テキスト文字列の翻訳を含む配列。

このデバイスでローカルのチャット コントロールに対して [PartyLocalChatControl::SetTextChatOptions()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions) を通じて [PartyTextChatOptions::TranslateToLocalLanguage](/services/playfab/multiplayer/networking/reference/enums/partytextchatoptions) が既に指定されている場合、翻訳が提供されます。複数のローカル チャット コントロールで翻訳が有効になっており、ローカル チャット コントロールが [PartyLocalDevice::CreateChatControl()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol) を通じて異なる言語を指定している場合、複数の翻訳が存在する可能性があります。その場合、アプリは `translations` 内の各 PartyTranslation の `languageCode` フィールドを、`receiverChatControls` 内の各ローカル チャット コントロールについて [PartyLocalChatControl::GetLanguage()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage) 経由で取得した言語コードと比較して、各翻訳の対象となるローカル チャット コントロールを特定できます。

**`options`**   [PartyChatTextReceivedOptions](/services/playfab/multiplayer/networking/reference/enums/partychattextreceivedoptions)

チャット テキストに関する追加情報を説明するフラグ。

**`originalChatText`**   [PartyString](/services/playfab/multiplayer/networking/reference/typedefs)

受信テキスト チャットの元のバージョン。

このフィールドは常に、リモート ユーザーが送信したフィルター処理されていないソース テキストです。フィルタリングが有効でない場合、これは `chatText` へのポインターです。フィルタリングが有効であるが、`options` フィールドに PartyChatTextReceivedOptions::None が示すようにフィルタリングが不要だった場合、これは `chatText` へのポインターです。

**`errorDetail`**   PartyError

発生する可能性のあるエラー状態に関する追加のトラブルシューティング情報を提供する診断値。

このエラーは診断のみを目的としています。エラーが発生した場合、`options` フィールドに [PartyChatTextReceivedOptions::FilteredDueToError](/services/playfab/multiplayer/networking/reference/enums/partychattextreceivedoptions) フラグが存在します。

## 要件

**ヘッダー:** Party.h

## 関連項目

[Party メンバー](/services/playfab/multiplayer/networking/reference/party_members)\
[PartyLocalDevice::CreateChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol)\
[PartyLocalChatControl::SendText](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_sendtext)\
[PartyLocalChatControl::SetTextChatOptions](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions)


## Related topics

- [PartyChatTextReceivedOptions](/ja-jp/services/playfab/multiplayer/networking/reference/enums/partychattextreceivedoptions.md)
- [PartyTextChatOptions](/ja-jp/services/playfab/multiplayer/networking/reference/enums/partytextchatoptions.md)
- [PartyLocalChatControl::SendText](/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_sendtext.md)
- [PlayFab Party リリース ノート](/ja-jp/services/playfab/multiplayer/networking/release-notes.md)
- [テキスト モデレーションの使用](/ja-jp/services/playfab/community/voice-communications/concepts-text-moderation.md)