PartyVoiceChatTranscriptionReceivedStateChange

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

Syntax

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 文字起こし操作が成功したかどうかを示します。または失敗の理由を提供します。成功時、transcription フィールドはゼロ以外の長さの文字列です。失敗時、文字列は空です。失敗は、話者に対して文字起こし操作が試みられたものの完了できなかったことを示します。チャットコントロールに関連付けられたユーザーの要求で文字起こしが有効化されていて、文字起こしメッセージが UI 経由で表示されている場合、文字起こしが保留中か失敗したかについてのフィードバックを提供するために、失敗もユーザーに示すことをお勧めします。 errorDetail PartyError 潜在的なエラー状態に関する追加のトラブルシューティング情報を提供する診断値です。このエラーの詳細を人間が読める形式で取得するには、PartyManager::GetErrorMessage() を使用します。 senderChatControl PartyChatControl* 文字起こしメッセージを発信したチャットコントロールオブジェクトです。 receiverChatControlCount uint32_t 文字起こしの宛先であるローカル受信側チャットコントロールの数です。 receiverChatControls PartyLocalChatControlArray
receiverChatControlCount サイズの配列 文字起こしの宛先であるローカル受信側チャットコントロールです。 sourceType PartyAudioSourceType この文字起こしが表すオーディオソースのタイプです。オーディオソースタイプは、異なるソースタイプからの文字起こしを異なる方法で扱う必要があるゲームシナリオでオプションで使用できます。たとえば、文字起こしがマイクまたはテキスト読み上げオーディオに関連付けられているかどうかに応じて、異なるアイコンを表示することができます。 languageCode PartyString 文字起こしの言語コードです。言語コードは、result フィールドが成功を示す場合に常に提供されます。それ以外の場合、言語コードは空の文字列です。

言語コードは BCP 47 形式です (例: 英語 (米国) の場合は en-US)。サポートされる言語コードは Language support に列挙されています。 transcription PartyString 文字起こしされた音声チャットテキストです。文字列は null 終端文字を除いて最大 c_maxChatTextMessageLength 文字の長さになります。result フィールドが失敗を示す場合、文字列は常に空です。 type PartyVoiceChatTranscriptionPhraseType transcription フィールドで提供されるテキストのフレーズタイプを示します。 result フィールドが失敗を示す場合、タイプは常に PartyVoiceChatTranscriptionPhraseType::Final です。 translationCount uint32_t 文字起こしされた音声チャットテキストに関連付けられた翻訳の数です。このデバイスにローカルなチャットコントロールで PartyLocalChatControl::SetTranscriptionOptions() を介して以前に PartyVoiceChatTranscriptionOptions::TranslateToLocalLanguage が指定された場合、翻訳が提供されます。複数のローカルチャットコントロールで翻訳が有効化されていて、ローカルチャットコントロールが PartyLocalDevice::CreateChatControl() を介して異なる言語を指定している場合、複数の翻訳が存在する可能性があります。その場合、アプリは translations 内の各 PartyTranslation の languageCode フィールドを、receiverChatControls 内の各ローカルチャットコントロールについて PartyLocalChatControl::GetLanguage() を介して取得した言語コードと比較し、各翻訳の対象ローカルチャットコントロールを判別できます。 translations PartyTranslation*
translationCount サイズの配列 音声チャット文字起こし文字列の翻訳を含む配列です。このデバイスにローカルなチャットコントロールで PartyLocalChatControl::SetTranscriptionOptions() を介して以前に PartyVoiceChatTranscriptionOptions::TranslateToLocalLanguage が指定された場合、翻訳が提供されます。複数のローカルチャットコントロールで翻訳が有効化されていて、ローカルチャットコントロールが PartyLocalDevice::CreateChatControl() を介して異なる言語を指定している場合、複数の翻訳が存在する可能性があります。その場合、アプリは translations 内の各 PartyTranslation の languageCode フィールドを、receiverChatControls 内の各ローカルチャットコントロールについて PartyLocalChatControl::GetLanguage() を介して取得した言語コードと比較し、各翻訳の対象ローカルチャットコントロールを判別できます。

話し手側のチャットコントロールの言語がローカルチャットコントロールの言語と同じであっても、receiverChatControls 内の翻訳が有効化された各チャットコントロールの言語に対応する翻訳が提供されます。そのような場合、文字起こし文字列と翻訳文字列は同一になります。

Requirements

Header: Party.h

XBOX Services

PlayFab

Syntax

Members

Requirements

See also

​Syntax

​Members

​Requirements

​See also

Syntax

Members

Requirements

See also