1
    2
    3
    4
    5
    6
    7
    8
    9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
   60
   61
   62
   63
   64
   65
   66
   67
   68
   69
   70
   71
   72
   73
   74
   75
   76
   77
   78
   79
   80
   81
   82
   83
   84
   85
   86
   87
   88
   89
   90
   91
   92
   93
   94
   95
   96
   97
   98
   99
  100
  101
  102
  103
  104
  105
  106
  107
  108
  109
  110
  111
  112
  113
  114
  115
  116
  117
  118
  119
  120
  121


ash / system / power / power_sounds_controller.h [blame]

// Copyright 2022 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef ASH_SYSTEM_POWER_POWER_SOUNDS_CONTROLLER_H_
#define ASH_SYSTEM_POWER_POWER_SOUNDS_CONTROLLER_H_

#include "ash/system/power/power_status.h"
#include "chromeos/dbus/power/power_manager_client.h"
#include "components/prefs/pref_member.h"

class PrefRegistrySimple;

namespace ash {

namespace {

using ExternalPower = power_manager::PowerSupplyProperties_ExternalPower;

}

// Controller class to manage power/battery sounds.
class ASH_EXPORT PowerSoundsController
    : public PowerStatus::Observer,
      public chromeos::PowerManagerClient::Observer {
 public:
  static const char kPluggedInBatteryLevelHistogramName[];
  static const char kUnpluggedBatteryLevelHistogramName[];

  PowerSoundsController();
  PowerSoundsController(const PowerSoundsController&) = delete;
  PowerSoundsController& operator=(const PowerSoundsController&) = delete;
  ~PowerSoundsController() override;

  static void RegisterLocalStatePrefs(PrefRegistrySimple* registry);

  // PowerStatus::Observer:
  void OnPowerStatusChanged() override;

  // chromeos::PowerManagerClient::Observer:
  void LidEventReceived(chromeos::PowerManagerClient::LidState state,
                        base::TimeTicks timestamp) override;

 private:
  friend class PowerSoundsControllerTest;

  // Type of the battery state according to the critical power or low power
  // threshold.
  enum class BatteryState {
    // The remaining battery level or minutes isn't larger than the critical
    // power threshold.
    kCriticalPower,

    // The remaining battery level or minutes isn't larger than the low power
    // threshold but higher than the critical power threshold.
    kLowPower,

    // Other status. e.g. when connecting with an AC charger, or the remaining
    // battery level larger than the low power threshold.
    kNone,
  };

  // Updates the lid state from received switch states.
  void OnReceiveSwitchStates(
      std::optional<chromeos::PowerManagerClient::SwitchStates> switch_states);

  // Returns true if the device can play sounds.
  bool CanPlaySounds() const;

  void SetPowerStatus(int battery_level,
                      bool is_calculating_battery_time,
                      ExternalPower external_power,
                      std::optional<base::TimeDelta> remaining_time);

  // Plays a sound when any power resource is connected.
  // `old_ac_charger_connected` records whether line power was connected last
  // time when `OnPowerStatusChanged()` was called.
  void MaybePlaySoundsForCharging(bool old_ac_charger_connected);

  bool ShouldPlayLowBatterySound() const;

  // Returns true if the `current_state_` will be updated to a new state.
  bool UpdateBatteryState(bool is_calculating_battery_time,
                          ExternalPower external_power,
                          std::optional<base::TimeDelta> remaining_time);

  BatteryState CalculateBatteryState(
      bool is_calculating_battery_time,
      ExternalPower external_power,
      std::optional<base::TimeDelta> remaining_time) const;
  BatteryState GetBatteryStateFromBatteryLevel() const;
  BatteryState GetBatteryStateFromRemainingTime(
      std::optional<base::TimeDelta> remaining_time) const;

  // Records the battery level when the `OnPowerStatusChanged()` was called.
  int battery_level_;

  // True if an AC charger is connected when the `OnPowerStatusChanged()` was
  // called.
  bool is_ac_charger_connected_;

  BatteryState current_state_ = BatteryState::kNone;

  chromeos::PowerManagerClient::LidState lid_state_ =
      chromeos::PowerManagerClient::LidState::OPEN;

  // An observer to listen for changes to prefs::kLowBatterySoundEnabled.
  BooleanPrefMember low_battery_sound_enabled_;

  // An observer to listen for changes to prefs::kChargingSoundsEnabled.
  BooleanPrefMember charging_sounds_enabled_;

  raw_ptr<PrefService> local_state_ =
      nullptr;  // Non-owned and must out-live this.

  base::WeakPtrFactory<PowerSoundsController> weak_factory_{this};
};

}  // namespace ash

#endif  // ASH_SYSTEM_POWER_POWER_SOUNDS_CONTROLLER_H_