Add PPAPI decryptor interfaces.

ppapi/api/dev/ppb_content_decryption_module_dev.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_ContentDecryptionModule_Dev</code>

[ddorwin, 2012/07/13 19:19:48]

We should probably call this ContentDecryptor or something similar to be more
consistent with the other API names.

[Tom Finegan, 2012/07/17 01:11:10]

Went with ContentDecryptor/Done.

+ * interface.
+ */
+label Chrome {
+  M22 = 0.1
+};
+
+/**
+ * <code>PPB_ContentDecryptionModule_Dev</code> structure contains the function
+ * pointers the browser may implement to support plugins implementing the

[ddorwin, 2012/07/13 19:19:48]

Why may and not MUST?

[Tom Finegan, 2012/07/17 01:11:10]

Lack of certainty at time of writing. Done. :)

+ * <code>PPP_ContentDecryptionModule_Dev</code> interface.
+ */
+interface PPB_ContentDecryptionModule_Dev {
+
+  /**
+   * A key or license is needed to decrypt media data.
+   */
+  void NeedKey(
+      [in] PP_Instance instance,
+      [in] PP_Var key_system,
+      [in] PP_Var session_id,
+      [in] PP_Resource init_data);
+
+  /**
+   * A key has been added as the result of a call to the <code>AddKey()</code>
+   * method on the <code>PPP_ContentDecryptionModule_Dev</code> interface.
+   */
+  void KeyAdded(
+      [in] PP_Instance instance,
+      [in] PP_Var key_system,
+      [in] PP_Var session_id);
+
+  /**
+   * A message or request has been generated by or for key_system. For example,
+   * a key request has been generated as the result of call to the
+   * <code>GenerateKeyRequest()</code> method on the
+   * <code>PPP_ContentDecryptionModule_Dev</code> interface, or another message
+   * must be sent in response to an <code>AddKey()</code> call.

[ddorwin, 2012/07/13 19:19:48]

Messages may also be sent at other times during a session (not necessarily in
response to AddKey()).

[Tom Finegan, 2012/07/17 01:11:10]

Added another sentence explaining that AddKey is not the only way to receive a
KeyMessage.

+   */
+  void KeyMessage(
+      [in] PP_Instance instance,
+      [in] PP_Var key_system,
+      [in] PP_Var session_id,
+      [in] PP_Resource message,

[ddorwin, 2012/07/13 19:19:48]

We should define the types of all PP_Resource variables. I can find an example
offline.

[Tom Finegan, 2012/07/17 01:11:10]

Done. I followed the doc, but aren't we going to use PPB_Buffer for all binary
buffers? In my new patch I'm using PPB_Buffer instead of the "TBD binary buffer"
noted in the doc. Should I update the doc, or should I change the patch? :)

+      [in] PP_Var default_url);
+
+  /**
+   * An error occured in a <code>PPP_ContentDecryptionModule_Dev</code> method,

[ddorwin, 2012/07/13 19:19:48]

nit: remove ','

[Tom Finegan, 2012/07/17 01:11:10]

Done.

+   * or within the plugin implementing the interface.
+   */
+  void KeyError(
+      [in] PP_Instance instance,
+      [in] PP_Var key_system,
+      [in] PP_Var session_id,
+      [in] uint16_t media_error,
+      [in] uint16_t system_error);
+
+  /**
+   * Called after the <code>Decrypt</code> method on the
+   * <code>PPP_ContentDecryptionModule_Dev</code> interface completes to
+   * deliver decrypted_block to the media stack.
+   */
+  void DeliverBlock(
+      [in] PP_Instance instance,
+      [in] PP_Resource decrypted_block,
+      [in] PP_CompletionCallback callback);
+
+  /**
+   * Called after the <code>DecryptAndDecode</code> method on the
+   * <code>PPP_ContentDecryptionModule_Dev</code> interface completes to
+   * deliver decrypted_frame to the media stack.
+   */
+  void DeliverFrame(
+      [in] PP_Instance instance,
+      [in] PP_Resource decrypted_frame,
+      [in] PP_CompletionCallback callback);
+
+  /**
+   * Called after the <code>DecryptAndDecode</code> method on the
+   * <code>PPP_ContentDecryptionModule_Dev</code> interface completes to
+   * deliver decrypted_samples to the media stack.
+   */
+  void DeliverSamples(
+      [in] PP_Instance instance,
+      [in] PP_Resource decrypted_samples,
+      [in] PP_CompletionCallback callback);
+};