Introducing the basic functionality to the speech input experimental API.

chrome/common/extensions/api/extension_api.json

 [
   {
     "namespace": "extension",
     "unprivileged": true,
     "types": [
       {
         "id": "MessageSender",
         "type": "object",
         "description": "An object containing information about the script context that sent a message or request.",
         "properties": {
@@ skipping 530 matching lines @@
             "description": "BCP-47 language code of the language to recognize. When set to 'auto' or not defined defaults to user's most preferred content language. Will use 'en-US' if not supported or invalid."
           },
           "grammar": {
             "type": "string",
             "description": "Name of the grammar to use. Defaults to 'builtin:search'.",
             "optional": true
           },
           "filterProfanities": {
             "type": "boolean",
             "optional": true,
-            "description": "Enable or disable profanity filtering. Will use the default Chrome filtering settings if not provided."
+            "description": "Enable or disable profanity filtering. Will use the default Chrome filtering settings if not set."
           }
         }
       },
       {
         "id": "Error",
         "type": "object",
         "description": "Object describing a speech input error.",
         "properties": {
           "code": {
             "type": "string",
-            "enum": ["noDevicesAvailable", "unableToStart", "noSpeechHeard", "noResults", "captureError", "networkError", "internalError", "requestDenied"],
+            "enum": ["noDevicesAvailable", "unableToStart", "noSpeechHeard", "noResults", "captureError", "networkError", "requestDenied"],
             "description": "Code identifying the error case."
           }
         }
       },
       {
         "id": "ResultHypothesis",
         "type": "object",
         "description": "Object describing a speech recognition hypothesis.",
         "properties": {
           "utterance": {
             "type": "string",
             "description": "Text of this hypothesis."
           },
           "confidence": {
             "type": "number",
             "description": "Confidence of the hypothesis. Rated from 0 (lowest) to 1 (highest)."
           }
         }
       },
       {
-        "id": "SpeechResultEvent",
+        "id": "ResultEvent",

[Satish, 2011/10/09 20:01:47]

while events and methods are always accessed via the speechInput namespace, I'm
not sure if types are. Can you check? Would this cause a name clash with any
other api if that api also uses the name 'ResultEvent' as a type name? In that
case a prefix of 'SpeechInput' may be appropriate for all types of this api

[Leandro Graciá Gil, 2011/10/10 18:59:38]

Looks like you're right. I've tried to use a different name for the same type
contents inside the accessibility namespace and it keeps working. I'm prefixing
SpeechInput to all the local types.

On 2011/10/09 20:01:47, Satish wrote:

         "type": "object",
         "description": "Object containing the recognition results.",
         "properties": {
           "hypotheses": {
             "type": "array",
             "optional": true,
             "description": "Array of zero or more objects describing the stable candidate hypotheses sorted by decreasing likelihood.",
             "items": { "$ref": "ResultHypothesis" }
           }
         }
@@ skipping 69 matching lines @@
       },
       {
         "name": "onSoundStart",
         "type": "function",
         "description": "Called when the system starts detecting sound in the input data.",
         "parameters": []
       },
       {
         "name": "onSoundEnd",
         "type": "function",
-        "description": "Called when the system detects enough silence to consider the ongoing input has ended.",
+        "description": "Called when the system detects enough silence to consider the ongoing speech has ended.",
         "parameters": []
       },
       {
         "name": "onResult",
         "type": "function",
         "description": "Called when speech recognition results are available.",
         "parameters": [
           {
             "name": "event",
-            "$ref": "SpeechResultEvent",
+            "$ref": "ResultEvent",
             "description": "Object containing the speech recognition results."
           }
         ]
       }
     ]
   },
   {
     "namespace": "tts",
     "types": [
       {
@@ skipping 8254 matching lines @@
                 "optional": "true",
                 "description": "The MHTML data as a Blob."
               }
             ]
           }
         ]
       }
     ]
   }
 ]