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

content/common/presentation/presentation_service.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 presentation;
 
 struct PresentationSessionInfo {
   string url;
   string id;
 };
@@ skipping 86 matching lines @@
   // When state change occurs, PresentationServiceClient::OnSessionStateChanged
   // will be invoked with the session and its new state.
   // This is called after a presentation session is created.
   ListenForSessionStateChange(PresentationSessionInfo sessionInfo);
 
   // 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);
+
+  // Gets a single receiver PresentationSessionInfo object for the
+  // offscreen presentation hosted on the offscreen tab containing this frame.
+  // If the calling frame is not the main frame of an offscreen tab,
+  // null will be returned.

[mark a. foltz, 2015/10/12 21:56:10]

This might be simpler as,

// Returns a PresentationSessionInfo object for this frame, if it is the
// main frame of an offscreen presentation.  Otherwise returns null.

[imcheng, 2015/10/17 01:00:24]

Done.

+  // Otherwise, a PresentationSessionInfo object will be returned,
+  // with url set to empty, and id set to the ID of the offscreen presentation.

[mark a. foltz, 2015/10/12 21:56:10]

Can we look up the URL from the PresentationRequest that generated the offscreen
presentation?

[imcheng, 2015/10/17 01:00:24]

We can certainly. But I believe spec says URL is undefined for receiver
PresentationConnection objects so there is no use in including it here.

+  // If a receiver presentation session never becomes available, null will be
+  // returned right before this request becomes invalid (e.g., due to frame
+  // deletion, frame navigation).
+  GetPresentationReceiverSession() => (PresentationSessionInfo? session_info);
 };
 
 interface PresentationServiceClient {
   // 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(string 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(string url, bool available);
 
   // See PresentationService::ListenForSessionStateChange.
   OnSessionStateChanged(PresentationSessionInfo sessionInfo,
                         PresentationSessionState newState);
 
   // See PresentationService::ListenForSessionMessages.
   OnSessionMessagesReceived(PresentationSessionInfo sessionInfo, array<SessionMessage> messages);
 };