[Presentation API] (MR side) 1-UA: notify receiver page when receiver connection becomes available

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 <memory>
 #include <string>
 #include <vector>
@@ skipping 29 matching lines @@
   PresentationConnectionState state;
 
   // |close_reason| and |messsage| are only used for state change to CLOSED.
   PresentationConnectionCloseReason close_reason;
   std::string message;
 };
 
 using PresentationConnectionStateChangedCallback =
     base::Callback<void(const PresentationConnectionStateChangeInfo&)>;
 
+// This class serves as a proxy to PSImpl.
+class OffscreenPresentationClient {
+ public:
+  OffscreenPresentationClient() {}
+  // Called when 1. receiver page is rendered for a presentation;
+  //             2. new controller is connected to the presentation.
+  virtual void OnReceiverConnectionAvailable(
+      const content::PresentationSessionInfo&) = 0;
+  // For controller, add a receiver client to its observer list, and the list
+  // contains at most one element;
+  // For receiver, add a controller client to its observer list, and the list
+  // may contain multiple elements.
+  virtual void AddOffscreenPresentationObserver(
+      OffscreenPresentationClient*) = 0;
+
+  virtual void RemoveOffscreenPresentationObserver(
+      OffscreenPresentationClient*) = 0;
+
+ private:
+  DISALLOW_COPY_AND_ASSIGN(OffscreenPresentationClient);
+};
+
 // 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;
 
@@ skipping 136 matching lines @@
   // frame.
   // |render_process_id|, |render_frame_id|: ID of frame.
   // |connection|: PresentationConnection to listen for state changes.
   // |state_changed_cb|: Invoked with the PresentationConnection and its new
   // state whenever there is a state change.
   virtual void ListenForConnectionStateChange(
       int render_process_id,
       int render_frame_id,
       const PresentationSessionInfo& connection,
       const PresentationConnectionStateChangedCallback& state_changed_cb) = 0;
+
+  // Called when receiver PSImpl is connected with receiver render process.
+  virtual void RegisterOffscreenPresentationReceiver(
+      OffscreenPresentationClient*) = 0;
+
+  // Called when receiver frame is destroyed.
+  virtual void UnregisterOffscreenPresentationReceiver(
+      OffscreenPresentationClient*) = 0;
+
+  // Called when successfully starting presentation session.
+  virtual void RegisterOffscreenPresentationController(
+      const std::string& presentationId,
+      OffscreenPresentationClient*) = 0;
+
+  // Called when presentation connection is closed.
+  virtual void UnregisterOffscreenPresentationController(
+      const std::string& presentationId,
+      OffscreenPresentationClient*) = 0;
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_BROWSER_PRESENTATION_SERVICE_DELEGATE_H_