Initial extension bindings for Media Gallery API.

chrome/common/extensions/api/experimental.mediaGalleries.json

Index: chrome/common/extensions/api/experimental.mediaGalleries.json
diff --git a/chrome/common/extensions/api/experimental.mediaGalleries.json b/chrome/common/extensions/api/experimental.mediaGalleries.json
new file mode 100644
index 0000000000000000000000000000000000000000..3f35d3773652e35edf2dd388346f071b357f5a0f
--- /dev/null
+++ b/chrome/common/extensions/api/experimental.mediaGalleries.json
@@ -0,0 +1,98 @@
+[
+  {
+    "namespace": "experimental.mediaGalleries",
+    "nodoc": true,
+    "types": [
+      {
+        "id": "MediaGallery",
+        "type": "object",

[jstritar, 2012/03/21 00:02:02]

you can add properties to the object if you know what they'll be. here's an
example for Tab:

http://code.google.com/codesearch#OAMlx_jo-ck/src/chrome/common/extensions/ap...

[vandebo (ex-Chrome), 2012/03/21 16:17:57]

I'll put the full defincition of this and other objects here  (for documentation
only) in a later CL.

+        "description": "A class representing a media gallery on the user's machines."
+      },
+      {
+        "id": "MediaFileMetadata",
+        "type": "object",
+        "description": "A class representing a metadata for a media file."
+      }
+    ],
+    "functions": [
+      {
+        "name": "getMediaGalleries",
+        "type": "function",
+        "description": "Get the media galleries configured in this user agent. Calling getMediaGalleries will trigger a permission prompt for any origin that has not yet been granted permission.",

[jstritar, 2012/03/21 00:02:02]

Do you mean these will just be protected by host permissions? e.g., they need to
have permissions: ["http://google.com/*"] for google to call these methods? In
that case, you can probably rely on existing ways of acquiring permissions
(manifest.json and optional permissions), rather than prompting yourself?

[vandebo (ex-Chrome), 2012/03/21 16:17:57]

Sorry this comment is forward looking to a web standard API implementation. 
Changed to be accurate for the current, extension only, implementation.

+        "parameters": [
+          {
+            "type": "function",
+            "name": "callback",
+            "parameters": [
+              {
+                "name": "galleries",
+                "type": "array",
+                "items": { "$ref": "MediaGallery"}
+              }
+            ]
+          }
+        ]
+      },
+      {
+        "name": "openMediaGalleryManager",
+        "type": "function",
+        "description": "Open the user agent’s UI to configure galleries. Calling openMediaGalleryManager will trigger a permission prompt for any origin that has not yet been granted permission.",
+        "parameters": []
+      },
+      {
+        "name": "assembleMediaFile",
+        "type": "function",
+        "description": "Create a new MediaFile setting the metadata in the Blob to the supplied values, overriding any existing metadata in the media file.  If user agent does not recognize the  Blob as a supported file format, it will return null in the callback.",
+        "parameters": [
+          {
+            "type": "object",

[jstritar, 2012/03/21 00:02:02]

should this be type Blob?

[vandebo (ex-Chrome), 2012/03/21 16:17:57]

I had it as a blob but when I added the API test it wouldn't validate.  I
searched the other extension description json - the only other place blob/Blob
is used is as a callback argument (which I think isn't validated). 

[jstritar, 2012/03/21 18:10:47]

If you think there's a bug in there, can you file it?

[vandebo (ex-Chrome), 2012/03/21 22:08:07]

Filed http://crbug.com/119372

+            "description": "A Blob",
+            "name": "mediaFileContents"
+          },
+          {
+            "$ref": "MediaFileMetadata",
+            "name": "metadata"
+          },
+          {
+            "type": "function",
+            "name": "callback",
+            "parameters": [
+              {
+                "name": "mediaFile",
+                "choices": [
+                  { "type": "Blob" },
+                  { "type": "null" }
+                ]
+              }
+            ]
+          }
+        ]
+      },
+      {
+        "name": "parseMediaFileMetadata",
+        "type": "function",
+        "description": "Parse the metadata in a given Blob. If the user agent does not recognize the Blob as a supported file format, it will return null in the callback.",
+        "parameters": [
+          {
+            "type": "object",
+            "description": "A Blob",

[jstritar, 2012/03/21 00:02:02]

ditto

+            "name": "mediaFile"
+          },
+          {
+            "type": "function",
+            "name": "callback",
+            "parameters": [
+              {
+                "name": "metadata",
+                "choices": [
+                  {"$ref": "MediaFileMetadata"},
+                  { "type": "null" }
+                ]
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  }
+]