Update Pepper interface for EME

ppapi/api/private/ppp_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>PPP_ContentDecryptor_Private</code>
  * interface. Note: This is a special interface, only to be used for Content
  * Decryption Modules, not normal plugins.
  */
@@ skipping 13 matching lines @@
    * Initialize for the specified key system.
    *
    * @param[in] key_system A <code>PP_Var</code> of type
    * <code>PP_VARTYPE_STRING</code> containing the name of the key system.
    */
   void Initialize(
       [in] PP_Instance instance,
       [in] PP_Var key_system);
 
   /**
+   * Provides a server certificate to be used to encrypt messages to the
+   * license server.
+   *
+   * @param[in] promise_id A reference for the promise that gets resolved or
+   * rejected depending upon the success or failure of setting the certificate.
+   *
+   * @param[in] server_certificate A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_ARRAYBUFFER</code> containing the certificate to be used.

[palmer, 2014/08/26 19:09:21]

What format is the certificate in?

[jrummell, 2014/08/29 22:35:35]

The EME spec states "The contents of serverCertificate are Key System-specific."
Widevine uses a proprietary protobuf-based format.

+   */
+  void SetServerCertificate(
+      [in] PP_Instance instance,
+      [in] uint32_t promise_id,
+      [in] PP_Var server_certificate);
+
+  /**
    * Creates a session. <code>init_data_type</code> contains the MIME type of
    * <code>init_data</code>. <code>init_data</code> is a data buffer
    * containing data for use in generating the request.
    *
    * Note: <code>CreateSession()</code> must create a web session ID and provide
    * it to the browser via <code>SessionCreated()</code> on the
    * <code>PPB_ContentDecryptor_Private</code> interface.
    *
    * @param[in] promise_id A reference for the promise that gets resolved or
    * rejected depending upon the success or failure when creating the session.
@@ skipping 57 matching lines @@
    * <code>PP_VARTYPE_ARRAYBUFFER</code> containing the license or other
    * message for the given session ID.
    */
   void UpdateSession(
       [in] PP_Instance instance,
       [in] uint32_t promise_id,
       [in] PP_Var web_session_id,
       [in] PP_Var response);
 
   /**
-   * Release the specified session and related resources.
+   * Close the specified session and related resources.
    *
    * @param[in] promise_id A reference for the promise that gets resolved or
-   * rejected depending upon the success or failure of releasing the session.
+   * rejected depending upon the success or failure of closing the session.
    *
    * @param[in] web_session_id A <code>PP_Var</code> of type
    * <code>PP_VARTYPE_STRING</code> containing the web session ID of the session
-   * to be released.
+   * to be closed.
    *
    */
-  void ReleaseSession(
+  void CloseSession(
       [in] PP_Instance instance,
       [in] uint32_t promise_id,
       [in] PP_Var web_session_id);
+
+  /**
+   * Remove stored data associated with this session.
+   *
+   * @param[in] promise_id A reference for the promise that gets resolved or
+   * rejected depending upon the success or failure of removing the session
+   * data.
+   *
+   * @param[in] web_session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the web session ID of the session
+   * to be removed.
+   *
+   */
+  void RemoveSession(
+      [in] PP_Instance instance,
+      [in] uint32_t promise_id,
+      [in] PP_Var web_session_id);
+
+  /**
+   * Get the key IDs for keys in the session that the CDM knows are currently
+   * usable to decrypt media data.
+   *
+   * @param[in] promise_id A reference for the promise that gets resolved or
+   * rejected depending upon the success or failure of obtaining the key IDs.
+   *
+   * @param[in] web_session_id A <code>PP_Var</code> of type
+   * <code>PP_VARTYPE_STRING</code> containing the web session ID of the session
+   * to be queried.
+   *
+   */
+  void GetUsableKeyIds(
+      [in] PP_Instance instance,
+      [in] uint32_t promise_id,
+      [in] PP_Var web_session_id);
 
   /**
    * Decrypts the block and returns the unencrypted block via
    * <code>DeliverBlock()</code> on the
    * <code>PPB_ContentDecryptor_Private</code> interface. The returned block
    * contains encoded data.
    *
    * @param[in] resource A <code>PP_Resource</code> corresponding to a
    * <code>PPB_Buffer_Dev</code> resource that contains an encrypted data
    * block.
@@ skipping 113 matching lines @@
    * @param[in] encrypted_block_info A <code>PP_EncryptedBlockInfo</code> that
    * contains all auxiliary information needed for decryption of the
    * <code>encrypted_block</code>.
    */
   void DecryptAndDecode(
       [in] PP_Instance instance,
       [in] PP_DecryptorStreamType decoder_type,
       [in] PP_Resource encrypted_buffer,
       [in] PP_EncryptedBlockInfo encrypted_block_info);
 };