構文
パラメーター
type PartySynthesizeTextToSpeechType
指定されたプロファイルを使用するテキスト読み上げ操作の種類。
profileIdentifier PartyString
指定された種類のテキスト読み上げ操作が使用するプロファイルの識別子。
asyncIdentifier void*オプション 完了状態の変化をこの呼び出しに関連付けるために使用できる、オプションでアプリ定義のポインター サイズのコンテキスト値。
戻り値
PartyError テキスト読み上げプロファイルを設定する非同期操作が開始された場合はc_partyErrorSuccess、それ以外の場合はエラー コード。このメソッドが失敗した場合、関連する状態変化は生成されません。エラー コードの人間が読める形式は、PartyManager::GetErrorMessage() で取得できます。
解説
提供されたプロファイルは、type に同じ値を指定する後続のすべての SynthesizeTextToSpeech() の呼び出しに使用されます。SetTextToSpeechProfile() が少なくとも 1 回呼び出されるまでプロファイルは構成されません。したがって、このメソッドは、SynthesizeTextToSpeech() の呼び出しが成功する前に少なくとも 1 回呼び出す必要があります。このメソッドはプロファイル選択を示すためにプロファイル識別子を受け取るため、タイトルは PartyTextToSpeechProfile::GetIdentifier() の結果を渡すか、前の Party ライブラリ セッションからキャッシュされたプロファイル識別子を提供することができます。
複数の SetTextToSpeechProfile() 操作を開始でき、それらは非同期にキューに追加されます。各操作は順番に処理および完了されます。
これは非同期操作です。完了時に PartySetTextToSpeechProfileCompletedStateChange が PartyManager::StartProcessingStateChanges() を介して提供されます。
テキスト読み上げ合成機能は内部で、利用可能なリージョンと待機時間測定の推定値を使用してサービスの使用を最適化します。PartyOption::RegionUpdateConfiguration オプションを使用して PartyRegionUpdateMode::Deferred の更新モードを構成した場合、利用可能なリージョンの集合の取得およびそれらへの接続品質の測定がまだ開始されていない可能性があり、または最後の更新が構成された更新間隔の有効期間を超えている可能性があります。ローカル デバイスが現在ネットワークに接続中でも接続もされていない場合、SetTextToSpeechProfile() は、この呼び出しの PartySetTextToSpeechProfileCompletedStateChange 完了の前に、遅延されたリージョン更新が確実に開始され、関連する PartyRegionsChangedStateChange が提供されるようにします。
要件
ヘッダー: Party.h関連項目
PartyLocalChatControlPartyLocalChatControl::GetTextToSpeechProfile