From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../ja/web/api/speechrecognitionresult/index.html | 101 +++++++++++++++++++++ .../api/speechrecognitionresult/isfinal/index.html | 90 ++++++++++++++++++ 2 files changed, 191 insertions(+) create mode 100644 files/ja/web/api/speechrecognitionresult/index.html create mode 100644 files/ja/web/api/speechrecognitionresult/isfinal/index.html (limited to 'files/ja/web/api/speechrecognitionresult') diff --git a/files/ja/web/api/speechrecognitionresult/index.html b/files/ja/web/api/speechrecognitionresult/index.html new file mode 100644 index 0000000000..a4af82efaa --- /dev/null +++ b/files/ja/web/api/speechrecognitionresult/index.html @@ -0,0 +1,101 @@ +--- +title: SpeechRecognitionResult +slug: Web/API/SpeechRecognitionResult +tags: + - API + - Experimental + - Interface + - NeedsTranslation + - Reference + - SpeechRecognitionResult + - TopicStub + - Web Speech API + - recognition + - speech +translation_of: Web/API/SpeechRecognitionResult +--- +

{{APIRef("Web Speech API")}}{{SeeCompatTable}}

+ +

The SpeechRecognitionResult interface of the Web Speech API represents a single recognition match, which may contain multiple {{domxref("SpeechRecognitionAlternative")}} objects.

+ +

Properties

+ +
+
{{domxref("SpeechRecognitionResult.isFinal")}} {{readonlyinline}}
+
A {{domxref("Boolean")}} that states whether this result is final (true) or not (false) — if so, then this is the final time this result will be returned; if not, then this result is an interim result, and may be updated later on.
+
{{domxref("SpeechRecognitionResult.length")}} {{readonlyinline}}
+
Returns the length of the "array" — the number of {{domxref("SpeechRecognitionAlternative")}} objects contained in the result (also referred to as "n-best alternatives".)
+
+ +

Methods

+ +
+
{{domxref("SpeechRecognitionResult.item")}}
+
A standard getter that allows {{domxref("SpeechRecognitionAlternative")}} objects within the result to be accessed via array syntax.
+
+ +

Examples

+ +

This code is excerpted from our Speech color changer example.

+ +
recognition.onresult = function(event) {
+  // The SpeechRecognitionEvent results property returns a SpeechRecognitionResultList object
+  // The SpeechRecognitionResultList object contains SpeechRecognitionResult objects.
+  // It has a getter so it can be accessed like an array
+  // The first [0] returns the SpeechRecognitionResult at position 0.
+  // Each SpeechRecognitionResult object contains SpeechRecognitionAlternative objects that contain individual results.
+  // These also have getters so they can be accessed like arrays.
+  // The second [0] returns the SpeechRecognitionAlternative at position 0.
+  // We then return the transcript property of the SpeechRecognitionAlternative object
+  var color = event.results[0][0].transcript;
+  diagnostic.textContent = 'Result received: ' + color + '.';
+  bg.style.backgroundColor = color;
+}
+ +

Specifications

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('Web Speech API', '#speechreco-result', 'SpeechRecognitionResult')}}{{Spec2('Web Speech API')}} 
+ +

Browser compatibility

+ +
+ + +

{{Compat("api.SpeechRecognitionResult")}}

+
+ +

Firefox OS permissions

+ +

To use speech recognition in an app, you need to specify the following permissions in your manifest:

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

You also need a privileged app, so you need to include this as well:

+ +
  "type": "privileged"
+ +

See also

+ + diff --git a/files/ja/web/api/speechrecognitionresult/isfinal/index.html b/files/ja/web/api/speechrecognitionresult/isfinal/index.html new file mode 100644 index 0000000000..b32f703a04 --- /dev/null +++ b/files/ja/web/api/speechrecognitionresult/isfinal/index.html @@ -0,0 +1,90 @@ +--- +title: SpeechRecognitionResult.isFinal +slug: Web/API/SpeechRecognitionResult/isFinal +tags: + - API + - Experimental + - Property + - Reference + - SpeechRecognitionResult + - Web Speech API + - isFinal + - recognition + - speech +translation_of: Web/API/SpeechRecognitionResult/isFinal +--- +

{{APIRef("Web Speech API")}}{{ SeeCompatTable() }}

+ +

{{domxref("SpeechRecognitionResult")}}インターフェイスの isFinal リードオンリーのプロパティは結果がファイナルかどうかの ({{domxref("Boolean")}} 型) のことです。true の場合は、これは結果を返す最終の時間です。false の場合は、暫定の結果を返し、後々それは更新されます。

+ +

構文

+ +
var myIsFinal = speechRecognitionResultInstance.isFinal;
+ +

返り値

+ +

A {{domxref("Boolean")}}.

+ +

例

+ +
recognition.onresult = function(event) {
+  // The SpeechRecognitionEvent results property returns a SpeechRecognitionResultList object
+  // The SpeechRecognitionResultList object contains SpeechRecognitionResult objects.
+  // It has a getter so it can be accessed like an array
+  // The first [0] returns the SpeechRecognitionResult at position 0.
+  // Each SpeechRecognitionResult object contains SpeechRecognitionAlternative objects that contain individual results.
+  // These also have getters so they can be accessed like arrays.
+  // The second [0] returns the SpeechRecognitionAlternative at position 0.
+  // We then return the transcript property of the SpeechRecognitionAlternative object
+  var color = event.results[0][0].transcript;
+  diagnostic.textContent = 'Result received: ' + color + '.';
+  bg.style.backgroundColor = color;
+
+  console.log(event.results[0].isFinal);
+}
+ +

仕様

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

ブラウザー実装状況

+ + + +

{{Compat("api.SpeechRecognitionResult.isFinal")}}

+ +

Firefox OS 権限

+ +

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

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

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

+ +
  "type": "privileged"
+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf