IAgentCharacterEx::GetSRStatus
[Microsoft Agent は Windows 7 の時点で非推奨となり、後続のバージョンの Windows では使用できない可能性があります。]
HRESULT GetSRStatus(
long * plStatus // address of the speech input status
);
音声入力をサポートするために必要な条件の状態を取得します。
- 操作が成功したことを示す S_OK を返します。
-
plStatus
-
状態設定に対して次のいずれかの値を受け取る変数のアドレス。
値 説明 const unsigned longLISTEN_STATUS_CANLISTEN = 0; 条件は音声入力をサポートしています。 const unsigned longLISTEN_STATUS_NOAUDIO = 1; このシステムではオーディオ入力デバイスを使用できません。 (マイクがインストールされているかどうかは検出されません。ユーザーが入力対応サウンド カードと対応ドライバーを正しくインストールしたかどうかを検出することしかできません)。 const unsigned longLISTEN_STATUS_NOTTOPMOST = 2; 別のクライアントがこのキャラクターのアクティブなクライアントであるか、現在のキャラクターが最上位ではありません。 const unsigned longLISTEN_STATUS_CANTOPENAUDIO = 3; オーディオ入力または出力チャネルは現在ビジー状態であり、他のアプリケーションでオーディオが使用されています。 const unsigned longLISTEN_STATUS_COULDNTINITIALIZESPEECH = 4; 音声認識サブシステムの初期化中に、指定されていないエラーが発生しました。 これには、キャラクターの言語設定に一致する音声エンジンが使用できない可能性が含まれます。 const unsigned longLISTEN_STATUS_SPEECHDISABLED = 5; ユーザーが [高度なキャラクター オプション] ウィンドウで音声入力を無効にしました。 const unsigned longLISTEN_STATUS_ERROR = 6; オーディオ ステータスを確認中にエラーが発生しましたが、エラーの原因がシステムによって返されませんでした。
この関数を使用すると、オーディオ デバイスのステータスを含め、現在の条件が音声認識入力をサポートしているかどうかを照会できます。 アプリケーションで IAgentCharacterEx::Listen メソッドを使用している場合は、この関数を使用して呼び出しの成功率を高めることができます。 このメソッドを呼び出すと、まだ読み込まれていない音声エンジンも読み込まれます。 ただし、リスニング モードはオンになりません。
エージェント プロパティ シートで音声入力が有効になっている場合 (高度なキャラクター オプション)、ステータスのクエリを実行すると、関連付けられているエンジンが読み込まれ (まだ読み込まれていない場合)、音声サービスが開始されます。 つまり、リスニング キーを使用でき、リスニング ヒントが表示されます。 (リスニング キーとリスニング ヒントは、[高度なキャラクター オプション] でも有効になっている場合にのみ有効になります)。ただし、音声が無効になっているときにプロパティに対してクエリを実行した場合、サーバーは音声サービスを開始しません。
この関数は、クライアント アプリケーションがキャラクターを使用するための設定のみを返します。この設定には、キャラクターの他のクライアントまたはクライアント アプリケーションの他のキャラクターは反映されません。