ウェブ音声 API

ウェブ音声 API のコンセプトと使用法

ウェブ音声 API は、ウェブアプリが音声データを扱えるようにします。 この API には 2 つの構成要素があります。

• 音声認識は SpeechRecognition インターフェイス経由でアクセスされます。これは、音声入力（通常は端末の既定の音声認識サービス）から音声の文脈を認識し、適切に応答する機能を提供します。 通常は、インターフェイスのコンストラクターを使用して新しい SpeechRecognition オブジェクトを生成します。このオブジェクトは、端末のマイクを通して入力された音声を検知するための、いくつものイベントハンドラーを持ちます。 SpeechGrammar インターフェイスは、あなたのアプリが認識すべき特定の文法群のコンテナーを表します。 文法は、 JSpeech Grammar Format (JSGF) を使用して定義されています。
• 音声合成は、 SpeechSynthesis インターフェイス経由でアクセスされます。これは、プログラムに、そのテキストコンテンツを読み上げる機能を提供します（通常は端末の既定の音声合成を経由）。異なる種類の音声は、 SpeechSynthesisVoice オブジェクトで表され、発話してほしいテキストの様々な部分は、 SpeechSynthesisUtterance オブジェクトで表されます。これらを SpeechSynthesis.speak() メソッドに渡すことによって発話されます。

これらの機能の使い方についての詳細は、ウェブ音声 API の使用 を参照してください。

ウェブ音声 API インターフェイス

音声認識

認識サービスのコントローラーインターフェイスです。認識サービスから送信された SpeechRecognitionEvent も扱います。

音声認識サービスにより認識されている単語を表します。

認識サービスからのエラーメッセージを表します。

result イベントおよび nomatch イベントのためのイベントオブジェクトです。暫定あるいは最終の音声認識結果に関連付けられたすべてのデータを含みます。

認識サービスに認識してほしい言葉または言葉のパターンです。

SpeechGrammar オブジェクトのリストを表します。

一致した一つの認識結果を表します。これには、複数の SpeechRecognitionAlternative オブジェクトが含まれることがあります。

SpeechRecognitionResult オブジェクトのリストを表します。または、continuous モードで結果が捕捉された場合は、一つだけになります。

音声合成

音声サービスのコントローラーインターフェイスです。これは、デバイスで利用可能な合成音声についての情報を取得したり、発話の開始や一時停止などのコマンドを実行するために使用されます。

音声サービスで SpeechSynthesisUtterance オブジェクトの処理中に発生したあらゆるエラーについての情報を含みます。

音声サービスで処理されている SpeechSynthesisUtterance オブジェクトの現在の状態についての情報を含みます。

音声リクエストを表します。 これは、音声サービスが読み上げるコンテンツとその読み上げ方 (言語、音声の高低、音量など) についての情報を含みます。

システムが対応する音声を表します。 すべての SpeechSynthesisVoice は、それ自身に関連する音声サービス (言語、名前、URI についての情報を含む) を持ちます。

SpeechSynthesisGetter と呼ばれる [NoInterfaceObject] インターフェイスの一部として定義され、 Window オブジェクトによって実装されたことで、 speechSynthesis プロパティは SpeechSynthesis コントローラーへのアクセスを提供します。したがって、音声合成機能へのエントリーポイントになります。

エラー

音声 API が報告するエラー（例: "language-not-supported" や "language-unavailable"） の情報については、以下の文書を参照してください。

• SpeechRecognitionErrorEvent オブジェクトの error プロパティ
• SpeechSynthesisErrorEvent の error プロパティ

例

Github 上のウェブ音声 API リポジトリー には、音声合成や音声認識を説明するデモが含まれています。

仕様書

ブラウザーの互換性

api.SpeechRecognition

Enable JavaScript to view this browser compatibility table.

api.SpeechSynthesis

Enable JavaScript to view this browser compatibility table.

関連情報

• ウェブ音声 API の使用
• SitePoint の記事
• HTML5Rocks の記事