[PresentationAPI] Implementing start/joinSession from WebPresentationClient to PresentationService.

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;
 
+import "presentation_session.mojom";
+
+struct PresentationSessionInfo {
+    PresentationSession session;
+    string url;
+    string id;
+};
+
+struct PresentationError {
+    int32 errorCode;

[mlamouri (slow - plz ping), 2015/02/23 14:07:39]

Could you have an enum called PresentationErroryType so the error codes actually
mean something and we can translate them and send them to Blink?

[whywhat, 2015/02/25 14:12:41]

Done.

+    string message;
+};
+
 interface PresentationService {
     // Returns the last screen availability state if it’s changed since the last
     // time the method was called. The client has to call this method again when
     // handling the result (provided via Mojo callback) to get the next update
     // about the availability status.
     // May start discovery of the presentation screens. The implementation might
     // stop discovery once there are no active calls to GetScreenAvailability.
     // |presentation_url| can be specified to help the implementation to filter
     // out incompatible screens.
     GetScreenAvailability(string? presentation_url) => (bool available);
 
     // Called when the frame no longer listens to the
     // |availablechange| event.
     OnScreenAvailabilityListenerRemoved();
+
+    // Called when startSession() is called by the frame. The result callback
+    // will return a non-null PresentationSessionInfo if starting the session
+    // succeeded (so the session object is valid) or an error message if
+    // starting the session failed.
+    // The presentation id is always returned along with the initialized
+    // session on success.
+    // If the UA identifies a matching session (same presentation url and id),
+    // the user may choose this existing session and the page will join it
+    // rather than get a new one. An empty presentation id means that the
+    // UA will generate the presentation id.
+    StartSession(string presentation_url, string? presentation_id) => (
+            PresentationSessionInfo? sessionInfo, PresentationError? error);

[mlamouri (slow - plz ping), 2015/02/23 14:07:39]

nit: this looks more readable:
StartSession(string presentation_url, string? presentation_id)
  => (PresentationSessionInfo? sessionInfo, PresentationError? error);

This is also the style used in the permission service.

[whywhat, 2015/02/25 14:12:41]

Done.

+
+    // Called when joinSession() is called by the frame. The result callback
+    // works the same as for the method above. JoinSession is used to silently
+    // (no user action needed) join a known session (i.e. when the page
+    // navigates or the user opens another tab).
+    JoinSession(string presentation_url, string? presentation_id) => (
+            PresentationSessionInfo? sessionInfo, PresentationError? error);

[mlamouri (slow - plz ping), 2015/02/23 14:07:39]

ditto

[whywhat, 2015/02/25 14:12:41]

Done.

 };