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 3 // found in the LICENSE file. 4 5 #ifndef PPAPI_CPP_PRIVATE_CONTENT_DECRYPTOR_PRIVATE_H_ 6 #define PPAPI_CPP_PRIVATE_CONTENT_DECRYPTOR_PRIVATE_H_ 7 8 #include <string> 9 #include <vector> 10 11 #include "ppapi/c/private/pp_content_decryptor.h" 12 #include "ppapi/c/private/ppb_content_decryptor_private.h" 13 #include "ppapi/c/private/ppp_content_decryptor_private.h" 14 15 #include "ppapi/cpp/dev/buffer_dev.h" 16 #include "ppapi/cpp/instance_handle.h" 17 #include "ppapi/cpp/var.h" 18 #include "ppapi/cpp/var_array_buffer.h" 19 20 namespace pp { 21 22 class Instance; 23 24 // TODO(tomfinegan): Remove redundant pp:: usage, and pass VarArrayBuffers as 25 // const references. 26 27 class ContentDecryptor_Private { 28 public: 29 explicit ContentDecryptor_Private(Instance* instance); 30 virtual ~ContentDecryptor_Private(); 31 32 // PPP_ContentDecryptor_Private functions exposed as virtual functions 33 // for you to override. 34 // TODO(tomfinegan): This could be optimized to pass pp::Var instead of 35 // strings. The change would allow the CDM wrapper to reuse vars when 36 // replying to the browser. 37 virtual void Initialize(const std::string& key_system) = 0; 38 virtual void SetServerCertificate(uint32_t promise_id, 39 pp::VarArrayBuffer server_certificate) = 0; 40 virtual void CreateSession(uint32_t promise_id, 41 const std::string& init_data_type, 42 pp::VarArrayBuffer init_data, 43 PP_SessionType session_type) = 0; 44 virtual void LoadSession(uint32_t promise_id, 45 const std::string& web_session_id) = 0; 46 virtual void UpdateSession(uint32_t promise_id, 47 const std::string& web_session_id, 48 pp::VarArrayBuffer response) = 0; 49 virtual void CloseSession(uint32_t promise_id, 50 const std::string& web_session_id) = 0; 51 virtual void RemoveSession(uint32_t promise_id, 52 const std::string& web_session_id) = 0; 53 virtual void GetUsableKeyIds(uint32_t promise_id, 54 const std::string& web_session_id) = 0; 55 virtual void Decrypt(pp::Buffer_Dev encrypted_buffer, 56 const PP_EncryptedBlockInfo& encrypted_block_info) = 0; 57 virtual void InitializeAudioDecoder( 58 const PP_AudioDecoderConfig& decoder_config, 59 pp::Buffer_Dev extra_data_resource) = 0; 60 virtual void InitializeVideoDecoder( 61 const PP_VideoDecoderConfig& decoder_config, 62 pp::Buffer_Dev extra_data_resource) = 0; 63 virtual void DeinitializeDecoder(PP_DecryptorStreamType decoder_type, 64 uint32_t request_id) = 0; 65 virtual void ResetDecoder(PP_DecryptorStreamType decoder_type, 66 uint32_t request_id) = 0; 67 // Null |encrypted_frame| means end-of-stream buffer. 68 virtual void DecryptAndDecode( 69 PP_DecryptorStreamType decoder_type, 70 pp::Buffer_Dev encrypted_buffer, 71 const PP_EncryptedBlockInfo& encrypted_block_info) = 0; 72 73 // PPB_ContentDecryptor_Private methods for passing data from the decryptor 74 // to the browser. 75 void PromiseResolved(uint32_t promise_id); 76 void PromiseResolvedWithSession(uint32_t promise_id, 77 const std::string& web_session_id); 78 void PromiseResolvedWithKeyIds( 79 uint32_t promise_id, 80 const std::vector<std::vector<uint8_t> >& key_ids); 81 void PromiseRejected(uint32_t promise_id, 82 PP_CdmExceptionCode exception_code, 83 uint32_t system_code, 84 const std::string& error_description); 85 void SessionMessage(const std::string& web_session_id, 86 pp::VarArrayBuffer message, 87 const std::string& destination_url); 88 void SessionKeysChange(const std::string& web_session_id, 89 bool has_additional_usable_key); 90 void SessionExpirationChange(const std::string& web_session_id, 91 PP_Time new_expiry_time); 92 void SessionReady(const std::string& web_session_id); 93 void SessionClosed(const std::string& web_session_id); 94 void SessionError(const std::string& web_session_id, 95 PP_CdmExceptionCode exception_code, 96 uint32_t system_code, 97 const std::string& error_description); 98 99 // The plugin must not hold a reference to the encrypted buffer resource 100 // provided to Decrypt() when it calls this method. The browser will reuse 101 // the buffer in a subsequent Decrypt() call. 102 void DeliverBlock(pp::Buffer_Dev decrypted_block, 103 const PP_DecryptedBlockInfo& decrypted_block_info); 104 105 void DecoderInitializeDone(PP_DecryptorStreamType decoder_type, 106 uint32_t request_id, 107 bool status); 108 void DecoderDeinitializeDone(PP_DecryptorStreamType decoder_type, 109 uint32_t request_id); 110 void DecoderResetDone(PP_DecryptorStreamType decoder_type, 111 uint32_t request_id); 112 113 // The plugin must not hold a reference to the encrypted buffer resource 114 // provided to DecryptAndDecode() when it calls this method. The browser will 115 // reuse the buffer in a subsequent DecryptAndDecode() call. 116 void DeliverFrame(pp::Buffer_Dev decrypted_frame, 117 const PP_DecryptedFrameInfo& decrypted_frame_info); 118 119 // The plugin must not hold a reference to the encrypted buffer resource 120 // provided to DecryptAndDecode() when it calls this method. The browser will 121 // reuse the buffer in a subsequent DecryptAndDecode() call. 122 void DeliverSamples(pp::Buffer_Dev audio_frames, 123 const PP_DecryptedSampleInfo& decrypted_sample_info); 124 125 private: 126 InstanceHandle associated_instance_; 127 }; 128 129 } // namespace pp 130 131 #endif // PPAPI_CPP_PRIVATE_CONTENT_DECRYPTOR_PRIVATE_H_ 132