Add Promises for EME (Chromium side)

ppapi/api/private/ppb_content_decryptor_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 defines the <code>PPB_ContentDecryptor_Private</code>
  * interface. Note: This is a special interface, only to be used for Content
  * Decryption Modules, not normal plugins.
  */
 
 [generate_thunk]
 
 label Chrome {
-  M35 = 0.11
+  M36 = 0.12
 };
 
 /**
  * <code>PPB_ContentDecryptor_Private</code> structure contains the function
  * pointers the browser must implement to support plugins implementing the
  * <code>PPP_ContentDecryptor_Private</code> interface. This interface provides
  * browser side support for the Content Decryption Module (CDM) for Encrypted
  * Media Extensions: http://www.w3.org/TR/encrypted-media/
  */
 interface PPB_ContentDecryptor_Private {
   /**
-   * A session has been created by the CDM.
+   * A promise has been resolved by the CDM.
    *
-   * @param[in] session_id Identifies the session for which the CDM
-   * created a session.
+   * @param[in] promise_id Identifies the promise that the CDM resolved.
+   */
+  void PromiseResolved(
+      [in] PP_Instance instance,
+      [in] uint32_t promise_id);
+
+  /**
+   * A promise has been resolved by the CDM.
+   *
+   * @param[in] promise_id Identifies the promise that the CDM resolved.
    *
    * @param[in] web_session_id A <code>PP_Var</code> of type
-   * <code>PP_VARTYPE_STRING</code> containing the string for the
-   * MediaKeySession's sessionId attribute.
+   * <code>PP_VARTYPE_STRING</code> containing the session's ID attribute.
+   */
+  void PromiseResolvedWithSession(
+      [in] PP_Instance instance,
+      [in] uint32_t promise_id,
+      [in] PP_Var web_session_id);
+
+  /**
+   * A promise has been rejected by the CDM due to an error.
    *
+   * @param[in] promise_id Identifies the promise that the CDM rejected.
+   *
+   * @param[in] exception_code A <code>PP_CdmExceptionCode</code> containing
+   * the exception code.
+   *
+   * @param[in] system_code A system error code.
+   *
+   * @param[in] error_description A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the error description.
    */
-  void SessionCreated(
+  void PromiseRejected(
       [in] PP_Instance instance,
-      [in] uint32_t session_id,
-      [in] PP_Var web_session_id);
+      [in] uint32_t promise_id,
+      [in] PP_CdmExceptionCode exception_code,
+      [in] uint32_t system_code,
+      [in] PP_Var error_description);
 
   /**
    * A message or request has been generated for key_system in the CDM, and
    * must be sent to the web application.
    *
    * For example, when the browser invokes <code>CreateSession()</code>
    * on the <code>PPP_ContentDecryptor_Private</code> interface, the plugin
    * must send a message containing the license request.
    *
    * Note that <code>SessionMessage()</code> can be used for purposes other than
    * responses to <code>CreateSession()</code> calls. See also the text
    * in the comment for <code>SessionReady()</code>, which describes a sequence
    * of <code>UpdateSession()</code> and <code>SessionMessage()</code> calls
    * required to prepare for decryption.
    *
-   * @param[in] session_id Identifies the session for which the message
-   * is intended.
+   * @param[in] web_session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session's ID attribute for
+   * which the message is intended.
    *
    * @param[in] message A <code>PP_Var</code> of type
    * <code>PP_VARTYPE_ARRAY_BUFFER</code> that contains the message.
    *
    * @param[in] destination_url A <code>PP_Var</code> of type
    * <code>PP_VARTYPE_STRING</code> containing the destination URL for the
    * message.
    */
   void SessionMessage(
       [in] PP_Instance instance,
-      [in] uint32_t session_id,
+      [in] PP_Var web_session_id,
       [in] PP_Var message,
       [in] PP_Var destination_url);
 
   /**
    * The session is now ready to decrypt the media stream.
    *
    * Note: The above describes the most simple case. Depending on the key
    * system, a series of <code>SessionMessage()</code> calls from the CDM will
    * be sent to the browser, and then on to the web application. The web
    * application must then provide more data to the CDM by directing the browser
    * to pass the data to the CDM via calls to <code>UpdateSession()</code> on
    * the <code>PPP_ContentDecryptor_Private</code> interface.
    * The CDM must call <code>SessionReady()</code> when the sequence is
    * completed, and, in response, the browser must notify the web application.
    *
-   * @param[in] session_id Identifies the session that is ready.
+   * @param[in] web_session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session's ID attribute of
+   * the session that is now ready.
    */
   void SessionReady(
       [in] PP_Instance instance,
-      [in] uint32_t session_id);
+      [in] PP_Var web_session_id);
 
   /**
    * The session has been closed as the result of a call to the
    * <code>ReleaseSession()</code> method on the
    * <code>PPP_ContentDecryptor_Private</code> interface, or due to other
    * factors as determined by the CDM.
    *
-   * @param[in] session_id Identifies the session that is closed.
+   * @param[in] web_session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session's ID attribute of
+   * the session that is now closed.
    */
   void SessionClosed(
       [in] PP_Instance instance,
-      [in] uint32_t session_id);
+      [in] PP_Var web_session_id);
 
   /**
    * An error occurred in a <code>PPP_ContentDecryptor_Private</code> method,
    * or within the plugin implementing the interface.
    *
-   * @param[in] session_id Identifies the session for which the error
-   * is intended.
+   * @param[in] web_session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the session's ID attribute of
+   * the session that caused the error.
    *
-   * @param[in] media_error A MediaKeyError.
+   * @param[in] exception_code A <code>PP_CdmExceptionCode</code> containing
+   * the exception code.
    *
-   * @param[in] system_error A system error code.
+   * @param[in] system_code A system error code.
+   *
+   * @param[in] error_description A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the error description.
    */
   void SessionError(
       [in] PP_Instance instance,
-      [in] uint32_t session_id,
-      [in] int32_t media_error,
-      [in] uint32_t system_code);
+      [in] PP_Var web_session_id,
+      [in] PP_CdmExceptionCode exception_code,
+      [in] uint32_t system_code,
+      [in] PP_Var error_description);
 
   /**
    * Called after the <code>Decrypt()</code> method on the
    * <code>PPP_ContentDecryptor_Private</code> interface completes to
    * deliver decrypted_block to the browser for decoding and rendering.
    *
    * The plugin must not hold a reference to the encrypted buffer resource
    * provided to <code>Decrypt()</code> when it calls this method. The browser
    * will reuse the buffer in a subsequent <code>Decrypt()</code> call.
    *
@@ skipping 117 matching lines @@
    *
    * @param[in] decrypted_sample_info A <code>PP_DecryptedSampleInfo</code> that
    * contains the tracking info and result code associated with the decrypted
    * samples.
    */
   void DeliverSamples(
       [in] PP_Instance instance,
       [in] PP_Resource audio_frames,
       [in] PP_DecryptedSampleInfo decrypted_sample_info);
 };