Index: base/power_state_manager.h |
diff --git a/base/power_state_manager.h b/base/power_state_manager.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..bbf77e0c2150979e071ce4cfdc50a60faefec83c |
--- /dev/null |
+++ b/base/power_state_manager.h |
@@ -0,0 +1,126 @@ |
+// Copyright (c) 2012 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 BASE_POWER_STATE_MANAGMER_H_ |
+#define BASE_POWER_STATE_MANAGMER_H_ |
+ |
+#include "base/base_export.h" |
+#include "base/basictypes.h" |
+ |
+// Windows HiRes timers drain the battery faster so we need to know the battery |
+// status. This isn't true for other platforms. |
+#if defined(OS_WIN) |
+#define ENABLE_BATTERY_MONITORING 1 |
+#else |
+#undef ENABLE_BATTERY_MONITORING |
+#endif // !OS_WIN |
+ |
+#include "base/observer_list_threadsafe.h" |
+#if defined(ENABLE_BATTERY_MONITORING) |
+#include "base/timer.h" |
+#endif // defined(ENABLE_BATTERY_MONITORING) |
+ |
+#if defined(OS_IOS) |
+#include <objc/runtime.h> |
+#endif // OS_IOS |
+ |
+namespace base { |
+ |
+class BASE_EXPORT PowerStateManager { |
+ public: |
+ // Normalized list of power events. |
+ enum PowerEvent { |
+ POWER_STATE_EVENT, // The Power status of the system has changed. |
+ SUSPEND_EVENT, // The system is being suspended. |
+ RESUME_EVENT // The system is being resumed. |
+ }; |
+ |
+ // Callbacks will be called on the thread which creates the SystemMonitor. |
+ // During the callback, Add/RemoveObserver will block until the callbacks |
+ // are finished. Observers should implement quick callback functions; if |
+ // lengthy operations are needed, the observer should take care to invoke |
+ // the operation on an appropriate thread. |
+ class BASE_EXPORT PowerObserver { |
+ public: |
+ // Notification of a change in power status of the computer, such |
+ // as from switching between battery and A/C power. |
+ virtual void OnPowerStateChange(bool on_battery_power) {} |
+ |
+ // Notification that the system is suspending. |
+ virtual void OnSuspend() {} |
+ |
+ // Notification that the system is resuming. |
+ virtual void OnResume() {} |
+ |
+ protected: |
+ virtual ~PowerObserver() {} |
+ }; |
+ |
+ PowerStateManager(); |
+ ~PowerStateManager(); |
+ |
+ void AddPowerObserver(PowerObserver* observer); |
+ void RemovePowerObserver(PowerObserver* observer); |
+ |
+ // Handle the power event and notify its observers with the specific state. |
+ void HandlePowerEvent(PowerEvent event_id); |
+ |
+ // Is the computer currently on battery power. Can be called on any thread. |
+ bool BatteryPower() const { |
+ // Using a lock here is not necessary for just a bool. |
+ return battery_in_use_; |
+ } |
+ |
+ // Return the single instance in the application wide. |
+ static PowerStateManager* Get(); |
+ |
+#if defined(OS_MACOSX) |
+ // Allocate system resources needed by the PowerStateManager class. |
+ // |
+ // This function must be called before instantiating an instance of the class |
+ // and before the Sandbox is initialized. |
+#if !defined(OS_IOS) |
+ static void AllocateSystemIOPorts(); |
+#else |
+ static void AllocateSystemIOPorts() {} |
+#endif // OS_IOS |
+#endif // OS_MACOSX |
+ |
+ private: |
+#if defined(OS_MACOSX) |
+ void PlatformInit(); |
+ void PlatformDestroy(); |
+#endif |
+ |
+ // Platform-specific method to check whether the system is currently |
+ // running on battery power. Returns true if running on batteries, |
+ // false otherwise. |
+ bool IsBatteryPower(); |
+ |
+ // Checks the battery status and notifies observers if the battery |
+ // status has changed. |
+ void BatteryCheck(); |
+ |
+ void NotifyPowerStateChange(); |
+ void NotifySuspend(); |
+ void NotifyResume(); |
+ |
+#if defined(OS_IOS) |
+ // Holds pointers to system event notification observers. |
+ std::vector<id> notification_observers_; |
+#endif |
+ |
+#if defined(ENABLE_BATTERY_MONITORING) |
+ base::OneShotTimer<SystemMonitor> delayed_battery_check_; |
+#endif |
+ scoped_refptr<ObserverListThreadSafe<PowerObserver> > power_observer_list_; |
+ bool battery_in_use_; |
+ bool suspended_; |
+ |
+ DISALLOW_COPY_AND_ASSIGN(PowerStateManager); |
+}; |
+ |
+} // namespace base |
+ |
+#endif // BASE_POWER_STATE_MANAGMER_H_ |