Implement pepper interface and plumbing for HRD's UI on ChromeOS

ppapi/api/private/ppb_talk_private.idl

 /* Copyright (c) 2012 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.
  */
 
 /**
- * This file contains the <code>PPB_Talk</code> interface.
+ * This file contains the <code>PPB_Talk_Private</code> interface.
  */
 label Chrome {
-  M19 = 1.0
+  M19 = 1.0,
+  M29 = 2.0
 };
 
 /**
+ * The type of permissions that can be requested to the user.
+ */
+[assert_size(4)]
+enum PP_TalkPermission {
+  /**
+   * Request permission for screencast.
+   */
+  PP_TALKPERMISSION_SCREENCAST = 0,
+  /**
+   * Request permission for Remote Desktop.
+   */
+  PP_TALKPERMISSION_REMOTING = 1,
+  /**
+   * Request permission for continuing Remote Desktop.
+   */
+  PP_TALKPERMISSION_REMOTING_CONTINUE = 2
+};
+
+/**
+ * Talk event types reported by the browser.
+ */
+[assert_size(4)]
+enum PP_TalkEvent {
+  /**
+   * Indicates that the user took action to terminate the remoting session.
+   */
+  PP_TALKEVENT_TERMINATE = 0,
+  /**
+   * Indicates that an error occurred (e.g. failed to show the UI).
+   */
+  PP_TALKEVENT_ERROR = 1
+};
+
+/**
+ * Callback for Talk events.
+ */
+typedef void PP_TalkEventCallback([inout] mem_t user_data,
+                                  [in] PP_TalkEvent event);
+
+/**
  * Extra interface for Talk.
  */
 interface PPB_Talk_Private {
   /**
    * Creates a Talk_Private resource.
    */
+  [version=1.0]
   PP_Resource Create(PP_Instance instance);
 
   /**
-   * Displays security UI.
+   * Displays confirmation dialog for screencasting.
    *
    * The callback will be issued with 1 as the result if the user gave
    * permission, or 0 if the user denied.
    *
    * You can only have one call pending. It will return PP_OK_COMPLETIONPENDING
    * if the request is queued, or PP_ERROR_INPROGRESS if there is already a
    * request in progress.
+   *
+   * (Deprecated in 2.0. Please us RequestPermission instead.)
+   */
+  [version=1.0, deprecate=2.0]
+  int32_t GetPermission(
+      [in] PP_Resource talk_resource,
+      [in] PP_CompletionCallback callback);
+
+  /**
+   * Requests permission to the user using a system modal dialog.

[Josh Horwich, 2013/06/04 19:48:37]

I believe it's clearer to say "Requests permission from the user" because this
is asking for something from them, not to them.

Same comment for line 84.

[dcaiafa, 2013/06/04 22:38:15]

Done.

+   *
+   * <code>permission</code> specifies the type of permission to request to the
+   * user.
+   *
+   * The callback will be issued with 1 as the result if the user gave
+   * permission, or 0 if the user denied.
+   *
+   * You can only have one call pending. It will return PP_OK_COMPLETIONPENDING
+   * if the request is queued, or PP_ERROR_INPROGRESS if there is already a
+   * request in progress.
    */
-  int32_t GetPermission(
+  [version=2.0]
+  int32_t RequestPermission(
       [in] PP_Resource talk_resource,
+      [in] PP_TalkPermission permission,
       [in] PP_CompletionCallback callback);
+
+  /**
+   * Shows the remoting-in-progress UI and registers a callback for events.
+   * This function executes synchronously. Returns PP_OK if there were no
+   * errors.
+   *
+   * This must be called on the pepper main thread. Similarly, |event_callback|
+   * will be called on the pepper main thread.
+   */
+  [version=2.0]
+  int32_t StartRemoting(
+      [in] PP_Resource talk_resource,
+      [in] PP_TalkEventCallback event_callback,
+      [inout] mem_t user_data);
+
+  /**
+   * Hides the remoting-in-progress UI and unregisters the event callback.
+   *
+   * This must be called on the pepper main thread. Any pending notifications
+   * will be discarded.
+   */
+  [version=2.0]
+  void StopRemoting(
+      [in] PP_Resource talk_resource);
 };