content_decryptor_private.h revision a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7 
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
17namespace pp {
18
19class Instance;
20
21// TODO(tomfinegan): Remove redundant pp:: usage, and pass VarArrayBuffers as
22// const references.
23
24class 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 Initialize(const std::string& key_system) = 0;
35  virtual void CreateSession(uint32_t session_id,
36                             const std::string& type,
37                             pp::VarArrayBuffer init_data) = 0;
38  virtual void UpdateSession(uint32_t session_id,
39                             pp::VarArrayBuffer response) = 0;
40  virtual void ReleaseSession(uint32_t 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 SessionCreated(uint32_t session_id, const std::string& web_session_id);
62  void SessionMessage(uint32_t session_id,
63                      pp::VarArrayBuffer message,
64                      const std::string& default_url);
65  void SessionReady(uint32_t session_id);
66  void SessionClosed(uint32_t session_id);
67  void SessionError(uint32_t session_id,
68                    int32_t media_error,
69                    int32_t system_code);
70
71  // The plugin must not hold a reference to the encrypted buffer resource
72  // provided to Decrypt() when it calls this method. The browser will reuse
73  // the buffer in a subsequent Decrypt() call.
74  void DeliverBlock(pp::Buffer_Dev decrypted_block,
75                    const PP_DecryptedBlockInfo& decrypted_block_info);
76
77  void DecoderInitializeDone(PP_DecryptorStreamType decoder_type,
78                             uint32_t request_id,
79                             bool status);
80  void DecoderDeinitializeDone(PP_DecryptorStreamType decoder_type,
81                               uint32_t request_id);
82  void DecoderResetDone(PP_DecryptorStreamType decoder_type,
83                        uint32_t request_id);
84
85  // The plugin must not hold a reference to the encrypted buffer resource
86  // provided to DecryptAndDecode() when it calls this method. The browser will
87  // reuse the buffer in a subsequent DecryptAndDecode() call.
88  void DeliverFrame(pp::Buffer_Dev decrypted_frame,
89                    const PP_DecryptedFrameInfo& decrypted_frame_info);
90
91  // The plugin must not hold a reference to the encrypted buffer resource
92  // provided to DecryptAndDecode() when it calls this method. The browser will
93  // reuse the buffer in a subsequent DecryptAndDecode() call.
94  void DeliverSamples(pp::Buffer_Dev audio_frames,
95                      const PP_DecryptedSampleInfo& decrypted_sample_info);
96
97 private:
98  InstanceHandle associated_instance_;
99};
100
101}  // namespace pp
102
103#endif  // PPAPI_CPP_PRIVATE_CONTENT_DECRYPTOR_PRIVATE_H_
104