[Presentation API] 1-UA presentation support + presenter APIs.

chrome/browser/extensions/api/tab_capture/offscreen_presentation.h

 // Copyright 2015 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 CHROME_BROWSER_EXTENSIONS_API_TAB_CAPTURE_OFFSCREEN_PRESENTATION_H_
 #define CHROME_BROWSER_EXTENSIONS_API_TAB_CAPTURE_OFFSCREEN_PRESENTATION_H_
 
 #include <string>
 #include <vector>
 
 #include "base/memory/scoped_vector.h"
 #include "base/time/time.h"
 #include "base/timer/timer.h"
 #include "content/public/browser/web_contents_delegate.h"
 #include "content/public/browser/web_contents_observer.h"
 #include "content/public/browser/web_contents_user_data.h"
 #include "ui/gfx/geometry/size.h"
 
 class Profile;
 
+namespace media_router {
+class OneUAPresentationRouter;
+}
+
 namespace extensions {
 
 class OffscreenPresentation;  // Forward declaration.  See below.
 
 // Creates, owns, and manages all OffscreenPresentation instances created by the
 // same extension background page.  When the extension background page's
 // WebContents is about to be destroyed, its associated
 // OffscreenPresentationsOwner and all of its OffscreenPresentation instances
 // are destroyed.
 //
@@ skipping 140 matching lines @@
 
  private:
   bool in_fullscreen_mode() const {
     return !non_fullscreen_size_.IsEmpty();
   }
 
   // Called by |capture_poll_timer_| to automatically destroy this
   // OffscreenPresentation when the capturer count returns to zero.
   void DieIfContentCaptureEnded();
 
+  // Unregisters this presentation from OneUAPresentationRouter and destroys it.
+  void Close();

[whywhat, 2015/09/14 15:20:39]

nit: the name is very out of sync from the comment - either the comment reveals
implementation details or the name has to be changed to something along the
lines of it

[miu, 2015/09/17 00:09:20]

I think it would be reasonable to name this method Destroy(), which handles
de-registering and deletes |this| before returning.  This is the approach
classes like content::RenderWidgetHostImpl take.  Ex:
https://code.google.com/p/chromium/codesearch#chromium/src/content/browser/re...

[imcheng, 2015/09/26 01:21:56]

Done.

[imcheng, 2015/09/26 01:21:57]

Done.

+
   OffscreenPresentationsOwner* const owner_;
 
   // The starting URL for this presentation, which may or may not match the
   // current WebContents URL if navigations have occurred.
   const GURL start_url_;
 
   // The presentation ID used to help uniquely identify this instance.
   const std::string presentation_id_;
 
   // A non-shared off-the-record profile based on the profile of the extension
   // background page.
   const scoped_ptr<Profile> profile_;
 
   // The WebContents containing the offscreen presentation page.
   scoped_ptr<content::WebContents> presentation_web_contents_;
 
+  media_router::OneUAPresentationRouter* const one_ua_presentation_router_;
+
   // The time at which Start() finished creating |presentation_web_contents_|.
   base::TimeTicks start_time_;
 
   // Set to the original size of the renderer just before entering fullscreen
   // mode.  When not in fullscreen mode, this is an empty size.
   gfx::Size non_fullscreen_size_;
 
   // Poll timer to monitor the capturer count on |presentation_web_contents_|.
   // When the capturer count returns to zero, this OffscreenPresentation is
   // automatically destroyed.
   // TODO(miu): Add a method to WebContentsObserver to report capturer count
   // changes and get rid of this polling-based approach.
   base::Timer capture_poll_timer_;
 
   // This is false until after the Start() method is called, and capture of the
   // |presentation_web_contents_| is first detected.
   bool content_capture_was_detected_;
 
   DISALLOW_COPY_AND_ASSIGN(OffscreenPresentation);
 };
 
 }  // namespace extensions
 
 #endif  // CHROME_BROWSER_EXTENSIONS_API_TAB_CAPTURE_OFFSCREEN_PRESENTATION_H_