ppapi/cpp/private/content_decryptor_private.h

   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 "ppapi/c/private/pp_content_decryptor.h"
   9 #include "ppapi/c/private/ppb_content_decryptor_private.h"
  10 #include "ppapi/c/private/ppp_content_decryptor_private.h"
  11
  12 #include "ppapi/cpp/dev/buffer_dev.h"
  13 #include "ppapi/cpp/instance_handle.h"
  14 #include "ppapi/cpp/var.h"
  15 #include "ppapi/cpp/var_array_buffer.h"
  16
  17 namespace pp {
  18
  19 class Instance;
  20
  21 // TODO(tomfinegan): Remove redundant pp:: usage, and pass VarArrayBuffers as
  22 // const references.
  23
  24 class ContentDecryptor_Private {
  25  public:
  26   explicit ContentDecryptor_Private(Instance* instance);
  27   virtual ~ContentDecryptor_Private();
  28
  29   // PPP_ContentDecryptor_Private functions exposed as virtual functions
  30   // for you to override.
  31   // TODO(tomfinegan): This could be optimized to pass pp::Var instead of
  32   // strings. The change would allow the CDM wrapper to reuse vars when
  33   // replying to the browser.
  34   virtual void GenerateKeyRequest(const std::string& key_system,
  35                                   const std::string& type,
  36                                   pp::VarArrayBuffer init_data) = 0;
  37   virtual void AddKey(const std::string& session_id,
  38                       pp::VarArrayBuffer key,
  39                       pp::VarArrayBuffer init_data) = 0;
  40   virtual void CancelKeyRequest(const std::string& session_id) = 0;
  41   virtual void Decrypt(pp::Buffer_Dev encrypted_buffer,
  42                        const PP_EncryptedBlockInfo& encrypted_block_info) = 0;
  43   virtual void InitializeAudioDecoder(
  44       const PP_AudioDecoderConfig& decoder_config,
  45       pp::Buffer_Dev extra_data_resource) = 0;
  46   virtual void InitializeVideoDecoder(
  47       const PP_VideoDecoderConfig& decoder_config,
  48       pp::Buffer_Dev extra_data_resource) = 0;
  49   virtual void DeinitializeDecoder(PP_DecryptorStreamType decoder_type,
  50                                    uint32_t request_id) = 0;
  51   virtual void ResetDecoder(PP_DecryptorStreamType decoder_type,
  52                             uint32_t request_id) = 0;
  53   // Null |encrypted_frame| means end-of-stream buffer.
  54   virtual void DecryptAndDecode(
  55       PP_DecryptorStreamType decoder_type,
  56       pp::Buffer_Dev encrypted_buffer,
  57       const PP_EncryptedBlockInfo& encrypted_block_info) = 0;
  58
  59   // PPB_ContentDecryptor_Private methods for passing data from the decryptor
  60   // to the browser.
  61   void NeedKey(const std::string& key_system,
  62                const std::string& session_id,
  63                pp::VarArrayBuffer init_data);
  64   void KeyAdded(const std::string& key_system,
  65                 const std::string& session_id);
  66   void KeyMessage(const std::string& key_system,
  67                   const std::string& session_id,
  68                   pp::VarArrayBuffer message,
  69                   const std::string& default_url);
  70   void KeyError(const std::string& key_system,
  71                 const std::string& session_id,
  72                 int32_t media_error,
  73                 int32_t system_code);
  74
  75   // The plugin must not hold a reference to the encrypted buffer resource
  76   // provided to Decrypt() when it calls this method. The browser will reuse
  77   // the buffer in a subsequent Decrypt() call.
  78   void DeliverBlock(pp::Buffer_Dev decrypted_block,
  79                     const PP_DecryptedBlockInfo& decrypted_block_info);
  80
  81   void DecoderInitializeDone(PP_DecryptorStreamType decoder_type,
  82                              uint32_t request_id,
  83                              bool status);
  84   void DecoderDeinitializeDone(PP_DecryptorStreamType decoder_type,
  85                                uint32_t request_id);
  86   void DecoderResetDone(PP_DecryptorStreamType decoder_type,
  87                         uint32_t request_id);
  88
  89   // The plugin must not hold a reference to the encrypted buffer resource
  90   // provided to DecryptAndDecode() when it calls this method. The browser will
  91   // reuse the buffer in a subsequent DecryptAndDecode() call.
  92   void DeliverFrame(pp::Buffer_Dev decrypted_frame,
  93                     const PP_DecryptedFrameInfo& decrypted_frame_info);
  94
  95   // The plugin must not hold a reference to the encrypted buffer resource
  96   // provided to DecryptAndDecode() when it calls this method. The browser will
  97   // reuse the buffer in a subsequent DecryptAndDecode() call.
  98   void DeliverSamples(pp::Buffer_Dev audio_frames,
  99                       const PP_DecryptedBlockInfo& decrypted_block_info);
 100
 101  private:
 102   InstanceHandle associated_instance_;
 103 };
 104
 105 }  // namespace pp
 106
 107 #endif  // PPAPI_CPP_PRIVATE_CONTENT_DECRYPTOR_PRIVATE_H_