Add chrome.hid.getUserSelectedDevices API.

extensions/common/api/hid.idl

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // Use the <code>chrome.hid</code> API to interact with connected HID devices.
 // This API provides access to HID operations from within the context of an app.
 // Using this API, apps can function as drivers for hardware devices.
 //
 // Errors generated by this API are reported by setting
 // $(ref:runtime.lastError) and executing the function's regular callback. The
@@ skipping 46 matching lines @@
   dictionary GetDevicesOptions {
     [deprecated="Equivalent to setting $(ref:DeviceFilter.vendorId)."]
     long? vendorId;
     [deprecated="Equivalent to setting $(ref:DeviceFilter.productId)."]
     long? productId;
     // A device matching any given filter will be returned. An empty filter list
     // will return all devices the app has permission for.
     DeviceFilter[]? filters;
   };
 
+  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 GetDevicesCallback = void (HidDeviceInfo[] devices);
   callback ConnectCallback = void (HidConnectInfo connection);
   callback DisconnectCallback = void ();
 
   // |reportId|: The report ID or <code>0</code> if none.
   // |data|: The report data, the report ID prefix (if present) is removed.
   callback ReceiveCallback = void (long reportId, ArrayBuffer data);
 
   // |data|: The report data, including a report ID prefix if one is sent by the
   // device.
   callback ReceiveFeatureReportCallback = void (ArrayBuffer data);
 
   callback SendCallback = void();
 
   interface Functions {
     // Enumerate connected HID devices.
     // |options|: The properties to search for on target devices.
     static void getDevices(GetDevicesOptions options,
                            GetDevicesCallback callback);
 
+    // Presents a device picker to the user and returns $(ref:HidDeviceInfo)
+    // objects for the devices 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. If multiple filters are
+    // provided devices matching any filter will be displayed.
+    // |options|: Configuration of the device picker dialog box.
+    // |callback|: Invoked with a list of chosen $(ref:Device)s.
+    static void getUserSelectedDevices(DevicePromptOptions options,

[Devlin, 2015/05/05 22:19:51]

Why is |options| required?

[Reilly Grant (use Gerrit), 2015/05/06 00:52:53]

No reason.

+                                       GetDevicesCallback callback);
+
     // Open a connection to an HID device for communication.
     // |deviceId|: The $(ref:HidDeviceInfo.deviceId) of the device to open.
     static void connect(long deviceId,
                         ConnectCallback callback);
 
     // Disconnect from a device. Invoking operations on a device after calling
     // this is safe but has no effect.
     // |connectionId|: The <code>connectionId</code> returned by $(ref:connect).
     static void disconnect(long connectionId,
                            optional DisconnectCallback callback);
@@ skipping 42 matching lines @@
     // accepted an optional permission (see $(ref:permissions.request)).
     static void onDeviceAdded(HidDeviceInfo device);
 
     // Event generated when a device is removed from the system. See
     // $(ref:onDeviceAdded) for which events are delivered.
     // |deviceId|: The <code>deviceId</code> property of the device passed to
     // $(ref:onDeviceAdded).
     static void onDeviceRemoved(long deviceId);
   };
 };