chrome/blink: Add functionality for in-product help for media elements.

third_party/WebKit/Source/modules/media_controls/MediaControlsImpl.h

 /*
  * Copyright (C) 2011, 2012 Apple Inc. All rights reserved.
  * Copyright (C) 2011, 2012 Google Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  * 1. Redistributions of source code must retain the above copyright
  *    notice, this list of conditions and the following disclaimer.
  * 2. Redistributions in binary form must reproduce the above copyright
@@ skipping 80 matching lines @@
   LayoutObject* ContainerLayoutObject() override;
   // Return the internal elements, which is used by registering clicking
   // EventHandlers from MediaControlsWindowEventListener.
   HTMLDivElement* PanelElement() override;
   // TODO(mlamouri): this method is needed in order to notify the controls that
   // the `MediaControlsEnabled` setting has changed.
   void OnMediaControlsEnabledChange() override {
     // There is no update because only the overlay is expected to change.
     RefreshCastButtonVisibilityWithoutUpdate();
   }
+  bool GetDownloadButtonRect(IntRect&) override;
+  void IPHDisabled() override;
   Document& OwnerDocument() { return GetDocument(); }
 
   // Called by the fullscreen buttons to toggle fulllscreen on/off.
   void EnterFullscreen();
   void ExitFullscreen();
 
   // Text track related methods exposed to components handling closed captions.
   void ToggleTextTrackList();
   void ShowTextTrackAtIndex(unsigned);
   void DisableShowingTextTracks();
 
   // Methods related to the overflow menu.
   void ToggleOverflowMenu();
   bool OverflowMenuVisible();
 
   void ShowOverlayCastButtonIfNeeded();
 
   // Methods call by the scrubber.
   void BeginScrubbing();
   void EndScrubbing();
   void UpdateCurrentTimeDisplay();
 
+  void MaybeDispatchDownloadIPHTrigger();
+
   DECLARE_VIRTUAL_TRACE();
 
  private:
   // MediaControlsMediaEventListener is a component that is listening to events
   // and calling the appropriate callback on MediaControlsImpl. The object is
   // split from MedaiControlsImpl to reduce boilerplate and ease reading. In
   // order to not expose accessors only for this component, a friendship is
   // declared.
   friend class MediaControlsMediaEventListener;
   // Same as above but handles the menus hiding when the window is interacted
@@ skipping 117 matching lines @@
   Member<ResizeObserver> resize_observer_;
 
   // Watches the media element for attribute changes and updates media controls
   // as necessary.
   Member<MediaElementMutationCallback> element_mutation_callback_;
 
   TaskRunnerTimer<MediaControlsImpl> element_size_changed_timer_;
   IntSize size_;
 
   bool keep_showing_until_timer_fires_ : 1;
+
+  // Set to true when a IPH for the download button on the controls is being
+  // displayed.
+  bool iph_active_ = false;
+
+  // Set to true after the IPH trigger for an element has been observed. This
+  // ensures that the trigger for an element is observed only once.
+  bool iph_trigger_observed_ = false;
 };
 
 DEFINE_ELEMENT_TYPE_CASTS(MediaControlsImpl, IsMediaControls());
 
 }  // namespace blink
 
 #endif