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


ash / accessibility / flash_screen_controller.h [blame]

// Copyright 2024 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_ACCESSIBILITY_FLASH_SCREEN_CONTROLLER_H_
#define ASH_ACCESSIBILITY_FLASH_SCREEN_CONTROLLER_H_

#include <string>

#include "ash/constants/ash_constants.h"
#include "base/scoped_observation.h"
#include "base/timer/timer.h"
#include "ui/gfx/animation/animation_delegate.h"
#include "ui/gfx/animation/throb_animation.h"
#include "ui/message_center/message_center.h"
#include "ui/message_center/message_center_observer.h"
#include "ui/message_center/message_center_types.h"

namespace ash {

// Class to control the feature which flashes the screen when a notification
// is shown.
class FlashScreenController : public message_center::MessageCenterObserver,
                              public gfx::AnimationDelegate {
 public:
  FlashScreenController();
  FlashScreenController(const FlashScreenController&) = delete;
  FlashScreenController& operator=(const FlashScreenController&) = delete;
  ~FlashScreenController() override;

  // MessageCenterObserver:
  void OnNotificationDisplayed(
      const std::string& notification_id,
      const message_center::DisplaySource display_source) override;
  void OnNotificationAdded(const std::string& notification_id) override;

  // AnimationDelegate:
  void AnimationEnded(const gfx::Animation* animation) override;
  void AnimationProgressed(const gfx::Animation* animation) override;
  void AnimationCanceled(const gfx::Animation* animation) override;

  // Runs the flash notification without any notification needing to be
  // displayed.
  void PreviewFlash();

  // No need to stop an ongoing flash if one is happening, the duration is too
  // short.
  void set_enabled(bool enabled) { enabled_ = enabled; }

  void set_color(const SkColor& color) { color_ = color; }

  gfx::ThrobAnimation* GetAnimationForTesting() { return &throb_animation_; }

 private:
  void MaybeFlashOn(const std::string& notification_id);
  void FlashOn();
  void FlashOff();

  bool enabled_ = false;
  SkColor color_ = kDefaultFlashNotificationsColor;

  // A timer that ends the flash screen color.
  base::RetainingOneShotTimer notification_timer_;

  gfx::ThrobAnimation throb_animation_;

  base::ScopedObservation<message_center::MessageCenter, MessageCenterObserver>
      notification_observer_{this};
};
}  // namespace ash

#endif  // ASH_ACCESSIBILITY_FLASH_SCREEN_CONTROLLER_H_