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

content/common/presentation/presentation_service.mojom

Index: content/common/presentation/presentation_service.mojom
diff --git a/content/common/presentation/presentation_service.mojom b/content/common/presentation/presentation_service.mojom
index 2ff381a41cb5d2f7affb681cf2cc65dfddadd909..26374f1b64ab73893e3ba8e0bd59d4c53f3ecaa2 100644
--- a/content/common/presentation/presentation_service.mojom
+++ b/content/common/presentation/presentation_service.mojom
@@ -4,6 +4,26 @@
 
 module presentation;
 
+import "presentation_session.mojom";
+
+struct PresentationSessionInfo {
+    PresentationSession session;
+    string url;
+    string id;
+};
+
+enum PresentationErrorType {
+    NO_AVAILABLE_SCREENS,
+    SESSION_REQUEST_CANCELLED,
+    NO_PRESENTATION_FOUND,
+    UNKNOWN,
+};
+
+struct PresentationError {
+    PresentationErrorType errorType;
+    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
@@ -18,4 +38,24 @@ interface PresentationService {
     // 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

[mark a. foltz, 2015/02/26 00:13:42]

I would say:

will return a non-null and valid PresentationSessionInfo if starting the session
succeeded, or null with a PresentationError if starting the session failed.

[whywhat, 2015/02/26 16:15:07]

Done.

+    // 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);
+
+    // Called when joinSession() is called by the frame. The result callback
+    // works the same as for the method above. JoinSession is used to silently

[mark a. foltz, 2015/02/26 00:13:42]

JoinSession will join a known session (i.e. ...) silently and without user
action.

[whywhat, 2015/02/26 16:15:07]

Done.

+    // (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);
 };