diff options
author | Torne (Richard Coles) <torne@google.com> | 2013-06-11 10:57:03 +0100 |
---|---|---|
committer | Torne (Richard Coles) <torne@google.com> | 2013-06-11 10:57:03 +0100 |
commit | 868fa2fe829687343ffae624259930155e16dbd8 (patch) | |
tree | 54d316199dd9739c57c3aacd131853bbd6554a94 /media/base/media_keys.h | |
parent | bb1bdbd796f966b5bf11f40ecbea12621c7bfac9 (diff) | |
download | chromium_org-868fa2fe829687343ffae624259930155e16dbd8.tar.gz |
Merge from Chromium at DEPS revision r205460
This commit was generated by merge_to_master.py.
Change-Id: I4a744a5e426bd3bb378d887cfa56fe054742a540
Diffstat (limited to 'media/base/media_keys.h')
-rw-r--r-- | media/base/media_keys.h | 89 |
1 files changed, 89 insertions, 0 deletions
diff --git a/media/base/media_keys.h b/media/base/media_keys.h new file mode 100644 index 0000000000..14789e23c1 --- /dev/null +++ b/media/base/media_keys.h @@ -0,0 +1,89 @@ +// Copyright 2013 The Chromium Authors. All rights reserved. +// Use of this source code is governed by a BSD-style license that can be +// found in the LICENSE file. + +#ifndef MEDIA_BASE_MEDIA_KEYS_H_ +#define MEDIA_BASE_MEDIA_KEYS_H_ + +#include <string> + +#include "base/basictypes.h" +#include "base/callback.h" +#include "base/memory/scoped_ptr.h" +#include "media/base/media_export.h" + +namespace media { + +// Performs media key operations. +// +// All key operations are called on the renderer thread. Therefore, these calls +// should be fast and nonblocking; key events should be fired asynchronously. +class MEDIA_EXPORT MediaKeys { + public: + // Reported to UMA, so never reuse a value! + // Must be kept in sync with WebKit::WebMediaPlayerClient::MediaKeyErrorCode + // (enforced in webmediaplayer_impl.cc). + enum KeyError { + kUnknownError = 1, + kClientError, + kServiceError, + kOutputError, + kHardwareChangeError, + kDomainError, + kMaxKeyError // Must be last and greater than any legit value. + }; + + MediaKeys(); + virtual ~MediaKeys(); + + // Generates a key request for the |key_system| with |type| and + // |init_data| provided. + // Returns true if generating key request succeeded, false otherwise. + // Note: AddKey() and CancelKeyRequest() should only be called after + // GenerateKeyRequest() returns true. + virtual bool GenerateKeyRequest(const std::string& key_system, + const std::string& type, + const uint8* init_data, + int init_data_length) = 0; + + // Adds a |key| to the |key_system|. The |key| is not limited to a decryption + // key. It can be any data that the key system accepts, such as a license. + // If multiple calls of this function set different keys for the same + // key ID, the older key will be replaced by the newer key. + virtual void AddKey(const std::string& key_system, + const uint8* key, int key_length, + const uint8* init_data, int init_data_length, + const std::string& session_id) = 0; + + // Cancels the key request specified by |session_id|. + virtual void CancelKeyRequest(const std::string& key_system, + const std::string& session_id) = 0; + + private: + DISALLOW_COPY_AND_ASSIGN(MediaKeys); +}; + +// Key event callbacks. See the spec for details: +// http://dvcs.w3.org/hg/html-media/raw-file/eme-v0.1b/encrypted-media/encrypted-media.html#event-summary +typedef base::Callback<void(const std::string& key_system, + const std::string& session_id)> KeyAddedCB; + +typedef base::Callback<void(const std::string& key_system, + const std::string& session_id, + media::MediaKeys::KeyError error_code, + int system_code)> KeyErrorCB; + +typedef base::Callback<void(const std::string& key_system, + const std::string& session_id, + const std::string& message, + const std::string& default_url)> KeyMessageCB; + +typedef base::Callback<void(const std::string& key_system, + const std::string& session_id, + const std::string& type, + scoped_ptr<uint8[]> init_data, + int init_data_size)> NeedKeyCB; + +} // namespace media + +#endif // MEDIA_BASE_MEDIA_KEYS_H_ |