PartyLocalChatControl::SetTextToSpeechProfile

指定した種類の音声合成 (TTS) 操作に使用するプロファイルを構成します。

構文

PartyError SetTextToSpeechProfile(  
    PartySynthesizeTextToSpeechType type,  
    PartyString profileIdentifier,  
    void* asyncIdentifier  
)  

パラメーター

type PartySynthesizeTextToSpeechType

指定したプロファイルを使用する音声合成 (TTS) 操作の種類。

profileIdentifier PartyString

指定した種類の音声合成 (TTS) 操作で使用するプロファイルの識別子。

asyncIdentifier void*
オプション

完了状態の変更をこの呼び出しに関連付けるために使用できる、オプションの、アプリによって定義されたポインター サイズのコンテキスト値。

戻り値

PartyError

c_partyErrorSuccess テキスト音声変換 (TTS) プロファイルを設定する非同期操作が開始されるか、エラー コードが発生した場合。 このメソッドが失敗した場合、関連する状態の変更は発生しません。 人間が読める形式のエラー コードは、PartyManager::GetErrorMessage() を介して取得できます。

解説

指定されたプロファイルは、type に同じ値を指定する SynthesizeTextToSpeech() に対するすべての後続の呼び出しに使用されます。 SetTextToSpeechProfile() が少なくとも 1 回呼び出されるまで、プロファイルは構成されません。 したがって、このメソッドは、SynthesizeTextToSpeech() の呼び出しが成功する前に少なくとも 1 回呼び出す必要があります。

このメソッドは、タイトルが PartyTextToSpeechProfile::GetIdentifier() の結果を渡すか、以前の Party ライブラリ セッションからキャッシュされたプロファイル識別子を提供できるように、プロファイルの選択を示すプロファイル識別子を受け取ります。

複数の SetTextToSpeechProfile() 操作を開始でき、非同期的にキューに入れられます。 各操作は順番に処理され、完了します。

これは非同期操作です。PartySetTextToSpeechProfileCompletedStateChange は、完了時に PartyManager::StartProcessingStateChanges() を介して提供されます。

テキスト音声変換合成機能は、利用可能な領域と待機時間の推定値を内部的に使用して、サービスの使用を最適化します。 PartyOption::RegionUpdateConfiguration オプションを使用して更新モードを PartyRegionUpdateMode::Deferred で構成した場合、利用可能な領域のセットを取得とそのリージョンに対する接続品質の測定がまだ開始されていないか、最後の更新が構成された更新間隔の経過期間を超えている可能性があります。 ローカル デバイスが現在どのネットワークにも接続されていない場合、SetTextToSpeechProfile() は、この呼び出しの PartySetTextToSpeechProfileCompletedStateChange 完了前に、遅延領域の更新が開始され、関連付けられている PartyRegionsChangedStateChange が提供されていることを保証します。

要件

ヘッダー: Party.h

関連項目

PartyLocalChatControl
PartyLocalChatControl::GetTextToSpeechProfile