[PresentationSevice] Use PresentationConnection to send messages from

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.
 
 module blink.mojom;
 
 import "url/mojo/url.mojom";
 
 struct PresentationInfo {
   url.mojom.Url url;
@@ skipping 80 matching lines @@
   // presentation failed.
   StartPresentation(array<url.mojom.Url> presentation_urls)
       => (PresentationInfo? presentation_info, PresentationError? error);
 
   // Called when reconnect() is called by the frame. The result callback
   // works the same as for the method above. reconnect() will create a new
   // connection to a presentation with the matching URL and id.
   ReconnectPresentation(array<url.mojom.Url> presentation_urls, string? presentation_id)
       => (PresentationInfo? presentation_info, PresentationError? error);
 
-  // Called in StartPresentation's callback function for offscreen presentation only.
-  // It passes in controlling frame's PresentationConnection and
-  // PresentationConnectionRequest to PresentationService.
+  // Notifies the service that a PresentationConnection has been started.
+  // |controller_connection_ptr| is a handle to a PresentationConnection in
+  // the page that started the presentation (aka the "controller"). This can be
+  // used by PresentationService to send messages to the controller
+  // PresentationConnection, for example.
+  // The PresentationService should bind |receiver_connection_request| to a
+  // PresentationConnection implementation in order to receive messages and
+  // commands issued by the controller PresentationConnection.
   SetPresentationConnection(
       PresentationInfo presentation_info,
       PresentationConnection controller_connection_ptr,
       PresentationConnection& receiver_connection_request);
 
   //////////////////////////////////////////////////////////////////////////////
   // Called when close() is called by the frame.
   CloseConnection(url.mojom.Url presentation_url, string presentation_id);
 
   // Called when terminate() is called by the frame.
   Terminate(url.mojom.Url presentation_url, string presentation_id);
-
-  // Starts listening for messages on the presentation identified by |presentation_info|.
-  // Messages will be received in
-  // PresentationServiceClient::OnConnectionMessagesReceived.
-  // This is called after a connection has been established to the presentation
-  // from the frame.
-  ListenForConnectionMessages(PresentationInfo presentation_info);
 };
 
 interface PresentationServiceClient {
   //////////  This API is implemented by a controlling frame.  /////////////////
 
   // 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);
@@ skipping 22 matching lines @@
   // Called when the state of PresentationConnection |connection| started on
   // this frame has changed to |newState|.
   OnConnectionStateChanged(PresentationInfo presentation_info,
                            PresentationConnectionState newState);
 
   // Caled when the state of |presentation_info| started on this frame has changed to
   // CLOSED.
   OnConnectionClosed(PresentationInfo presentation_info,
                      PresentationConnectionCloseReason reason,
                      string message);
-
-  // See PresentationService::ListenForConnectionMessages.
-  OnConnectionMessagesReceived(PresentationInfo presentation_info,
-                               array<PresentationConnectionMessage> messages);
 };