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

# PartyVoiceChatTranscriptionReceivedStateChange

> *VoiceChatTranscriptionReceived* タイプの状態変更に固有の情報です。

*VoiceChatTranscriptionReceived* タイプの状態変更に固有の情報です。

## Syntax

```cpp theme={null}
struct PartyVoiceChatTranscriptionReceivedStateChange : PartyStateChange {  
    PartyStateChangeResult result;  
    PartyError errorDetail;  
    PartyChatControl* senderChatControl;  
    uint32_t receiverChatControlCount;  
    PartyLocalChatControlArray receiverChatControls;  
    PartyAudioSourceType sourceType;  
    PartyString languageCode;  
    PartyString transcription;  
    PartyVoiceChatTranscriptionPhraseType type;  
    uint32_t translationCount;  
    PartyTranslation* translations;  
}  
```

### Members

**`result`**   [PartyStateChangeResult](/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult)

文字起こし操作が成功したかどうかを示します。または失敗の理由を提供します。

成功時、`transcription` フィールドはゼロ以外の長さの文字列です。失敗時、文字列は空です。失敗は、話者に対して文字起こし操作が試みられたものの完了できなかったことを示します。チャット コントロールに関連付けられたユーザーの要求で文字起こしが有効化されていて、文字起こしメッセージが UI 経由で表示されている場合、文字起こしが保留中か失敗したかについてのフィードバックを提供するために、失敗もユーザーに示すことをお勧めします。

**`errorDetail`**   PartyError

潜在的なエラー状態に関する追加のトラブルシューティング情報を提供する診断値です。

このエラーの詳細を人間が読める形式で取得するには、[PartyManager::GetErrorMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage) を使用します。

**`senderChatControl`**   [PartyChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyChatControl/partychatcontrol)\*

文字起こしメッセージを発信したチャット コントロール オブジェクトです。

**`receiverChatControlCount`**   uint32\_t

文字起こしの宛先であるローカル受信側チャット コントロールの数です。

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

文字起こしの宛先であるローカル受信側チャット コントロールです。

**`sourceType`**   [PartyAudioSourceType](/services/playfab/multiplayer/networking/reference/enums/partyaudiosourcetype)

この文字起こしが表すオーディオ ソースのタイプです。

オーディオ ソース タイプは、異なるソース タイプからの文字起こしを異なる方法で扱う必要があるゲーム シナリオでオプションで使用できます。たとえば、文字起こしがマイクまたはテキスト読み上げオーディオに関連付けられているかどうかに応じて、異なるアイコンを表示することができます。

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

文字起こしの言語コードです。

言語コードは、`result` フィールドが成功を示す場合に常に提供されます。それ以外の場合、言語コードは空の文字列です。 <br /><br /> 言語コードは BCP 47 形式です (例: 英語 (米国) の場合は en-US)。サポートされる言語コードは [Language support](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/language-support) に列挙されています。

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

文字起こしされた音声チャット テキストです。

文字列は null 終端文字を除いて最大 `c_maxChatTextMessageLength` 文字の長さになります。`result` フィールドが失敗を示す場合、文字列は常に空です。

**`type`**   [PartyVoiceChatTranscriptionPhraseType](/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionphrasetype)

`transcription` フィールドで提供されるテキストのフレーズ タイプを示します。

`result` フィールドが失敗を示す場合、タイプは常に [PartyVoiceChatTranscriptionPhraseType::Final](/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionphrasetype) です。

**`translationCount`**   uint32\_t

文字起こしされた音声チャット テキストに関連付けられた翻訳の数です。

このデバイスにローカルなチャット コントロールで [PartyLocalChatControl::SetTranscriptionOptions()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions) を介して以前に [PartyVoiceChatTranscriptionOptions::TranslateToLocalLanguage](/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions) が指定された場合、翻訳が提供されます。複数のローカル チャット コントロールで翻訳が有効化されていて、ローカル チャット コントロールが [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::SetTranscriptionOptions()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions) を介して以前に [PartyVoiceChatTranscriptionOptions::TranslateToLocalLanguage](/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions) が指定された場合、翻訳が提供されます。複数のローカル チャット コントロールで翻訳が有効化されていて、ローカル チャット コントロールが [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) を介して取得した言語コードと比較し、各翻訳の対象ローカル チャット コントロールを判別できます。 <br /><br /> 話し手側のチャット コントロールの言語がローカル チャット コントロールの言語と同じであっても、`receiverChatControls` 内の翻訳が有効化された各チャット コントロールの言語に対応する翻訳が提供されます。そのような場合、文字起こし文字列と翻訳文字列は同一になります。

## Requirements

**Header:** Party.h

## See also

[Party members](/services/playfab/multiplayer/networking/reference/party_members)\
[PartyLocalDevice::CreateChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol)\
[PartyLocalChatControl::SetTranscriptionOptions](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions)


## Related topics

- [PartyVoiceChatTranscriptionOptions](/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md)
- [PartyVoiceChatTranscriptionPhraseType](/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionphrasetype.md)
- [PlayFab Party リリース ノート](/ja-jp/services/playfab/multiplayer/networking/release-notes.md)
- [PartyLocalChatControl::GetTranscriptionOptions](/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_gettranscriptionoptions.md)
- [PartyLocalChatControl::SetTranscriptionOptions](/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)