Native Messaging!

chrome/common/extensions/api/extension.json

Index: chrome/common/extensions/api/extension.json
diff --git a/chrome/common/extensions/api/extension.json b/chrome/common/extensions/api/extension.json
index 9efc4961a2e50b473408adf7be0ce8e3dddbe6a3..c4fdea1a828325267108f817b6b18df5ad270638 100644
--- a/chrome/common/extensions/api/extension.json
+++ b/chrome/common/extensions/api/extension.json
@@ -75,6 +75,31 @@
         }
       },
       {
+        "name": "connectNative",
+        "type": "function",
+        "unprivileged": true,

[Aaron Boodman, 2012/08/09 18:36:12]

"unprivileged" controls whether the api is available outside the extension
process (like in content scripts). We don't want that.

[eaugusti, 2012/08/13 23:22:34]

Done.

+        "description": "Attempts to connect a native app.",
+        "parameters": [
+          {
+            "type": "string",
+            "name": "appName",
+            "description": "The name of the registered app to connect to."
+          },
+          {
+            "name": "connectionMessage",
+            "description": "The object that will be passed to the registered native app on connection.",
+            "type": "object",
+            "additionalProperties": {
+              "type": "any"
+            }
+          }
+        ],
+        "returns": {
+          "$ref": "Port",
+          "description": "Port through which messages can be sent and received with the app."
+        }
+      },
+      {
         "name": "sendRequest",
         "nodoc": true,
         "type": "function",
@@ -122,6 +147,42 @@
         ]
       },
       {
+        "name": "sendNativeMessage",
+        "type": "function",
+        "description": "Send a single message to a registered native application.",
+        "parameters": [
+          {
+            "name": "registeredNativeApp",
+            "description": "The name of the registered native app.",
+            "type": "string"
+          },
+          {
+            "name": "message",
+            "description": "The message that will be passed to the registered native app.",
+            "type": "object",
+            "additionalProperties": {
+              "type": "any"
+            }
+          },
+          {
+            "type": "function",
+            "name": "callback",
+            "optional": true,
+            "description": "Called with the response from the native app.",
+            "parameters": [
+              {
+                "name": "nativeResponse",
+                "type": "object",
+                "description": "Whatever the native app responds with.",
+                "additionalProperties": {
+                  "type": "any"
+                }
+              }
+            ]
+          }
+        ]
+      },
+      {
         "name": "getURL",
         "type": "function",
         "unprivileged": true,