#include <widevine_key_source.h>

Inheritance diagram for shaka::media::WidevineKeySource:

Public Member Functions
	WidevineKeySource (const std::string &server_url, bool add_common_pssh)

Status	FetchKeys (const std::vector< uint8_t > &content_id, const std::string &policy)

void	set_signer (std::unique_ptr< RequestSigner > signer)

void	set_key_fetcher (std::unique_ptr< KeyFetcher > key_fetcher)

KeySource implementation overrides.
Status	FetchKeys (const std::vector< uint8_t > &pssh_box) override

Status	FetchKeys (const std::vector< std::vector< uint8_t >> &key_ids) override

Status	FetchKeys (uint32_t asset_id) override

Status	GetKey (TrackType track_type, EncryptionKey *key) override

Status	GetKey (const std::vector< uint8_t > &key_id, EncryptionKey *key) override

Status	GetCryptoPeriodKey (uint32_t crypto_period_index, TrackType track_type, EncryptionKey *key) override

Protected Attributes
ClosureThread	key_production_thread_

Additional Inherited Members
Public Types inherited from shaka::media::KeySource
enum	TrackType { TRACK_TYPE_UNKNOWN = 0, TRACK_TYPE_SD = 1, TRACK_TYPE_HD = 2, TRACK_TYPE_UHD1 = 3, TRACK_TYPE_UHD2 = 4, TRACK_TYPE_AUDIO = 5, TRACK_TYPE_UNSPECIFIED = 6, NUM_VALID_TRACK_TYPES = 6 }

Static Public Member Functions inherited from shaka::media::KeySource
static TrackType	GetTrackTypeFromString (const std::string &track_type_string)
	Convert string representation of track type to enum representation.

static std::string	TrackTypeToString (TrackType track_type)
	Convert TrackType to string.

Detailed Description

WidevineKeySource talks to the Widevine encryption service to acquire the encryption keys.

Definition at line 30 of file widevine_key_source.h.

Constructor & Destructor Documentation

shaka::media::WidevineKeySource::WidevineKeySource	(	const std::string &	server_url,
		bool	add_common_pssh
	)

Parameters

server_url is the Widevine common encryption server url.

Definition at line 112 of file widevine_key_source.cc.

Member Function Documentation

Status shaka::media::WidevineKeySource::FetchKeys ( const std::vector< uint8_t > & pssh_box )

overridevirtual

Fetch keys for CENC from the key server.

Parameters

pssh_box The entire PSSH box for the content to be decrypted

Returns: OK on success, an error status otherwise.

Implements shaka::media::KeySource.

Definition at line 150 of file widevine_key_source.cc.

Status shaka::media::WidevineKeySource::FetchKeys ( const std::vector< std::vector< uint8_t >> & key_ids )

overridevirtual

Fetch keys for CENC from the key server.

Parameters

key_ids the key IDs for the keys to fetch from the server.

Returns: OK on success, an error status otherwise.

Implements shaka::media::KeySource.

Definition at line 177 of file widevine_key_source.cc.

Status shaka::media::WidevineKeySource::FetchKeys ( uint32_t asset_id )

overridevirtual

Fetch keys for WVM decryption from the key server.

Parameters

asset_id is the Widevine Classic asset ID for the content to be decrypted.

Returns: OK on success, an error status otherwise.

Implements shaka::media::KeySource.

Definition at line 198 of file widevine_key_source.cc.

Status shaka::media::WidevineKeySource::FetchKeys	(	const std::vector< uint8_t > &	content_id,
		const std::string &	policy
	)

Fetch keys for CENC from the key server.

Parameters

content_id	the unique id identify the content.
policy	specifies the DRM content rights.

Returns: OK on success, an error status otherwise.

Definition at line 139 of file widevine_key_source.cc.

Status shaka::media::WidevineKeySource::GetCryptoPeriodKey	(	uint32_t	crypto_period_index,
		TrackType	track_type,
		EncryptionKey *	key
	)

overridevirtual

Get encryption key of the specified track type at the specified index.

Parameters

crypto_period_index	is the sequence number of the key rotation period for which the key is being retrieved.
track_type	is the type of track for which retrieving the key.
key	is a pointer to the EncryptionKey which will hold the retrieved key. Owner retains ownership, and may not be NULL.

Returns: OK on success, an error status otherwise.

Implements shaka::media::KeySource.

Definition at line 230 of file widevine_key_source.cc.

Status shaka::media::WidevineKeySource::GetKey	(	TrackType	track_type,
		EncryptionKey *	key
	)

overridevirtual

Get encryption key of the specified track type.

Parameters

track_type	is the type of track for which retrieving the key.
key	is a pointer to the EncryptionKey which will hold the retrieved key. Owner retains ownership, and may not be NULL.

Returns: OK on success, an error status otherwise.

Implements shaka::media::KeySource.

Definition at line 207 of file widevine_key_source.cc.

Status shaka::media::WidevineKeySource::GetKey	(	const std::vector< uint8_t > &	key_id,
		EncryptionKey *	key
	)

overridevirtual

Get the encryption key specified by the CENC key ID.

Parameters

key_id	is the unique identifier for the key being retreived.
key	is a pointer to the EncryptionKey which will hold the retrieved key. Owner retains ownership, and may not be NULL.

Returns: OK on success, or an error status otherwise.

Implements shaka::media::KeySource.

Definition at line 217 of file widevine_key_source.cc.

void shaka::media::WidevineKeySource::set_key_fetcher ( std::unique_ptr< KeyFetcher > key_fetcher )

Inject an KeyFetcher object, mainly used for testing.

Parameters

key_fetcher points to the KeyFetcher object to be injected.

Definition at line 256 of file widevine_key_source.cc.

void shaka::media::WidevineKeySource::set_signer ( std::unique_ptr< RequestSigner > signer )

Set signer for the key source.

Parameters

signer signs the request message.

Definition at line 252 of file widevine_key_source.cc.

The documentation for this class was generated from the following files:

media/base/widevine_key_source.h
media/base/widevine_key_source.cc

Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation