chrome/common/extensions/api/media_galleries.idl

   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
   3 // found in the LICENSE file.
   4
   5 namespace mediaGalleries {
   6
   7   [inline_doc] enum GetMediaFileSystemsInteractivity {
   8     // Do not act interactively.
   9     no,
  10     // Ask the user to manage permitted media galleries.
  11     yes,
  12     // Ask the user to manage permitted galleries only if the return set would
  13     // otherwise be empty.
  14     if_needed
  15   };
  16
  17   [inline_doc] dictionary MediaFileSystemsDetails {
  18     // Whether to prompt the user for permission to additional media galleries
  19     // before returning the permitted set. Default is silent.  If the value
  20     // 'yes' is passed, or if the application has not been granted access to
  21     // any media galleries and the value 'if_needed' is passed, then the
  22     // media gallery configuration dialog will be displayed.
  23     GetMediaFileSystemsInteractivity? interactive;
  24   };
  25
  26   callback MediaFileSystemsCallback =
  27       void ([instanceOf=LocalFileSystem] optional object[] mediaFileSystems);
  28
  29   interface Functions {
  30     // Get the media galleries configured in this user agent. If none are
  31     // configured or available, the callback will receive an empty array.
  32     static void getMediaFileSystems(optional MediaFileSystemsDetails details,
  33                                     MediaFileSystemsCallback callback);
  34   };
  35
  36 };