OLD | NEW |
1 // Copyright 2013 The Chromium Authors. All rights reserved. | 1 // Copyright 2013 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 #ifndef MEDIA_BASE_MEDIA_KEYS_H_ | 5 #ifndef MEDIA_BASE_MEDIA_KEYS_H_ |
6 #define MEDIA_BASE_MEDIA_KEYS_H_ | 6 #define MEDIA_BASE_MEDIA_KEYS_H_ |
7 | 7 |
8 #include <string> | 8 #include <string> |
9 #include <vector> | 9 #include <vector> |
10 | 10 |
11 #include "base/basictypes.h" | 11 #include "base/basictypes.h" |
12 #include "base/callback.h" | 12 #include "base/callback.h" |
13 #include "base/memory/scoped_ptr.h" | 13 #include "base/memory/scoped_ptr.h" |
14 #include "media/base/media_export.h" | 14 #include "media/base/media_export.h" |
15 #include "url/gurl.h" | 15 #include "url/gurl.h" |
16 | 16 |
17 namespace base { | 17 namespace base { |
18 class Time; | 18 class Time; |
19 } | 19 } |
20 | 20 |
21 namespace media { | 21 namespace media { |
22 | 22 |
23 class Decryptor; | 23 class CdmContext; |
24 | 24 |
25 template <typename... T> | 25 template <typename... T> |
26 class CdmPromiseTemplate; | 26 class CdmPromiseTemplate; |
27 | 27 |
28 typedef CdmPromiseTemplate<std::string> NewSessionCdmPromise; | 28 typedef CdmPromiseTemplate<std::string> NewSessionCdmPromise; |
29 typedef CdmPromiseTemplate<> SimpleCdmPromise; | 29 typedef CdmPromiseTemplate<> SimpleCdmPromise; |
30 typedef std::vector<std::vector<uint8> > KeyIdsVector; | 30 typedef std::vector<std::vector<uint8> > KeyIdsVector; |
31 typedef CdmPromiseTemplate<KeyIdsVector> KeyIdsPromise; | 31 typedef CdmPromiseTemplate<KeyIdsVector> KeyIdsPromise; |
32 | 32 |
33 // Performs media key operations. | 33 // Performs media key operations. |
34 // | 34 // |
35 // All key operations are called on the renderer thread. Therefore, these calls | 35 // All key operations are called on the renderer thread. Therefore, these calls |
36 // should be fast and nonblocking; key events should be fired asynchronously. | 36 // should be fast and nonblocking; key events should be fired asynchronously. |
37 class MEDIA_EXPORT MediaKeys { | 37 class MEDIA_EXPORT MediaKeys{ |
38 public: | 38 public: |
39 // Reported to UMA, so never reuse a value! | 39 // Reported to UMA, so never reuse a value! |
40 // Must be kept in sync with blink::WebMediaPlayerClient::MediaKeyErrorCode | 40 // Must be kept in sync with blink::WebMediaPlayerClient::MediaKeyErrorCode |
41 // (enforced in webmediaplayer_impl.cc). | 41 // (enforced in webmediaplayer_impl.cc). |
42 // TODO(jrummell): Can this be moved to proxy_decryptor as it should only be | 42 // TODO(jrummell): Can this be moved to proxy_decryptor as it should only be |
43 // used by the prefixed EME code? | 43 // used by the prefixed EME code? |
44 enum KeyError { | 44 enum KeyError { |
45 kUnknownError = 1, | 45 kUnknownError = 1, |
46 kClientError, | 46 kClientError, |
47 // The commented v0.1b values below have never been used. | 47 // The commented v0.1b values below have never been used. |
(...skipping 17 matching lines...) Expand all Loading... |
65 | 65 |
66 // Type of license required when creating/loading a session. | 66 // Type of license required when creating/loading a session. |
67 // Must be consistent with the values specified in the spec: | 67 // Must be consistent with the values specified in the spec: |
68 // https://dvcs.w3.org/hg/html-media/raw-file/default/encrypted-media/encrypte
d-media.html#extensions | 68 // https://dvcs.w3.org/hg/html-media/raw-file/default/encrypted-media/encrypte
d-media.html#extensions |
69 enum SessionType { | 69 enum SessionType { |
70 TEMPORARY_SESSION, | 70 TEMPORARY_SESSION, |
71 PERSISTENT_SESSION | 71 PERSISTENT_SESSION |
72 }; | 72 }; |
73 | 73 |
74 static const uint32 kInvalidSessionId = 0; | 74 static const uint32 kInvalidSessionId = 0; |
75 #if defined(ENABLE_BROWSER_CDMS) | |
76 static const int kInvalidCdmId = 0; | |
77 #endif | |
78 | 75 |
79 MediaKeys(); | |
80 virtual ~MediaKeys(); | 76 virtual ~MediaKeys(); |
81 | 77 |
82 // Provides a server certificate to be used to encrypt messages to the | 78 // Provides a server certificate to be used to encrypt messages to the |
83 // license server. | 79 // license server. |
84 virtual void SetServerCertificate(const uint8* certificate_data, | 80 virtual void SetServerCertificate(const uint8* certificate_data, |
85 int certificate_data_length, | 81 int certificate_data_length, |
86 scoped_ptr<SimpleCdmPromise> promise) = 0; | 82 scoped_ptr<SimpleCdmPromise> promise) = 0; |
87 | 83 |
88 // Creates a session with the |init_data_type|, |init_data| and |session_type| | 84 // Creates a session with the |init_data_type|, |init_data| and |session_type| |
89 // provided. | 85 // provided. |
(...skipping 24 matching lines...) Expand all Loading... |
114 // Removes stored session data associated with the session specified by | 110 // Removes stored session data associated with the session specified by |
115 // |web_session_id|. | 111 // |web_session_id|. |
116 virtual void RemoveSession(const std::string& web_session_id, | 112 virtual void RemoveSession(const std::string& web_session_id, |
117 scoped_ptr<SimpleCdmPromise> promise) = 0; | 113 scoped_ptr<SimpleCdmPromise> promise) = 0; |
118 | 114 |
119 // Retrieves the key IDs for keys in the session that the CDM knows are | 115 // Retrieves the key IDs for keys in the session that the CDM knows are |
120 // currently usable to decrypt media data. | 116 // currently usable to decrypt media data. |
121 virtual void GetUsableKeyIds(const std::string& web_session_id, | 117 virtual void GetUsableKeyIds(const std::string& web_session_id, |
122 scoped_ptr<KeyIdsPromise> promise) = 0; | 118 scoped_ptr<KeyIdsPromise> promise) = 0; |
123 | 119 |
124 // Gets the Decryptor object associated with the MediaKeys. Returns NULL if | 120 // Returns the CdmContext associated with |this|, which must NOT be null. |
125 // no Decryptor object is associated. The returned object is only guaranteed | 121 // Usually the CdmContext is owned by |this|. Caller needs to make sure it is |
126 // to be valid during the MediaKeys' lifetime. | 122 // not used after |this| is destructed. |
127 virtual Decryptor* GetDecryptor(); | 123 virtual CdmContext* GetCdmContext() = 0; |
128 | 124 |
129 #if defined(ENABLE_BROWSER_CDMS) | 125 protected: |
130 // Returns the CDM ID associated with |this|. May be kInvalidCdmId if no CDM | 126 MediaKeys(); |
131 // ID is associated. | |
132 virtual int GetCdmId() const = 0; | |
133 #endif | |
134 | 127 |
135 private: | 128 private: |
136 DISALLOW_COPY_AND_ASSIGN(MediaKeys); | 129 DISALLOW_COPY_AND_ASSIGN(MediaKeys); |
137 }; | 130 }; |
138 | 131 |
139 // Key event callbacks. See the spec for details: | 132 // Key event callbacks. See the spec for details: |
140 // https://dvcs.w3.org/hg/html-media/raw-file/default/encrypted-media/encrypted-
media.html#event-summary | 133 // https://dvcs.w3.org/hg/html-media/raw-file/default/encrypted-media/encrypted-
media.html#event-summary |
141 typedef base::Callback<void(const std::string& web_session_id, | 134 typedef base::Callback<void(const std::string& web_session_id, |
142 const std::vector<uint8>& message, | 135 const std::vector<uint8>& message, |
143 const GURL& destination_url)> SessionMessageCB; | 136 const GURL& destination_url)> SessionMessageCB; |
(...skipping 11 matching lines...) Expand all Loading... |
155 bool has_additional_usable_key)> | 148 bool has_additional_usable_key)> |
156 SessionKeysChangeCB; | 149 SessionKeysChangeCB; |
157 | 150 |
158 typedef base::Callback<void(const std::string& web_session_id, | 151 typedef base::Callback<void(const std::string& web_session_id, |
159 const base::Time& new_expiry_time)> | 152 const base::Time& new_expiry_time)> |
160 SessionExpirationUpdateCB; | 153 SessionExpirationUpdateCB; |
161 | 154 |
162 } // namespace media | 155 } // namespace media |
163 | 156 |
164 #endif // MEDIA_BASE_MEDIA_KEYS_H_ | 157 #endif // MEDIA_BASE_MEDIA_KEYS_H_ |
OLD | NEW |