Simplify logic behind chrome.audio.setActiveDevices

extensions/common/api/audio.idl

 // Copyright (c) 2013 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.
 
 // The <code>chrome.audio</code> API is provided to allow users to
 // get information about and control the audio devices attached to the
 // system. This API is currently only implemented for ChromeOS.
 namespace audio {
 
   dictionary OutputDeviceInfo {
@@ skipping 49 matching lines @@
     // True if this is muted.
     boolean isMuted;
     // If this is an output device then this field indicates the output volume.
     // If this is an input device then this field is ignored.
     double? volume;
     // If this is an input device then this field indicates the input gain.
     // If this is an output device then this field is ignored.
     double? gain;
   };
 
+  dictionary DeviceIdLists {
+    // <p>List of input devices specified by their ID.</p>
+    // <p>To indicate input devices should be unaffected, leave this property
+    //   unset.</p>
+    DOMString[]? input;
+
+    // <p>List of output devices specified by their ID.</p>
+    // <p>To indicate output devices should be unaffected, leave this property
+    //   unset.</p>
+    DOMString[]? output;
+  };
+
   callback GetInfoCallback = void(OutputDeviceInfo[] outputInfo,
                                   InputDeviceInfo[] inputInfo);
-  callback SetActiveDevicesCallback = void();
-  callback SetPropertiesCallback = void();
+  callback EmptyCallback = void();
 
   interface Functions {
     // Gets the information of all audio output and input devices.
     static void getInfo(GetInfoCallback callback);
 
-  // Sets the active devices to the devices specified by |ids|.
-  // It can pass in the "complete" active device id list of either input
-  // devices, or output devices, or both. If only input device ids are passed
-  // in, it will only change the input devices' active status, output devices will
-  // NOT be changed; similarly for the case if only output devices are passed.
-  // If the devices specified in |new_active_ids| are already active, they will
-  // remain active. Otherwise, the old active devices will be de-activated
-  // before we activate the new devices with the same type(input/output).
-    static void setActiveDevices(DOMString[] ids,
-                                 SetActiveDevicesCallback callback);
+    // Sets lists of active input and/or output devices.
+    // |ids|: <p>Specifies IDs of devices that should be active. If either the
+    //     input or output list is not set, devices in that category are
+    //     unaffected.
+    //     </p>
+    //     <p>It is an error to pass in a non-existent device ID.</p>
+    //     <p><b>NOTE:</b> While the method signature allows device IDs to be
+    //     passed as a list of strings, this method of setting active devices
+    //     is deprecated and should not be relied upon to work. Please use
+    //     $(ref: DeviceIdLists) instead.
+    //     </p>
+    static void setActiveDevices((DeviceIdLists or DOMString[]) ids,
+                                 EmptyCallback callback);
 
     // Sets the properties for the input or output device.
     static void setProperties(DOMString id,
                               DeviceProperties properties,
-                              SetPropertiesCallback callback);
-     };
+                              EmptyCallback callback);
+  };
 
   interface Events {
     // Fired when anything changes to the audio device configuration.
     static void onDeviceChanged();
 
     // Fired when sound level changes for an active audio device.
     // |id|: id of the audio device.
     // |level|: new sound level of device(volume for output, gain for input).
     static void OnLevelChanged(DOMString id, long level);
 
     // Fired when the mute state of the audio input or output changes.
     // |isInput|: true indicating audio input; false indicating audio output.
     // |isMuted|: new value of mute state.
     static void OnMuteChanged(boolean isInput, boolean isMuted);
 
     // Fired when audio devices change, either new devices being added, or
     // existing devices being removed.
     // |devices|: List of all present audio devices after the change.
     static void OnDevicesChanged(AudioDeviceInfo[] devices);
   };
 };