[Presentation API] (5th) (1-UA) integrate controller and receiver side for 1-UA messaging

third_party/WebKit/public/platform/modules/presentation/presentation.mojom

 // 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.
 
 // TODO(crbug.com/647290): Rename "Session" to "Connection"
 
 module blink.mojom;
 
 import "url/mojo/url.mojom";
 
@@ skipping 117 matching lines @@
   Terminate(url.mojom.Url presentation_url, string presentation_id);
 
   // Starts listening for messages for session with |sessionInfo|.
   // Messages will be received in
   // PresentationServiceClient::OnSessionMessagesReceived.
   // This is called after a presentation session is created.
   ListenForSessionMessages(PresentationSessionInfo sessionInfo);
 };
 
 interface PresentationServiceClient {
+
+  ////////////Functions here are called only on the controlling page.///////////
+
   // Called when the client tries to listen for screen availability changes for
   // presentation of |url| but it is not supported by the device or underlying
   // platform. This can also be called if the device is currently in a mode
   // where it can't do screen discoveries (eg. low battery).
   OnScreenAvailabilityNotSupported(url.mojom.Url url);
 
   // Called when the client is listening for screen availability for
   // presentation of |url| and the state changes. When the client starts to
   // listen for screen availability, this method will always be called to give
   // the current known state. It will then be called to notify of state updates.
   OnScreenAvailabilityUpdated(url.mojom.Url url, bool available);
 
+  // See PresentationService::SetDefaultPresentationURL.
+  OnDefaultSessionStarted(PresentationSessionInfo sessionInfo);
+
+  //////////////////////////////////////////////////////////////////////////////
+
   // Called when the state of PresentationConnection |connection| started on
   // this frame has changed to |newState|.
   OnConnectionStateChanged(PresentationSessionInfo connection,
                            PresentationConnectionState newState);
 
   // Caled when the state of |connection| started on this frame has changed to
   // CLOSED.
   OnConnectionClosed(PresentationSessionInfo connection,
                      PresentationConnectionCloseReason reason,
                      string message);
 
   // See PresentationService::ListenForSessionMessages.
   OnSessionMessagesReceived(PresentationSessionInfo sessionInfo,
                             array<SessionMessage> messages);
 
-  // See PresentationService::SetDefaultPresentationURL.
-  OnDefaultSessionStarted(PresentationSessionInfo sessionInfo);
-
-  // See PresentationService::ListeningForReceiverPageRendered.
-  OnReceiverConnectionAvailable(PresentationSessionInfo sessionInfo);
+  // Called on a presentation receiver when the first presentation connection is
+  // available from the controlling page.
+  OnReceiverConnectionAvailable(PresentationSessionInfo sessionInfo,
+                                PresentationConnection connection);
 };