構文
パラメーター
options PartyVoiceChatTranscriptionOptions
ローカル チャット コントロール用の文字起こしを生成するチャット コントロールや、それらの文字起こしをローカル チャット コントロールの言語に翻訳するかどうかなど、ボイス チャット文字起こしに関連付けられたオプション。
asyncIdentifier void*オプション 完了状態の変化をこの呼び出しに関連付けるために使用できる、オプションでアプリ定義のポインター サイズのコンテキスト値。
戻り値
PartyError 文字起こしオプションを設定する非同期操作が開始された場合はc_partyErrorSuccess、それ以外の場合はエラー コード。このメソッドが失敗した場合、関連する状態変化は生成されません。エラー コードの人間が読める形式は、PartyManager::GetErrorMessage() で取得できます。
解説
文字起こしとは、ボイス チャットで話されたフレーズを表す文字列を生成するプロセスです。options を介して指定されたオプションは、これらの文字起こし文字列を生成する必要があるチャット コントロールを指定します。これらは続いて PartyVoiceChatTranscriptionReceivedStateChange を介してローカル チャット コントロールに提供されます。PartyLocalDevice::CreateChatControl() を介して文字起こしをサポートする言語を使用するように構成されたチャット コントロールのみが文字起こしを提供します。
音声認識 (speech-to-text) 文字起こし機能は内部で、利用可能なリージョンと待機時間測定の推定値を使用してサービスの使用を最適化します。PartyOption::RegionUpdateConfiguration オプションを使用して PartyRegionUpdateMode::Deferred の更新モードを構成した場合、利用可能なリージョンの集合の取得およびそれらへの接続品質の測定がまだ開始されていない可能性があり、または最後の更新が構成された更新間隔の有効期間を超えている可能性があります。ローカル デバイスが現在ネットワークに接続中でも接続もされていない場合、およびアプリケーションが PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState を含むオプション フラグを指定する場合、SetTranscriptionOptions() は、この呼び出しの PartySetTranscriptionOptionsCompletedStateChange 完了の前に、遅延されたリージョン更新が確実に開始され、関連する PartyRegionsChangedStateChange が提供されるようにします。