Media Controls: add comments regarding cast/remote related calls from element.

third_party/WebKit/Source/core/html/shadow/MediaControls.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 47 matching lines @@
   void showTextTrackAtIndex(unsigned indexToEnable);
   void disableShowingTextTracks();
 
   // Called by the fullscreen buttons to toggle fulllscreen on/off.
   void enterFullscreen();
   void exitFullscreen();
 
   void enteredFullscreen();
   void exitedFullscreen();
 
-  void startedCasting();
-  void stoppedCasting();
-  void refreshCastButtonVisibility();
   void showOverlayCastButtonIfNeeded();
   // Update cast button visibility, but don't try to update our panel
   // button visibility for space.
   void refreshCastButtonVisibilityWithoutUpdate();
 
   void setAllowHiddenVolumeControls(bool);
 
   // Returns the layout object for the part of the controls that should be
   // used for overlap checking during text track layout. May be null.
   LayoutObject* layoutObjectForTextTrackLayout();
@@ skipping 15 matching lines @@
 
   void toggleOverflowMenu();
 
   bool overflowMenuVisible();
 
   // TODO(mlamouri): this is temporary to notify the controls that an
   // HTMLTrackElement failed to load because there is no web exposed way to
   // be notified on the TextTrack object. See https://crbug.com/669977
   void onTrackElementFailedToLoad() { onTextTracksAddedOrRemoved(); }
 
+  // TODO(mlamouri): the following methods will be able to become private when
+  // the controls have moved to modules/ and have access to RemotePlayback.
+  void onRemotePlaybackAvailabilityChanged() { refreshCastButtonVisibility(); }
+  void onRemotePlaybackConnecting() { startedCasting(); }
+  void onRemotePlaybackDisconnected() { stoppedCasting(); }
+
+  // TODO(mlamouri): this method is needed in order to notify the controls that
+  // the attribute have changed.
+  void onDisableRemotePlaybackAttributeChanged() {
+    refreshCastButtonVisibility();
+  }
+
   DECLARE_VIRTUAL_TRACE();
 
  private:
   friend class MediaControlsMediaEventListener;
   friend class MediaControlsOrientationLockDelegateTest;
   friend class MediaControlsTest;
 
   void invalidate(Element*);
 
   class BatchedControlUpdate;
@@ skipping 40 matching lines @@
   void onFocusIn();
   void onTimeUpdate();
   void onDurationChange();
   void onPlay();
   void onPause();
   void onTextTracksAddedOrRemoved();
   void onTextTracksChanged();
   void onError();
   void onLoadedMetadata();
 
+  // Internal cast related methods.
+  void startedCasting();
+  void stoppedCasting();
+  void refreshCastButtonVisibility();
+
   Member<HTMLMediaElement> m_mediaElement;
 
   // Media control elements.
   Member<MediaControlOverlayEnclosureElement> m_overlayEnclosure;
   Member<MediaControlOverlayPlayButtonElement> m_overlayPlayButton;
   Member<MediaControlCastButtonElement> m_overlayCastButton;
   Member<MediaControlPanelEnclosureElement> m_enclosure;
   Member<MediaControlPanelElement> m_panel;
   Member<MediaControlPlayButtonElement> m_playButton;
   Member<MediaControlTimelineElement> m_timeline;
@@ skipping 24 matching lines @@
   int m_panelWidth;
 
   bool m_keepShowingUntilTimerFires : 1;
 };
 
 DEFINE_ELEMENT_TYPE_CASTS(MediaControls, isMediaControls());
 
 }  // namespace blink
 
 #endif