From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../web/api/speechrecognitionresult/index.html | 152 +++++++++++++++++++++ .../api/speechrecognitionresult/isfinal/index.html | 139 +++++++++++++++++++ 2 files changed, 291 insertions(+) create mode 100644 files/zh-cn/web/api/speechrecognitionresult/index.html create mode 100644 files/zh-cn/web/api/speechrecognitionresult/isfinal/index.html (limited to 'files/zh-cn/web/api/speechrecognitionresult') diff --git a/files/zh-cn/web/api/speechrecognitionresult/index.html b/files/zh-cn/web/api/speechrecognitionresult/index.html new file mode 100644 index 0000000000..c22e5d7da0 --- /dev/null +++ b/files/zh-cn/web/api/speechrecognitionresult/index.html @@ -0,0 +1,152 @@ +--- +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

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Basic support{{CompatChrome(33)}} [1]{{CompatGeckoDesktop(44)}} [2]{{CompatNo}}{{CompatNo}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChromeFirefox Mobile (Gecko)Firefox OSIE PhoneOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatVersionUnknown}}[1]{{CompatUnknown}}2.5{{CompatNo}}{{CompatNo}}{{CompatNo}}
+
+ + + +

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/zh-cn/web/api/speechrecognitionresult/isfinal/index.html b/files/zh-cn/web/api/speechrecognitionresult/isfinal/index.html new file mode 100644 index 0000000000..1b1a46a1d7 --- /dev/null +++ b/files/zh-cn/web/api/speechrecognitionresult/isfinal/index.html @@ -0,0 +1,139 @@ +--- +title: SpeechRecognitionResult.isFinal +slug: Web/API/SpeechRecognitionResult/isFinal +tags: + - API + - Web Speech API + - isFinal + - 语音 + - 语音识别 +translation_of: Web/API/SpeechRecognitionResult/isFinal +--- +

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

+ +

{{domxref("SpeechRecognitionResult")}} 接口的isFinal只读属性是一个布尔值, 如果值是true, 则表示这是最后一次返回的结果 (语音识别结束)。如果为false, 表示识别尚未结束, 这只是一个临时的数据, 有可能会在稍后更新。

+ +

语法

+ +
var myIsFinal = speechRecognitionResultInstance.isFinal;
+ +

返回值

+ +

{{domxref("Boolean")}} 

+ +

示例

+ +
recognition.onresult = function(event) {
+  // The SpeechRecognitionEvent results property returns a SpeechRecognitionResultList object
+  // SpeechRecognitionResultList 对象包含 SpeechRecognitionResult 对象.
+  // 它有一个getter，所以它可以像数组一样被访问
+  // 第一个[0]返回 SpeechRecognitionResult 的第0个下标.
+  // Each SpeechRecognitionResult object contains SpeechRecognitionAlternative objects that contain individual results.
+  // 这些也有getter，因此可以像数组一样访问它们。
+  // 第二个[0]返回 SpeechRecognitionAlternative 所在的第0个下标。
+  // 然后我们返回的记录属性 SpeechRecognitionAlternative 对象
+  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')}} 
+ +

浏览器兼容性

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Basic support{{CompatChrome(33)}} [1]{{CompatGeckoDesktop(44)}} [2]{{CompatNo}}{{CompatNo}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChromeFirefox Mobile (Gecko)Firefox OSIE PhoneOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatVersionUnknown}}[1]{{CompatUnknown}}2.5{{CompatNo}}{{CompatNo}}{{CompatNo}}
+
+ + + +

Firefox OS 权限

+ +

要在应用程序中使用语音识别，您需要在您的清单中指定以下权限:

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

你还需要一个有特权的应用程序，所以你也需要把它包含在内:

+ +
  "type": "privileged"
+ +

相关链接

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