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

chrome/browser/media/router/create_presentation_session_request.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_MEDIA_ROUTER_CREATE_PRESENTATION_SESSION_REQUEST_H_
 #define CHROME_BROWSER_MEDIA_ROUTER_CREATE_PRESENTATION_SESSION_REQUEST_H_
 
 #include <string>
 
 #include "chrome/browser/media/router/media_route.h"
@@ skipping 11 matching lines @@
 // Holds parameters for creating a presentation session.
 // A request object is created by presentation_service_delegate_impl when it
 // gets create-session request. The object is then passed to and owned by the
 // MediaRouterUI. |success_cb| will be invoked when create-session
 // succeeds, or |error_cb| will be invoked when create-session fails or
 // the UI closes.
 class CreatePresentationSessionRequest {
  public:
   using PresentationSessionSuccessCallback =
       base::Callback<void(const content::PresentationSessionInfo&,
-                          const MediaRoute::Id&)>;
+                          const MediaRoute::Id&,
+                          bool)>;
   using PresentationSessionErrorCallback =
       content::PresentationServiceDelegate::PresentationSessionErrorCallback;
 
   // |presentation_url|: The presentation URL of the request. Must be a valid
   //                     URL.
   // |frame_url|: The URL of the frame that initiated the presentation request.
   // |success_cb|: Callback to invoke when the request succeeds. Must be valid.
   // |erorr_cb|: Callback to invoke when the request fails. Must be valid.
   CreatePresentationSessionRequest(
       const std::string& presentation_url,
       const GURL& frame_url,
       const PresentationSessionSuccessCallback& success_cb,
       const PresentationSessionErrorCallback& error_cb);
   ~CreatePresentationSessionRequest();
 
   const MediaSource& media_source() const { return media_source_; }
   const GURL& frame_url() const { return frame_url_; }
 
   // Invokes |success_cb_| or |error_cb_| with the given arguments.
   // These functions can only be invoked once per instance. It is an error
   // to invoke these functions more than once.
   void InvokeSuccessCallback(const std::string& presentation_id,
-                             const MediaRoute::Id& route_id);
+                             const MediaRoute::Id& route_id,
+                             bool is_one_ua_presentation);

[mark a. foltz, 2015/09/11 23:24:20]

ISTM the "is_one_ua_presentation" is a flag that could be attached to the
MediaRoute for the presentation, instead of plumbing it through here.

Naming: is_offscreen_presentation

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

+1

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

+1 too, due to the fact that this bool argument is viral across dozens of files.
 ;-)

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

Done.

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

Done.

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

Done.

   void InvokeErrorCallback(const content::PresentationError& error);
 
   // Handle route creation/joining response by invoking the right callback.
   static void HandleRouteResponse(
       scoped_ptr<CreatePresentationSessionRequest> presentation_request,
       const MediaRoute* route,
       const std::string& presentation_id,
-      const std::string& error);
+      const std::string& error,
+      bool is_one_ua_presentation);
 
  private:
   const MediaSource media_source_;
   const GURL frame_url_;
   PresentationSessionSuccessCallback success_cb_;
   PresentationSessionErrorCallback error_cb_;
   bool cb_invoked_;
 
   DISALLOW_COPY_AND_ASSIGN(CreatePresentationSessionRequest);
 };
 
 }  // namespace media_router
 
 #endif  // CHROME_BROWSER_MEDIA_ROUTER_CREATE_PRESENTATION_SESSION_REQUEST_H_