OLD | NEW |
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 // File-level comment to appease parser. Eventually this will not be necessary. | 5 // File-level comment to appease parser. Eventually this will not be necessary. |
6 | 6 |
7 namespace experimental.mediaGalleries { | 7 namespace experimental.mediaGalleries { |
8 | 8 |
| 9 [inline_doc] enum GetMediaFileSystemsInteractivity { |
| 10 // Do not act interactively. |
| 11 no, |
| 12 // Ask the user to manage permitted media galleries. |
| 13 yes, |
| 14 // Ask the user to manage permitted galleries only if the return set would |
| 15 // otherwise be empty. |
| 16 if_needed |
| 17 }; |
| 18 |
| 19 [inline_doc] dictionary MediaFileSystemsDetails { |
| 20 // Whether to prompt the user for permission to additional media galleries |
| 21 // before returning the permitted set. Default is silent. If the value |
| 22 // 'yes' is passed, or if the application has not been granted access to |
| 23 // any media galleries and the value 'if_needed' is passed, then the |
| 24 // media gallery configuration dialog will be displayed. |
| 25 GetMediaFileSystemsInteractivity? interactive; |
| 26 }; |
| 27 |
| 28 callback MediaFileSystemsCallback = |
| 29 void ([instanceOf=LocalFileSystem] optional object[] mediaFileSystems); |
| 30 |
9 callback AssembleMediaFileCallback = | 31 callback AssembleMediaFileCallback = |
10 void ([instanceOf=Blob] optional object mediaFile); | 32 void ([instanceOf=Blob] optional object mediaFile); |
11 | 33 |
12 interface Functions { | 34 interface Functions { |
| 35 // Get the media galleries configured in this user agent. If none are |
| 36 // configured or available, the callback will receive an empty array. |
| 37 static void getMediaFileSystems(optional MediaFileSystemsDetails details, |
| 38 MediaFileSystemsCallback callback); |
| 39 |
13 // Create a new MediaFile setting the metadata in the Blob to the supplied | 40 // Create a new MediaFile setting the metadata in the Blob to the supplied |
14 // values, overriding any existing metadata in the media file. If user agent | 41 // values, overriding any existing metadata in the media file. If user agent |
15 // does not recognize the Blob as a supported file format, it will fail. | 42 // does not recognize the Blob as a supported file format, it will fail. |
16 // |mediaFileContents| : the media bytes. | 43 // |mediaFileContents| : the media bytes. |
17 // |metadata| : the metadata. TODO(estade): this should be | 44 // |metadata| : the metadata. TODO(estade): this should be |
18 // [instanceOf=Metafile]. | 45 // [instanceOf=Metafile]. |
19 static void assembleMediaFile( | 46 static void assembleMediaFile( |
20 [instanceOf=Blob] object mediaFileContents, | 47 [instanceOf=Blob] object mediaFileContents, |
21 object metadata, | 48 object metadata, |
22 AssembleMediaFileCallback callback); | 49 AssembleMediaFileCallback callback); |
23 | 50 |
24 // Get any thumbnails contained in the passed media file. The resulting | 51 // Get any thumbnails contained in the passed media file. The resulting |
25 // directory reader refers to a virtual directory that can not be navigated | 52 // directory reader refers to a virtual directory that can not be navigated |
26 // to. If there are no thumbnails in the passed file entry, the virtual | 53 // to. If there are no thumbnails in the passed file entry, the virtual |
27 // directory will have no entries. | 54 // directory will have no entries. |
28 // TODO(estade): The return type should be Directory. The argument type | 55 // TODO(estade): The return type should be Directory. The argument type |
29 // should be [instanceOf=FileEntry]. | 56 // should be [instanceOf=FileEntry]. |
30 [nocompile] static object extractEmbeddedThumbnails(object mediaFile); | 57 [nocompile] static object extractEmbeddedThumbnails(object mediaFile); |
31 }; | 58 }; |
32 | 59 |
33 }; | 60 }; |
OLD | NEW |