[Chromecast] Add new volume control API to CastMediaShlib

chromecast/public/avsettings.h

 // Copyright 2015 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.
 
 #ifndef CHROMECAST_PUBLIC_AVSETTINGS_H_
 #define CHROMECAST_PUBLIC_AVSETTINGS_H_
 
 #include <stdint.h>
 
 #include "output_restrictions.h"
@@ skipping 55 matching lines @@
   enum Event {
     // This event shall be fired whenever the active state is changed including
     // when the screen turned on, when the cast receiver (or the device where
     // cast receiver is running on) became the active input source, or after a
     // call to TurnActive() or TurnStandby().
     // WakeSystem() may change the active state depending on implementation.
     // On this event, GetActiveState() will be called on the thread where
     // Initialize() was called.
     ACTIVE_STATE_CHANGED = 0,
 
+    // DEPRECATED - Prefer to implement volume control in the media shlib using
+    // the VolumeControl API (see chromecast/public/volume_control.h).
     // This event shall be fired whenever the system volume level or muted state
     // are changed including when user changed volume via a remote controller,
     // or after a call to SetAudioVolume() or SetAudioMuted().
     // On this event, GetAudioVolume() and IsAudioMuted() will be called on
     // the thread where Initialize() was called.
     AUDIO_VOLUME_CHANGED = 1,
 
     // This event shall be fired whenever the audio codecs supported by the
     // device (or HDMI sinks connected to the device) are changed.
     // On this event, GetAudioCodecsSupported() and GetMaxAudioChannels() will
@@ skipping 110 matching lines @@
   // interval is specified by platform; returns false if interval should defer
   // to default values.
   //
   // Current default volume step intervals per control type are as follows:
   //  - MASTER_VOLUME: 0.05 (5%)
   //  - ATTENUATION_VOLUME: 0.02 (2%)
   //  - FIXED_VOLUME: 0.01 (1%)
   //  - UNKNOWN_VOLUME: 0.01 (1%)
   virtual bool GetAudioVolumeStepInterval(float* step_inteval) = 0;
 
+  // DEPRECATED - Prefer to implement volume control in the media shlib using
+  // the VolumeControl API (see chromecast/public/volume_control.h).
   // Returns the current volume level, which must be from 0.0 (inclusive) to
   // 1.0 (inclusive).
   virtual float GetAudioVolume() = 0;
 
+  // DEPRECATED - Prefer to implement volume control in the media shlib using
+  // the VolumeControl API (see chromecast/public/volume_control.h).
   // Sets new volume level of the device (or HDMI sinks). |level| is from 0.0
   // (inclusive) to 1.0 (inclusive).
   // If successful and the level has changed, it must return true and fire
   // AUDIO_VOLUME_CHANGED.
   virtual bool SetAudioVolume(float level) = 0;
 
+  // DEPRECATED - Prefer to implement volume control in the media shlib using
+  // the VolumeControl API (see chromecast/public/volume_control.h).
   // Whether or not the device (or HDMI sinks) is muted.
   virtual bool IsAudioMuted() = 0;
 
+  // DEPRECATED - Prefer to implement volume control in the media shlib using
+  // the VolumeControl API (see chromecast/public/volume_control.h).
   // Sets the device (or HDMI sinks) muted.
   // If successful and the muted state has changed, it must return true and fire
   // AUDIO_VOLUME_CHANGED.
   virtual bool SetAudioMuted(bool muted) = 0;
 
   // Gets audio codecs supported by the device (or HDMI sinks).
   // The result is an integer of OR'ed AudioCodec values.
   virtual int GetAudioCodecsSupported() = 0;
 
   // Gets maximum number of channels for given audio codec, |codec|.
@@ skipping 94 matching lines @@
   // the current HDMI mode.  Returns false otherwise.
   //
   // Non-HDMI devices should return false.
   virtual bool IsHdrOutputSupportedByCurrentHdmiVideoMode(
       HdrOutputType output_type) = 0;
 };
 
 }  // namespace chromecast
 
 #endif  // CHROMECAST_PUBLIC_AVSETTINGS_H_