Update To 11.40.268.0

[platform/framework/web/crosswalk.git] / src / extensions / common / api / usb.idl

diff --git a/src/extensions/common/api/usb.idl b/src/extensions/common/api/usb.idl
index af6d550..bae27e2 100644 (file)
--- a/src/extensions/common/api/usb.idl
+++ b/src/extensions/common/api/usb.idl
@@ -186,17 +186,25 @@ namespace usb {
     // will return all devices the app has permission for.
     DeviceFilter[]? filters;
   };
-  
+
   dictionary EnumerateDevicesAndRequestAccessOptions {
     // The device vendor ID.
     long vendorId;
     // The product ID.
     long productId;
     // The interface ID to request access to.
-    // Only available on ChromeOS. It has no effect on other platforms.
+    // Only available on Chrome OS. It has no effect on other platforms.
     long? interfaceId;
   };
 
+  dictionary DevicePromptOptions {
+    // Allow the user to select multiple devices.
+    boolean? multiple;
+    // Filter the list of devices presented to the user. If multiple filters are
+    // provided devices matching any filter will be displayed.
+    DeviceFilter[]? filters;
+  };
+
   callback VoidCallback = void ();
   callback GetDevicesCallback = void (Device[] devices);
   callback RequestAccessCallback = void (boolean success);
@@ -214,14 +222,25 @@ namespace usb {
     static void getDevices(EnumerateDevicesOptions options,
                            GetDevicesCallback callback);
 
+    // Presents a device picker to the user and returns the $(ref:Device)s
+    // selected.
+    // If the user cancels the picker devices will be empty. A user gesture
+    // is required for the dialog to display. Without a user gesture, the
+    // callback will run as though the user cancelled.
+    // |options|: Configuration of the device picker dialog box.
+    // |callback|: Invoked with a list of chosen $(ref:Device)s.
+    static void getUserSelectedDevices(DevicePromptOptions options,
+                                       GetDevicesCallback callback);
+
     // Requests access from the permission broker to a device claimed by
-    // ChromeOS if the given interface on the device is not claimed.
-    //
-    // <b>Note:</b> This method is ChromeOS specific. Calling this method on
-    // other platforms will fail.
+    // Chrome OS if the given interface on the device is not claimed.
     //
     // |device|: The $(ref:Device) to request access to.
     // |interfaceId|: The particular interface requested.
+    [deprecated="This function was Chrome OS specific and calling it on other
+    platforms would fail. This operation is now implicitly performed as part of
+    $(ref:openDevice) and this function will return <code>true</code> on all
+    platforms."]
     static void requestAccess(Device device,
                               long interfaceId,
                               RequestAccessCallback callback);
@@ -233,16 +252,11 @@ namespace usb {
     // Finds USB devices specified by the vendor, product and (optionally)
     // interface IDs and if permissions allow opens them for use.
     //
-    // On Chrome OS, you can specify the interface ID. In that case the method
-    // will request access from permission broker in the same way as
-    // $(ref:requestAccess).
-    //
     // If the access request is rejected or the device fails to be opened a
     // connection handle will not be created or returned.
     //
-    // Calling this method is equivalent to calling $(ref:getDevices followed by
-    // $(ref:requestAccess) (if it is on ChromeOS) and $(ref:openDevice) for
-    // each device.
+    // Calling this method is equivalent to calling $(ref:getDevices) followed
+    // by $(ref:openDevice) for each device.
     //
     // |options|: The properties to search for on target devices.
     static void findDevices(EnumerateDevicesAndRequestAccessOptions options,