[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();
 
   // 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 presenter PresentationSessionInfo object for the 1-UA
+  // presentation that was presented onto this frame.
+  // If the calling frame is not a presenter frame, null will be returned.
+  // Otherwise, a presenter PresentationSessionInfo object will be returned,
+  // with url set to empty, and id set to the Id of the 1-UA presentation.
+  GetPresenterSession() => (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);
 };