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..33288ed91cc70bcd21dfc2842303bf0f829a7cf5
--- /dev/null
+++ b/chrome/common/extensions/api/experimental.mediaGalleries.json
@@ -0,0 +1,96 @@
+[
+  {
+    "namespace": "experimental.mediaGalleries",
+    "nodoc": true,
+    "types": [
+      {
+        "id": "MediaGallery",
+        "type": "object",
+        "description": "A class representing a media gallery on the user's machines."

[jstritar, 2012/02/16 21:34:18]

do you need to define any properties on these?

[vandebo (ex-Chrome), 2012/03/19 23:09:52]

The full API is at go/galleryapi .  As you can see, we actually want to create
instance of this object.  After some investigation (the cause of the delay in
the CL), we'll use custom callbacks and Webkit objects defined by IDL to
implement this.  I'll put the full definition of this and other objects here for
the generated documentation in a later CL.

+      },
+      {
+        "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.",
+        "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": "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": "Blob",
+            "name": "mediaFile"
+          },
+          {
+            "type": "function",
+            "name": "callback",
+            "parameters": [
+              {
+                "name": "metadata",
+                "choices": [
+                  {"$ref": "MediaFileMetadata"},
+                  { "type": "null" }
+                ]
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  }
+]