次の方法で共有

IAgentCharacterEx::SetSRModeID

  • [アーティクル]

[Microsoft エージェントは Windows 7 の時点で非推奨となり、以降のバージョンの Windows では使用できない場合があります。]

HRESULT SetSRModeID(
   BSTR bszModeID  // speech recognition engine ID
);

文字に設定された音声認識エンジンのモード ID を設定します。

  • 操作が成功したことを示すS_OKを返します。

bszModeID

文字の音声認識エンジンのモード ID 設定。

この設定では、文字の音声入力のエンジンを設定します。 音声認識エンジンのモード ID は、エンジンのモードを一意に識別する (中かっことダッシュで書式設定された) 音声ベンダーによって定義された GUID です。 詳細については、 Microsoft Speech SDK のドキュメントを参照してください。

文字の言語設定と一致しないモード ID を指定した場合、ユーザーが (Microsoft Agent プロパティ シートで) 音声認識を無効にしている場合、またはエンジンがインストールされていない場合、この呼び出しは失敗します。 文字に音声認識エンジン モード ID を設定しない場合、サーバーは文字の言語設定に一致する ID を設定します (Microsoft Speech API インターフェイスを使用)。

エージェント プロパティ シートで音声入力が有効になっている場合 (高度な文字オプション)、このプロパティを設定すると、関連付けられているエンジン (まだ読み込まれていない場合) が読み込まれ、音声サービスが開始されます。 つまり、Listening キーを使用でき、Listening Tip が表示されます。 (リッスン キーとリッスン ヒントは、高度な文字オプションでも有効になっている場合にのみ有効になります)。ただし、speech が無効になっているときに プロパティに対してクエリを実行した場合、サーバーは音声サービスを開始しません。

このプロパティは、文字のクライアントにのみ適用されます。この設定には、その文字の他のクライアントまたはクライアントの他の文字の設定は反映されません。

Microsoft エージェントの音声エンジンの要件は、Microsoft Speech API に基づいています。 Microsoft エージェントの SAPI 要件をサポートするエンジンは、エージェントと共にインストールして使用できます。

参照

IAgentCharacterEx::GetSRModeID