chrome.displaySource custom bindings

extensions/common/api/display_source.idl

 // 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.
 
 // The <code>chrome.displaySource</code> API creates a Display
 // session using WebMediaStreamTrack as sources.
 namespace displaySource {
   enum ErrorType {
     // Cannot create media pipeline from the given media stream which could be
     // appropriate for a Display session (e.g., necessary codecs are missing
@@ skipping 71 matching lines @@
     // Authentication information.
     AuthenticationInfo? authenticationInfo;
     // The source audio track.
     [instanceOf=MediaStreamTrack] object? audioTrack;
     // The source audio track.
     [instanceOf=MediaStreamTrack] object? videoTrack;
   };
 
   callback GetSinksCallback = void (SinkInfo[] result);
   callback RequestAuthenticationCallback = void (AuthenticationInfo result);
-  callback TerminateSessionCallback = void ();
+
+  // The callback is used by <code>startSession, terminateSession</code>
+  // to signal completion. The callback is called with
+  // <code>chrome.runtime.lastError</code> set to error
+  // message if the call has failed.
+  [inline_doc] callback CallCompleteCallback = void ();
  
   interface Functions {
     // Queries the list of the currently available Display sinks.
     //
     // |callback| : Called when the request is completed. The argument list
     // is empty if no available sinks were found.
     static void getAvailableSinks(GetSinksCallback callback);
 
     // Queries authentication data from the sink device.
     //
@@ skipping 13 matching lines @@
     // ‘getAvailableSinks’).
     //
     // The |audioTrack| or |videoTrack| must be of type MediaStreamTrack.
     // Either |audioTrack| or |videoTrack| can be null but not both. This
     // means creating a session with only audio or video.
     //
     // The |authenticationInfo| can be null if no additional authentication data
     // are required by the sink; otherwise its |data| field must contain the
     // required authentication data (e.g. PIN value) and its |method| field must
     // be the same as one obtained from ‘requestAuthentication’.
-    [nocompile] static void startSession(StartSessionInfo sessionInfo);
+    // |callback| : Called when the session is started.
+    [nocompile] static void startSession(
+        StartSessionInfo sessionInfo, optional CallCompleteCallback callback);
 
     // Terminates the active Display session.
     // |sinkId| : Id of the connected sink.
     // |callback| : Called when the session is terminated.
     [nocompile] static void terminateSession(
-        long sinkId, optional TerminateSessionCallback callback);
+        long sinkId, optional CallCompleteCallback callback);
   };
 
   interface Events {
     // Event fired when the available sinks are modified (either their amount
     // or properties)
     // |sinks| the list of all currently available sinks
     static void onSinksUpdated(SinkInfo[] sinks);
     // Event fired when the Display session is started.
     // |sinkId| Id of the peer sink
     [nocompile] static void onSessionStarted(long sinkId);
     // Event fired when the Display session is terminated.
     // |sinkId| Id of the peer sink
     [nocompile] static void onSessionTerminated(long sinkId);
     // Event fired when an error occurs.
     // |sinkId| Id of the peer sink
     // |errorInfo| error description
     [nocompile] static void onSessionErrorOccured(long sinkId,
                                                   ErrorInfo errorInfo);
   };
 };