1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
|
// 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 <vector>
#include "base/basictypes.h"
#include "base/callback.h"
#include "base/memory/scoped_ptr.h"
#include "media/base/media_export.h"
namespace media {
class Decryptor;
// 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 blink::WebMediaPlayerClient::MediaKeyErrorCode
// (enforced in webmediaplayer_impl.cc).
enum KeyError {
kUnknownError = 1,
kClientError,
// The commented v0.1b values below have never been used.
// kServiceError,
kOutputError = 4,
// kHardwareChangeError,
// kDomainError,
kMaxKeyError // Must be last and greater than any legit value.
};
const static uint32 kInvalidSessionId = 0;
MediaKeys();
virtual ~MediaKeys();
// Creates a session with the |content_type| and |init_data| provided.
// Returns true if a session is successfully created, false otherwise.
// Note: UpdateSession() and ReleaseSession() should only be called after
// SessionCreatedCB is fired.
// TODO(jrummell): Remove return value when prefixed API is removed.
// See http://crbug.com/342510
virtual bool CreateSession(uint32 session_id,
const std::string& content_type,
const uint8* init_data,
int init_data_length) = 0;
// Loads a session with the |web_session_id| provided.
// Note: UpdateSession() and ReleaseSession() should only be called after
// SessionCreatedCB is fired.
virtual void LoadSession(uint32 session_id,
const std::string& web_session_id) = 0;
// Updates a session specified by |session_id| with |response|.
virtual void UpdateSession(uint32 session_id,
const uint8* response,
int response_length) = 0;
// Releases the session specified by |session_id|.
virtual void ReleaseSession(uint32 session_id) = 0;
// Gets the Decryptor object associated with the MediaKeys. Returns NULL if
// no Decryptor object is associated. The returned object is only guaranteed
// to be valid during the MediaKeys' lifetime.
virtual Decryptor* GetDecryptor();
private:
DISALLOW_COPY_AND_ASSIGN(MediaKeys);
};
// Key event callbacks. See the spec for details:
// https://dvcs.w3.org/hg/html-media/raw-file/default/encrypted-media/encrypted-media.html#event-summary
typedef base::Callback<
void(uint32 session_id, const std::string& web_session_id)>
SessionCreatedCB;
typedef base::Callback<void(uint32 session_id,
const std::vector<uint8>& message,
const std::string& destination_url)>
SessionMessageCB;
typedef base::Callback<void(uint32 session_id)> SessionReadyCB;
typedef base::Callback<void(uint32 session_id)> SessionClosedCB;
typedef base::Callback<void(uint32 session_id,
media::MediaKeys::KeyError error_code,
uint32 system_code)> SessionErrorCB;
} // namespace media
#endif // MEDIA_BASE_MEDIA_KEYS_H_
|
