--- title: SpeechRecognition.interimResults slug: Web/API/SpeechRecognition/interimResults tags: - API - Experimental - Property - Reference - SpeechRecognition - Web Speech API - recognition - speech translation_of: Web/API/SpeechRecognition/interimResults ---
{{APIRef("Web Speech API")}}{{SeeCompatTable}}

{{domxref("SpeechRecognition")}} インターフェイスの interimResults プロパティは interim の結果を返す (true) か返さない (false) か制御します。Interim の結果は最終的ではない結果になります (例えば {{domxref("SpeechRecognitionResult.isFinal")}} プロパティは false となる)。

interimResults のデフォルト値は false です。

構文

var myInterimResult = mySpeechRecognition.interimResults;
mySpeechRecognition.interimResults = false;

現在の SpeechRecognition の interim の結果を表す {{domxref("Boolean")}}。true の場合は interim の結果を返すことができ、false の場合は返すことができません。

下記のソースコードは Speech color changer を参考しています

var grammar = '#JSGF V1.0; grammar colors; public <color> = aqua | azure | beige | bisque | black | blue | brown | chocolate | coral | crimson | cyan | fuchsia | ghostwhite | gold | goldenrod | gray | green | indigo | ivory | khaki | lavender | lime | linen | magenta | maroon | moccasin | navy | olive | orange | orchid | peru | pink | plum | purple | red | salmon | sienna | silver | snow | tan | teal | thistle | tomato | turquoise | violet | white | yellow ;'
var recognition = new SpeechRecognition();
var speechRecognitionList = new SpeechGrammarList();
speechRecognitionList.addFromString(grammar, 1);
recognition.grammars = speechRecognitionList;
//recognition.continuous = false;
recognition.lang = 'ja';
recognition.interimResults = false;
recognition.maxAlternatives = 1;

...

仕様

仕様 状態 コメント
{{SpecName('Web Speech API', '#dfn-interimresults', 'interimResults')}} {{Spec2('Web Speech API')}}

ブラウザー実装状況

{{Compat("api.SpeechRecognition.interimResults")}}

Firefox OS の権限

アプリで音声認識を利用する前に、下記の権限を manifest に追加する必要があります。

"permissions": {
  "audio-capture" : {
    "description" : "Audio capture"
  },
  "speech-recognition" : {
    "description" : "Speech recognition"
  }
}

privileged アプリ権限も必要なので、下記も追加が必要です。

  "type": "privileged"

県連情報