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

content/public/browser/presentation_service_delegate.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 CONTENT_PUBLIC_BROWSER_PRESENTATION_SERVICE_DELEGATE_H_
 #define CONTENT_PUBLIC_BROWSER_PRESENTATION_SERVICE_DELEGATE_H_
 
 #include <string>
 #include <vector>
 
@@ skipping 11 matching lines @@
 using SessionStateChangedCallback =
     base::Callback<void(const PresentationSessionInfo&,
                         PresentationSessionState)>;
 
 // Param #0: a vector of messages that are received.
 // Param #1: tells the callback handler that it may reuse strings or buffers
 //           in the messages contained within param #0.
 using PresentationSessionMessageCallback = base::Callback<
     void(const ScopedVector<content::PresentationSessionMessage>&, bool)>;
 
+using PresenterSessionAvailableCallback =
+    base::Callback<void(const content::PresentationSessionInfo&)>;
+
+using SendMessageCallback = base::Callback<void(bool)>;
+
 // An interface implemented by embedders to handle presentation API calls
 // forwarded from PresentationServiceImpl.
 class CONTENT_EXPORT PresentationServiceDelegate {
  public:
   // Observer interface to listen for changes to PresentationServiceDelegate.
   class CONTENT_EXPORT Observer {
    public:
     // Called when the PresentationServiceDelegate is being destroyed.
     virtual void OnDelegateDestroyed() = 0;
 
     // Called when the default presentation has been started outside of a
     // Presentation API context (e.g., browser action). This will not be called
     // if the session was created as a result of Presentation API's
     // StartSession()/JoinSession().
     virtual void OnDefaultPresentationStarted(
         const PresentationSessionInfo& session) = 0;
 
    protected:
     virtual ~Observer() {}
   };
 
   using PresentationSessionSuccessCallback =
       base::Callback<void(const PresentationSessionInfo&)>;
   using PresentationSessionErrorCallback =
       base::Callback<void(const PresentationError&)>;
-  using SendMessageCallback = base::Callback<void(bool)>;
 
   virtual ~PresentationServiceDelegate() {}
 
   // Registers an observer associated with frame with |render_process_id|
   // and |render_frame_id| with this class to listen for updates.
   // This class does not own the observer.
   // It is an error to add an observer if there is already an observer for that
   // frame.
   virtual void AddObserver(int render_process_id,
                            int render_frame_id,
@@ skipping 105 matching lines @@
                            const SendMessageCallback& send_message_cb) = 0;
 
   // Continuously listen for presentation session state changes for a frame.
   // |render_process_id|, |render_frame_id|: ID of frame.
   // |state_changed_cb|: Invoked with the session and its new state whenever
   // there is a state change.
   virtual void ListenForSessionStateChange(
       int render_process_id,
       int render_frame_id,
       const SessionStateChangedCallback& state_changed_cb) = 0;
+
+  virtual void GetPresenterSession(
+      int render_process_id,

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

BTW--Most of the methods in this interface have these two render_process_id and
render_frame_id arguments.  Is it ever possible to use this API on non-main
render frames?  If not, you may want to clarify by naming the 2nd arg
main_render_frame_id and also DCHECK()ing in the method impls.

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

It's definitely possible to use it on non main frames. Any frame can invoke the
presentation API.

+      int render_frame_id,
+      const PresenterSessionAvailableCallback& success_callback,
+      const base::Callback<void(const std::string&)>& error_callback) = 0;
+
+  virtual std::vector<content::PresentationSessionInfo> GetPresenterSessions(
+      int render_process_id,
+      int render_frame_id) = 0;
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_BROWSER_PRESENTATION_SERVICE_DELEGATE_H_