Plugin Power Saver: Mute throttled plugins.

content/public/renderer/plugin_instance_throttler.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 CONTENT_PUBLIC_RENDERER_PLUGIN_INSTANCE_THROTTLER_H_
 #define CONTENT_PUBLIC_RENDERER_PLUGIN_INSTANCE_THROTTLER_H_
 
 #include "base/macros.h"
 #include "base/memory/scoped_ptr.h"
 #include "content/common/content_export.h"
@@ skipping 41 matching lines @@
   // How the throttled power saver is unthrottled, if ever.
   // These numeric values are used in UMA logs; do not change them.
   enum PowerSaverUnthrottleMethod {
     UNTHROTTLE_METHOD_NEVER = 0,
     UNTHROTTLE_METHOD_BY_CLICK = 1,
     UNTHROTTLE_METHOD_BY_WHITELIST = 2,
     UNTHROTTLE_METHOD_BY_AUDIO = 3,
     UNTHROTTLE_METHOD_NUM_ITEMS
   };
 
+  enum PowerSaverState {
+    // Initial state if Power Saver is disabled. We are just collecting metrics.
+    POWER_SAVER_DISABLED,
+    // Initial state if Power Saver is enabled. Waiting for a keyframe.
+    POWER_SAVER_ENABLED_AWAITING_KEYFRAME,
+    // We've chosen a keyframe and the plug-in is throttled.
+    POWER_SAVER_ENABLED_PLUGIN_THROTTLED,
+    // Plugin instance is no longer considered peripheral. This can happen from
+    // a user click, whitelisting, or some other reason. We can end up in this
+    // state regardless of whether power saver is enabled.
+    POWER_SAVER_MARKED_ESSENTIAL
+  };
+
   class Observer {
    public:
-    virtual void OnThrottleStateChange() = 0;
+    virtual void OnPowerSaverStateChange(PowerSaverState state) = 0;
   };
 
   // Returns a nullptr if no throttler needed based on |power_saver_mode|.
   static scoped_ptr<PluginInstanceThrottler> Get(
       RenderFrame* frame,
       const GURL& plugin_url,
       PluginPowerSaverMode power_saver_mode);
 
   static void RecordUnthrottleMethodMetric(PowerSaverUnthrottleMethod method);
 
   virtual ~PluginInstanceThrottler() {}
 
   virtual void AddObserver(Observer* observer) = 0;
   virtual void RemoveObserver(Observer* observer) = 0;
 
   virtual bool IsThrottled() const = 0;
 
   // Marks the plugin as essential. Unthrottles the plugin if already throttled.
   virtual void MarkPluginEssential(PowerSaverUnthrottleMethod method) = 0;
 
  protected:
   PluginInstanceThrottler() {}
 
  private:
   DISALLOW_COPY_AND_ASSIGN(PluginInstanceThrottler);
 };
 }
 
 #endif  // CONTENT_PUBLIC_RENDERER_PLUGIN_INSTANCE_THROTTLER_H_