key_system_info.h revision d0247b1b59f9c528cb6df88b4f2b9afaf80d181e 
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
3// found in the LICENSE file.
4
5#ifndef CONTENT_PUBLIC_RENDERER_KEY_SYSTEM_INFO_H_
6#define CONTENT_PUBLIC_RENDERER_KEY_SYSTEM_INFO_H_
7
8#include <string>
9#include <utility>
10#include <vector>
11
12#include "base/basictypes.h"
13#include "content/common/content_export.h"
14
15// Definitions:
16// * Key system
17//    https://dvcs.w3.org/hg/html-media/raw-file/default/encrypted-media/encrypted-media.html#key-system
18// * Concrete key system
19//    A key system string that can be instantiated, such as
20//    via the MediaKeys constructor. Examples include "org.w3.clearkey" and
21//    "com.widevine.alpha".
22// * Abstract key system
23//    A key system string that cannot be instantiated like a concrete key system
24//    but is otherwise useful, such as in discovery using isTypeSupported().
25// * Parent key system
26//    A key system string that is one level up from the child key system. It may
27//    be an abstract key system.
28//    As an example, "com.example" is the parent of "com.example.foo".
29
30namespace content {
31
32// Contains information about an EME key system as well as how to instantiate
33// the corresponding CDM.
34struct CONTENT_EXPORT KeySystemInfo {
35  // Represents container-codec combinations. The second string may contain zero
36  // or more codecs separated by commas.
37  typedef std::pair<std::string, std::string> ContainerCodecsPair;
38
39  explicit KeySystemInfo(const std::string& key_system);
40  ~KeySystemInfo();
41
42  std::string key_system;
43
44  // Specifies container and codec combinations supported by |key_system|.
45  // Multiple codecs may be listed for each container.
46  // In all cases, the container without a codec is also always supported.
47  std::vector<ContainerCodecsPair> supported_types;
48
49  // A hierarchical parent for |key_system|. This value can be used to check
50  // supported types but cannot be used to instantiate a MediaKeys object.
51  // Only one parent key system is currently supported per concrete key system.
52  std::string parent_key_system;
53
54  // The following indicate how the corresponding CDM should be instantiated.
55  bool use_aes_decryptor;
56#if defined(ENABLE_PEPPER_CDMS)
57  std::string pepper_type;
58#elif defined(OS_ANDROID)
59  std::vector<uint8> uuid;
60#endif
61};
62
63}  // namespace content
64
65#endif  // CONTENT_PUBLIC_RENDERER_KEY_SYSTEM_INFO_H_
66