Media Remoting: Draw remoting interstitial on poster image.

media/remoting/remoting_renderer_controller.h

 // Copyright 2016 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 MEDIA_REMOTING_REMOTING_RENDERER_CONTROLLER_H_
 #define MEDIA_REMOTING_REMOTING_RENDERER_CONTROLLER_H_
 
 #include "base/callback.h"
 #include "base/memory/weak_ptr.h"
+#include "base/optional.h"
 #include "media/base/media_observer.h"
 #include "media/remoting/remoting_interstitial_ui.h"
 #include "media/remoting/remoting_source_impl.h"
+#include "third_party/skia/include/core/SkBitmap.h"
 
 namespace media {
 
 namespace remoting {
 class RpcBroker;
 }
 
 // This class:
 // 1) Implements the RemotingSourceImpl::Client;
 // 2) Monitors player events as a MediaObserver;
@@ skipping 12 matching lines @@
 
   // MediaObserver implementations.
   void OnEnteredFullscreen() override;
   void OnExitedFullscreen() override;
   void OnBecameDominantVisibleContent(bool is_dominant) override;
   void OnSetCdm(CdmContext* cdm_context) override;
   void OnMetadataChanged(const PipelineMetadata& metadata) override;
   void OnRemotePlaybackDisabled(bool disabled) override;
   void OnPlaying() override;
   void OnPaused() override;
+  void OnSetPoster(const GURL& poster) override;
 
   void SetSwitchRendererCallback(const base::Closure& cb);
   void SetRemoteSinkAvailableChangedCallback(
       const base::Callback<void(bool)>& cb);
 
-  using ShowInterstitialCallback = base::Callback<
-      void(const SkBitmap&, const gfx::Size&, RemotingInterstitialType type)>;
+  using ShowInterstitialCallback =
+      base::Callback<void(const base::Optional<SkBitmap>&,
+                          const gfx::Size&,
+                          RemotingInterstitialType type)>;
   // Called by RemoteRendererImpl constructor to set the callback to draw and
   // show remoting interstial.
   void SetShowInterstitialCallback(const ShowInterstitialCallback& cb);
+  using DownloadPosterCallback =
+      base::Callback<void(const GURL&,
+                          const base::Callback<void(const SkBitmap&)>&)>;
+  // Set the callback to download poster image.
+  void SetDownloadPosterCallback(const DownloadPosterCallback& cb);
 
   base::WeakPtr<RemotingRendererController> GetWeakPtr() {
     return weak_factory_.GetWeakPtr();
   }
 
   // Used by RemotingRendererFactory to query whether to create Media Remoting
   // Renderer.
   bool remote_rendering_started() const {
     DCHECK(thread_checker_.CalledOnValidThread());
     return remote_rendering_started_;
@@ skipping 27 matching lines @@
   bool IsAudioCodecSupported();
   bool IsRemoteSinkAvailable();
 
   // Helper to decide whether to enter or leave Remoting mode.
   bool ShouldBeRemoting();
 
   // Determines whether to enter or leave Remoting mode and switches if
   // necessary.
   void UpdateAndMaybeSwitch();
 
-  // Called when any of the following happens:
-  // 1. SetShowInterstitialCallback() is called (RemoteRendererImpl is
-  //    constructed);
+  // Called to download the poster image. Called when:
+  // 1. Poster URL changes.
+  // 2. ShowInterstitialCallback is set.
+  // 3. DownloadPosterCallback is set.
+  void DownloadPosterImage();
+
+  // Called when poster image is downloaded.
+  void OnPosterImageDownloaded(const GURL& download_url, const SkBitmap& image);
+
+  // Update remoting interstitial with |image|. When |image| is not set,
+  // interstitial will be drawn on previously downloaded poster image (in
+  // RemoteRendererImpl) or black background if none was downloaded before.
+  // Call this when:
+  // 1. SetShowInterstitialCallback() is called (RemoteRendererImpl is created).
   // 2. The remoting session is shut down (to update the status message in the
   //    interstitial).
   // 3. The size of the canvas is changed (to update the background image and
   //    the position of the status message).
-  // TODO(xjz): Call this when poster url is set/changed. Download poster image
-  // when available, and draw interstitial on it.
-  void UpdateInterstitial();
+  // 4. Poster image is downloaded (to update the background image).
+  void UpdateInterstitial(const base::Optional<SkBitmap>& image);
 
-  // Indicates whether this media element or its ancestor is in full screen.
+  // Indicates whether this media element is in full screen.
   bool is_fullscreen_ = false;
 
   // Indicates whether remoting is started.
   bool remote_rendering_started_ = false;
 
   // Indicates whether audio or video is encrypted.
   bool is_encrypted_ = false;
 
   // Indicates whether remote playback is currently disabled. This starts out as
   // true, and should be updated at least once via a call to
@@ skipping 17 matching lines @@
   base::Callback<void(bool)> sink_available_changed_cb_;
 
   // This is initially the RemotingSourceImpl passed to the ctor, and might be
   // replaced with a different instance later if OnSetCdm() is called.
   scoped_refptr<RemotingSourceImpl> remoting_source_;
 
   // This is used to check all the methods are called on the current thread in
   // debug builds.
   base::ThreadChecker thread_checker_;
 
+  // Current pipeline metadata.
   PipelineMetadata pipeline_metadata_;
 
   // The callback to show remoting interstitial. It is set when entering the
   // remoting mode (RemotingRendererImpl is constructed) by calling
   // SetShowInterstitialCallback(), and is reset when leaving the remoting mode.
   ShowInterstitialCallback show_interstitial_cb_;
 
+  // Current poster URL, whose image will feed into the local UI.
+  GURL poster_url_;
+
+  // The callback to download the poster image. Called when |poster_url_|
+  // changes during a remoting session or the show interstial callback is set.
+  // OnPosterImageDownloaded() will be called when download completes.
+  DownloadPosterCallback download_poster_cb_;
+
   base::WeakPtrFactory<RemotingRendererController> weak_factory_;
 
   DISALLOW_COPY_AND_ASSIGN(RemotingRendererController);
 };
 
 }  // namespace media
 
 #endif  // MEDIA_REMOTING_REMOTING_RENDERER_CONTROLLER_H_