Restrict deprecated parts of audio API usage to whitelisted apps

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 {
 
   // Type of stream an audio device provides.
@@ skipping 14 matching lines @@
     FRONT_MIC,
     REAR_MIC,
     KEYBOARD_MIC,
     HOTWORD,
     LINEOUT,
     POST_MIX_LOOPBACK,
     POST_DSP_LOOPBACK,
     OTHER
   };
 
-  [deprecated = "Used only with the deprecated $(ref:getInfo)."]
+  [nodoc, deprecated = "Used only with the deprecated $(ref:getInfo)."]
   dictionary OutputDeviceInfo {
     // The unique identifier of the audio output device.
     DOMString id;
     // The user-friendly name (e.g. "Bose Amplifier").
     DOMString name;
     // True if this is the current active device.
     boolean isActive;
     // True if this is muted.
     boolean isMuted;
     // The output volume ranging from 0.0 to 100.0.
     double volume;
   };
 
-  [deprecated = "Used only with the deprecated $(ref:getInfo)."]
+  [nodoc, deprecated = "Used only with the deprecated $(ref:getInfo)."]
   dictionary InputDeviceInfo {
     // The unique identifier of the audio input device.
     DOMString id;
     // The user-friendly name (e.g. "USB Microphone").
     DOMString name;
     // True if this is the current active device.
     boolean isActive;
     // True if this is muted.
     boolean isMuted;
     // The input gain ranging from 0.0 to 100.0.
     double gain;
   };
 
   dictionary AudioDeviceInfo {
     // The unique identifier of the audio device.
     DOMString id;
     // Stream type associated with this device.
     StreamType streamType;
-    // True for input device; false for output device.
-    [deprecated="Use |streamType|."] boolean isInput;
     // Type of the device.
     DeviceType deviceType;
     // The user-friendly name (e.g. "USB Microphone").
     DOMString displayName;
     // Device name.
     DOMString deviceName;
     // True if this is the current active device.
     boolean isActive;
-    // True if this is muted.
-    boolean isMuted;
     // The sound level of the device, volume for output, gain for input.
     long level;
     // The stable/persisted device id string when available.
     DOMString? stableDeviceId;
   };
 
   dictionary DeviceFilter {
     // If set, only audio devices whose stream type is included in this list
     // will satisfy the filter.
     StreamType[]? streamTypes;
 
     // If set, only audio devices whose active state matches this value will
     // satisfy the filter.
     boolean? isActive;
   };
 
   dictionary DeviceProperties {
     // True if this is muted.
-    [deprecated="Use $(ref:setMute) to set mute state."] boolean? isMuted;
+    [nodoc, deprecated="Use $(ref:setMute) to set mute state."]
+    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.
-    [deprecated="Use |level| to set output volume."] double? volume;
+    [nodoc, deprecated="Use |level| to set output volume."] 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.
-    [deprecated="Use |level| to set input gain."] double? gain;
+    [nodoc, deprecated="Use |level| to set input gain."] double? gain;
  
     // <p>
     //   The audio device's desired sound level. Defaults to the device's
     //   current sound level.
     // </p> 
     // <p>If used with audio input device, represents audio device gain.</p>
     // <p>If used with audio output device, represents audio device volume.</p>
     long? level;
   };
 
@@ skipping 68 matching lines @@
 
     // Sets mute state for a stream type. The mute state will apply to all audio
     // devices with the specified audio stream type.
     // |streamType|: Stream type for which mute state should be set.
     // |isMuted|: New mute value.
     static void setMute(StreamType streamType,
                         boolean isMuted,
                         optional EmptyCallback callback);
 
     // Gets the information of all audio output and input devices.
-    [deprecated="Use $(ref:getDevices) instead."]
+    [nodoc, deprecated="Use $(ref:getDevices) instead."]
     static void getInfo(GetInfoCallback callback);
   };
 
   interface Events {
     // Fired when sound level changes for an active audio device.
     static void onLevelChanged(LevelChangedEvent event);
 
     // Fired when the mute state of the audio input or output changes.
     // Note that mute state is system-wide and the new value applies to every
     // audio device with specified stream type.
     static void onMuteChanged(MuteChangedEvent event);
 
     // 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 onDeviceListChanged(AudioDeviceInfo[] devices);
 
     // Fired when anything changes to the audio device configuration.
-    [deprecated="Use more granular $(ref:onLevelChanged),
-                 $(ref:onMuteChanged) and $(ref:onDeviceListChanged) instead."]
+    [nodoc, deprecated="Use more granular $(ref:onLevelChanged),
+         $(ref:onMuteChanged) and $(ref:onDeviceListChanged) instead."]
     static void onDeviceChanged();
   };
 };