SpeechSynthesisUtterance: start イベント
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2018年9月以降、すべてのブラウザーで利用可能です。
start は ウェブ音声 API の SpeechSynthesisUtterance オブジェクトのイベントで、発話が始まったときに発行されます。
構文
このイベント名を addEventListener() などのメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。
js
addEventListener("start", (event) => {});
onstart = (event) => {};
イベント型
SpeechSynthesisEvent です。 Event を継承しています。
イベントプロパティ
以下に挙げたプロパティに加え、親インターフェイスである Event のプロパティが利用可能です。
charIndex読取専用-
イベントが発生したときに発話されていた
SpeechSynthesisUtterance.text内の文字のインデックス位置を返します。 elapsedTime読取専用-
イベントが発生した時点の
SpeechSynthesisUtterance.textが話し始めてからの経過時間(秒)を返します。 name読取専用-
SpeechSynthesisUtterance.textが発話される際に発生する特定の種類のイベントに関連する名前を返します。markイベントの場合は到達した SSML マーカーの名前、boundaryイベントの場合は到達した境界の種類です。 utterance読取専用-
イベントが発生した
SpeechSynthesisUtteranceインスタンスを返します。
例
start イベントを addEventListener メソッドで使用することができます。
js
utterThis.addEventListener("start", (event) => {
console.log(`We have started uttering this speech: ${event.utterance.text}`);
});
または onstart イベントハンドラープロパティで使用することができます。
js
utterThis.onstart = (event) => {
console.log(`We have started uttering this speech: ${event.utterance.text}`);
};
仕様書
| 仕様書 |
|---|
| Web Speech API> # eventdef-speechsynthesisutterance-start> |
| Web Speech API> # dom-speechsynthesisutterance-onstart> |