[Presentation API] (3rd) (1-UA) Split PresentationServiceDelegateImpl(PSDImpl)

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 51 matching lines @@
    SetTargetConnection(PresentationConnection connection);
 
    // Called when a message is sent by the target connection.
    OnMessage(SessionMessage message);
 };
 
 interface PresentationService {
   // Sets the PresentationServiceClient.
   SetClient(PresentationServiceClient client);
 
+  /////////////Functions here are for the controller part of the API.///////////

[mark a. foltz, 2016/11/08 23:40:52]

Nit: add spaces between / and text to improve readability.

[zhaobin, 2016/11/10 04:14:01]

Done.

+
   // Called when the frame sets or changes the default presentation URLs.
   // When the default presentation is started on this frame,
   // PresentationServiceClient::OnDefaultSessionStarted will be invoked.
   SetDefaultPresentationUrls(array<url.mojom.Url> presentation_urls);
 
   // Starts listening for screen availability for presentation of
   // |availability_url|. Availability results will be returned to the client via
   // PresentationServiceClient::OnScreenAvailabilityUpdated.
   ListenForScreenAvailability(url.mojom.Url availability_url);
 
@@ skipping 14 matching lines @@
   StartSession(array<url.mojom.Url> presentation_urls)
       => (PresentationSessionInfo? sessionInfo, PresentationError? error);
 
   // Called when joinSession() is called by the frame. The result callback
   // works the same as for the method above. JoinSession will join a known
   // session (i.e. when the page navigates or the user opens another tab)
   // silently and without user action.
   JoinSession(array<url.mojom.Url> presentation_urls, string? presentation_id)
       => (PresentationSessionInfo? sessionInfo, PresentationError? error);
 
+  // Called in StartSession's callback function for 1-UA presentations only. It

[mark a. foltz, 2016/11/08 23:40:52]

s/1-UA/offscreen/ for consistency with other documentation.

[zhaobin, 2016/11/10 04:14:01]

Done.

+  // sends controlling frame's PresentationConnection to PresentationService.
+  SetPresentationConnection(PresentationSessionInfo sessionInfo,
+                            PresentationConnection connection);
+
+  //////////////////////////////////////////////////////////////////////////////
+
   // Called when send() is called by the frame. The true in the
   // result callback notifies that the service is ready for next message.
   // The false in the result callback notifies the renderer to stop sending
   // the send requests and invalidate all pending requests. This occurs
   // for eg., when frame is deleted or navigated away.
   SendSessionMessage(PresentationSessionInfo sessionInfo,
                      SessionMessage message_request) => (bool success);
 
   // Called when close() is called by the frame.
   CloseConnection(url.mojom.Url presentation_url, string presentation_id);
@@ skipping 35 matching lines @@
   // See PresentationService::ListenForSessionMessages.
   OnSessionMessagesReceived(PresentationSessionInfo sessionInfo,
                             array<SessionMessage> messages);
 
   // See PresentationService::SetDefaultPresentationURL.
   OnDefaultSessionStarted(PresentationSessionInfo sessionInfo);
 
   // See PresentationService::ListeningForReceiverPageRendered.
   OnReceiverConnectionAvailable(PresentationSessionInfo sessionInfo);
 };