| OLD | NEW |
| 1 /* Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 /* Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| 2 * Use of this source code is governed by a BSD-style license that can be | 2 * Use of this source code is governed by a BSD-style license that can be |
| 3 * found in the LICENSE file. | 3 * found in the LICENSE file. |
| 4 */ | 4 */ |
| 5 | 5 |
| 6 /** | 6 /** |
| 7 * This file defines the <code>PPP_ContentDecryptor_Private</code> | 7 * This file defines the <code>PPP_ContentDecryptor_Private</code> |
| 8 * interface. Note: This is a special interface, only to be used for Content | 8 * interface. Note: This is a special interface, only to be used for Content |
| 9 * Decryption Modules, not normal plugins. | 9 * Decryption Modules, not normal plugins. |
| 10 */ | 10 */ |
| 11 label Chrome { | 11 label Chrome { |
| 12 M36 = 0.12 | 12 M41 = 0.13 |
| 13 }; | 13 }; |
| 14 | 14 |
| 15 /** | 15 /** |
| 16 * <code>PPP_ContentDecryptor_Private</code> structure contains the function | 16 * <code>PPP_ContentDecryptor_Private</code> structure contains the function |
| 17 * pointers the decryption plugin must implement to provide services needed by | 17 * pointers the decryption plugin must implement to provide services needed by |
| 18 * the browser. This interface provides the plugin side support for the Content | 18 * the browser. This interface provides the plugin side support for the Content |
| 19 * Decryption Module (CDM) for Encrypted Media Extensions: | 19 * Decryption Module (CDM) for Encrypted Media Extensions: |
| 20 * http://www.w3.org/TR/encrypted-media/ | 20 * http://www.w3.org/TR/encrypted-media/ |
| 21 */ | 21 */ |
| 22 interface PPP_ContentDecryptor_Private { | 22 interface PPP_ContentDecryptor_Private { |
| (...skipping 16 matching lines...) Expand all Loading... |
| 39 * | 39 * |
| 40 * @param[in] server_certificate A <code>PP_Var</code> of type | 40 * @param[in] server_certificate A <code>PP_Var</code> of type |
| 41 * <code>PP_VARTYPE_ARRAYBUFFER</code> containing the certificate to be used. | 41 * <code>PP_VARTYPE_ARRAYBUFFER</code> containing the certificate to be used. |
| 42 */ | 42 */ |
| 43 void SetServerCertificate( | 43 void SetServerCertificate( |
| 44 [in] PP_Instance instance, | 44 [in] PP_Instance instance, |
| 45 [in] uint32_t promise_id, | 45 [in] uint32_t promise_id, |
| 46 [in] PP_Var server_certificate); | 46 [in] PP_Var server_certificate); |
| 47 | 47 |
| 48 /** | 48 /** |
| 49 * Creates a session. <code>init_data_type</code> contains the MIME type of | 49 * Creates a session and subsequently generates a request for a license. |
| 50 * <code>init_data_type</code> contains the MIME type of |
| 50 * <code>init_data</code>. <code>init_data</code> is a data buffer | 51 * <code>init_data</code>. <code>init_data</code> is a data buffer |
| 51 * containing data for use in generating the request. | 52 * containing data for use in generating the request. |
| 52 * | 53 * |
| 53 * Note: <code>CreateSession()</code> must create a web session ID and provide | 54 * Note: <code>CreateSessionAndGenerateRequest()</code> must create a web |
| 54 * it to the browser via <code>SessionCreated()</code> on the | 55 * session ID and provide it to the browser via <code>SessionCreated()</code> |
| 55 * <code>PPB_ContentDecryptor_Private</code> interface. | 56 * on the <code>PPB_ContentDecryptor_Private</code> interface. |
| 56 * | 57 * |
| 57 * @param[in] promise_id A reference for the promise that gets resolved or | 58 * @param[in] promise_id A reference for the promise that gets resolved or |
| 58 * rejected depending upon the success or failure when creating the session. | 59 * rejected depending upon the success or failure when creating the session. |
| 59 * | 60 * |
| 61 * @param[in] session_type A <code>PP_SessionType</code> that indicates the |
| 62 * type of session to be created. |
| 63 * |
| 60 * @param[in] init_data_type A <code>PP_Var</code> of type | 64 * @param[in] init_data_type A <code>PP_Var</code> of type |
| 61 * <code>PP_VARTYPE_STRING</code> containing the MIME type for init_data. | 65 * <code>PP_VARTYPE_STRING</code> containing the MIME type for init_data. |
| 62 * | 66 * |
| 63 * @param[in] init_data A <code>PP_Var</code> of type | 67 * @param[in] init_data A <code>PP_Var</code> of type |
| 64 * <code>PP_VARTYPE_ARRAYBUFFER</code> containing container specific | 68 * <code>PP_VARTYPE_ARRAYBUFFER</code> containing container specific |
| 65 * initialization data. | 69 * initialization data. |
| 66 * | |
| 67 * @param[in] session_type A <code>PP_SessionType</code> that indicates the | |
| 68 * type of session to be created. | |
| 69 */ | 70 */ |
| 70 void CreateSession( | 71 void CreateSessionAndGenerateRequest( |
| 71 [in] PP_Instance instance, | 72 [in] PP_Instance instance, |
| 72 [in] uint32_t promise_id, | 73 [in] uint32_t promise_id, |
| 74 [in] PP_SessionType session_type, |
| 73 [in] PP_Var init_data_type, | 75 [in] PP_Var init_data_type, |
| 74 [in] PP_Var init_data, | 76 [in] PP_Var init_data); |
| 75 [in] PP_SessionType session_type); | |
| 76 | 77 |
| 77 /** | 78 /** |
| 78 * Loads a session whose web session ID is <code>web_session_id</code>. | 79 * Loads a session whose web session ID is <code>web_session_id</code>. |
| 79 * | 80 * |
| 80 * Note: After the session is successfully loaded, the CDM must call | 81 * Note: After the session is successfully loaded, the CDM must call |
| 81 * <code>SessionCreated()</code> with <code>web_session_id</code> on the | 82 * <code>SessionCreated()</code> with <code>web_session_id</code> on the |
| 82 * <code>PPB_ContentDecryptor_Private</code> interface. | 83 * <code>PPB_ContentDecryptor_Private</code> interface. |
| 83 * | 84 * |
| 84 * @param[in] promise_id A reference for the promise that gets resolved or | 85 * @param[in] promise_id A reference for the promise that gets resolved or |
| 85 * rejected depending upon the success or failure of loading the session. | 86 * rejected depending upon the success or failure of loading the session. |
| 86 * | 87 * |
| 88 * @param[in] session_type A <code>PP_SessionType</code> that indicates the |
| 89 * type of session to be loaded. |
| 90 * |
| 87 * @param[in] web_session_id A <code>PP_Var</code> of type | 91 * @param[in] web_session_id A <code>PP_Var</code> of type |
| 88 * <code>PP_VARTYPE_STRING</code> containing the web session ID of the session | 92 * <code>PP_VARTYPE_STRING</code> containing the web session ID of the session |
| 89 * to load. | 93 * to load. |
| 90 */ | 94 */ |
| 91 void LoadSession( | 95 void LoadSession( |
| 92 [in] PP_Instance instance, | 96 [in] PP_Instance instance, |
| 93 [in] uint32_t promise_id, | 97 [in] uint32_t promise_id, |
| 98 [in] PP_SessionType session_type, |
| 94 [in] PP_Var web_session_id); | 99 [in] PP_Var web_session_id); |
| 95 | 100 |
| 96 /** | 101 /** |
| 97 * Provides a license or other message to the decryptor. | 102 * Provides a license or other message to the decryptor. |
| 98 * | 103 * |
| 99 * When the CDM needs more information, it must call | 104 * When the CDM needs more information, it must call |
| 100 * <code>SessionMessage()</code> on the | 105 * <code>SessionMessage()</code> on the |
| 101 * <code>PPB_ContentDecryptor_Private</code> interface, and the browser | 106 * <code>PPB_ContentDecryptor_Private</code> interface, and the browser |
| 102 * must notify the web application. When the CDM has finished processing | 107 * must notify the web application. When the CDM has finished processing |
| 103 * <code>response</code> and needs no more information, it must call | 108 * <code>response</code> and needs no more information, it must call |
| (...skipping 45 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 149 * <code>PP_VARTYPE_STRING</code> containing the web session ID of the session | 154 * <code>PP_VARTYPE_STRING</code> containing the web session ID of the session |
| 150 * to be removed. | 155 * to be removed. |
| 151 * | 156 * |
| 152 */ | 157 */ |
| 153 void RemoveSession( | 158 void RemoveSession( |
| 154 [in] PP_Instance instance, | 159 [in] PP_Instance instance, |
| 155 [in] uint32_t promise_id, | 160 [in] uint32_t promise_id, |
| 156 [in] PP_Var web_session_id); | 161 [in] PP_Var web_session_id); |
| 157 | 162 |
| 158 /** | 163 /** |
| 159 * Get the key IDs for keys in the session that the CDM knows are currently | |
| 160 * usable to decrypt media data. | |
| 161 * | |
| 162 * @param[in] promise_id A reference for the promise that gets resolved or | |
| 163 * rejected depending upon the success or failure of obtaining the key IDs. | |
| 164 * | |
| 165 * @param[in] web_session_id A <code>PP_Var</code> of type | |
| 166 * <code>PP_VARTYPE_STRING</code> containing the web session ID of the session | |
| 167 * to be queried. | |
| 168 * | |
| 169 */ | |
| 170 void GetUsableKeyIds( | |
| 171 [in] PP_Instance instance, | |
| 172 [in] uint32_t promise_id, | |
| 173 [in] PP_Var web_session_id); | |
| 174 | |
| 175 /** | |
| 176 * Decrypts the block and returns the unencrypted block via | 164 * Decrypts the block and returns the unencrypted block via |
| 177 * <code>DeliverBlock()</code> on the | 165 * <code>DeliverBlock()</code> on the |
| 178 * <code>PPB_ContentDecryptor_Private</code> interface. The returned block | 166 * <code>PPB_ContentDecryptor_Private</code> interface. The returned block |
| 179 * contains encoded data. | 167 * contains encoded data. |
| 180 * | 168 * |
| 181 * @param[in] resource A <code>PP_Resource</code> corresponding to a | 169 * @param[in] resource A <code>PP_Resource</code> corresponding to a |
| 182 * <code>PPB_Buffer_Dev</code> resource that contains an encrypted data | 170 * <code>PPB_Buffer_Dev</code> resource that contains an encrypted data |
| 183 * block. | 171 * block. |
| 184 * | 172 * |
| 185 * @param[in] encrypted_block_info A <code>PP_EncryptedBlockInfo</code> that | 173 * @param[in] encrypted_block_info A <code>PP_EncryptedBlockInfo</code> that |
| (...skipping 111 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 297 * @param[in] encrypted_block_info A <code>PP_EncryptedBlockInfo</code> that | 285 * @param[in] encrypted_block_info A <code>PP_EncryptedBlockInfo</code> that |
| 298 * contains all auxiliary information needed for decryption of the | 286 * contains all auxiliary information needed for decryption of the |
| 299 * <code>encrypted_block</code>. | 287 * <code>encrypted_block</code>. |
| 300 */ | 288 */ |
| 301 void DecryptAndDecode( | 289 void DecryptAndDecode( |
| 302 [in] PP_Instance instance, | 290 [in] PP_Instance instance, |
| 303 [in] PP_DecryptorStreamType decoder_type, | 291 [in] PP_DecryptorStreamType decoder_type, |
| 304 [in] PP_Resource encrypted_buffer, | 292 [in] PP_Resource encrypted_buffer, |
| 305 [in] PP_EncryptedBlockInfo encrypted_block_info); | 293 [in] PP_EncryptedBlockInfo encrypted_block_info); |
| 306 }; | 294 }; |
| OLD | NEW |