Shaka Packager SDK
Classes | Typedefs | Enumerations | Functions | Variables
shaka Namespace Reference

All the methods that are virtual are virtual for mocking. More...

Classes

class  AdaptationSet
 
struct  AdCueGeneratorParams
 Cuepoint generator related parameters. More...
 
class  BandwidthEstimator
 
struct  BufferCallbackParams
 Buffer callback params. More...
 
class  CallbackFile
 
struct  ChunkingParams
 Chunking (segmentation) related parameters. More...
 
struct  ContentProtectionElement
 
struct  Cuepoint
 
struct  DecryptionParams
 Decryption parameters. More...
 
struct  Element
 
struct  EncryptionParams
 Encryption parameters. More...
 
class  File
 Define an abstract file interface. More...
 
struct  FileCloser
 
struct  HlsParams
 HLS related parameters. More...
 
class  IoCache
 Declaration of class which implements a thread-safe circular buffer. More...
 
class  LocalFile
 Implement LocalFile which deals with local storage. More...
 
class  MemoryFile
 
class  MockAdaptationSet
 
class  MockMpdBuilder
 
class  MockMpdNotifier
 
class  MockPeriod
 
class  MockRepresentation
 
struct  Mp4OutputParams
 MP4 (ISO-BMFF) output related parameters. More...
 
class  MpdBuilder
 This class generates DASH MPDs (Media Presentation Descriptions). More...
 
class  MpdNotifier
 
class  MpdNotifierFactory
 
struct  MpdOptions
 Defines Mpd Options. More...
 
struct  MpdParams
 DASH MPD related parameters. More...
 
class  MpdWriter
 
class  Packager
 
struct  PackagingParams
 Packaging parameters. More...
 
class  Period
 
struct  PlayReadyEncryptionParams
 
struct  RawKeyParams
 Raw key encryption/decryption parameters, i.e. with key parameters provided. More...
 
class  Representation
 
class  RepresentationStateChangeListener
 
struct  SegmentInfo
 
class  SimpleMpdNotifier
 
class  Status
 
struct  StreamDescriptor
 Defines a single input/output stream. More...
 
struct  TestParams
 Parameters used for testing. More...
 
class  ThreadedIoFile
 Declaration of class which implements a thread-safe circular buffer. More...
 
class  UdpFile
 Implements UdpFile, which receives UDP unicast and multicast streams. More...
 
class  UdpOptions
 Options parsed from UDP url string of the form: udp://ip:port[?options]. More...
 
struct  WidevineDecryptionParams
 Widevine decryption parameters. More...
 
struct  WidevineEncryptionParams
 Widevine encryption parameters. More...
 
struct  WidevineSigner
 Signer credential for Widevine license server. More...
 

Typedefs

typedef MediaInfo::AudioInfo AudioInfo
 
typedef MediaInfo::VideoInfo VideoInfo
 

Enumerations

enum  HlsPlaylistType { kVod, kEvent, kLive }
 
enum  KeyProvider { kNone = 0, kWidevine = 1, kPlayReady = 2, kRawKey = 3 }
 Encryption / decryption key providers.
 
enum  ContentType { kContentTypeUnknown, kContentTypeVideo, kContentTypeAudio, kContentTypeText }
 
enum  DashProfile { kUnknown, kOnDemand, kLive }
 
enum  MpdType { kStatic, kDynamic }
 

Functions

bool ValidateHexString (const char *flagname, const std::string &value, std::vector< uint8_t > *value_bytes)
 
bool ValidatePRCryptoFlags ()
 
bool ValidateRawKeyCryptoFlags ()
 
base::Optional< StreamDescriptorParseStreamDescriptor (const std::string &descriptor_string)
 
void PrintError (const std::string &error_message)
 
void PrintWarning (const std::string &warning_message)
 
template<class FlagType >
bool ValidateFlag (const char *flag_name, const FlagType &flag_value, bool condition, bool optional, const char *label)
 
bool ValidateWidevineCryptoFlags ()
 
bool TempFilePath (const std::string &temp_dir, std::string *temp_file_path)
 
std::string LanguageToShortestForm (const std::string &language)
 
std::string LanguageToISO_639_2 (const std::string &language)
 
bool WriteMpdToFile (const std::string &output_path, MpdBuilder *mpd_builder)
 
ContentType GetContentType (const MediaInfo &media_info)
 
std::string Uint8VectorToBase64 (const std::vector< uint8_t > &input)
 Converts uint8 vector into base64 encoded string.
 
bool HasVODOnlyFields (const MediaInfo &media_info)
 
bool HasLiveOnlyFields (const MediaInfo &media_info)
 
void RemoveDuplicateAttributes (ContentProtectionElement *content_protection_element)
 
std::string GetLanguage (const MediaInfo &media_info)
 
std::string GetCodecs (const MediaInfo &media_info)
 
std::string GetBaseCodec (const MediaInfo &media_info)
 
std::string GetAdaptationSetKey (const MediaInfo &media_info)
 
std::string SecondsToXmlDuration (double seconds)
 
bool GetDurationAttribute (xmlNodePtr node, float *duration)
 
bool MoreThanOneTrue (bool b1, bool b2, bool b3)
 
bool AtLeastOneTrue (bool b1, bool b2, bool b3)
 
bool OnlyOneTrue (bool b1, bool b2, bool b3)
 
bool HexToUUID (const std::string &data, std::string *uuid_format)
 
void UpdateContentProtectionPsshHelper (const std::string &drm_uuid, const std::string &pssh, std::list< ContentProtectionElement > *content_protection_elements)
 
void AddContentProtectionElements (const MediaInfo &media_info, Representation *parent)
 
void AddContentProtectionElements (const MediaInfo &media_info, AdaptationSet *parent)
 
std::ostream & operator<< (std::ostream &os, const Status &x)
 

Variables

const char * kCallbackFilePrefix = "callback://"
 
const char * kLocalFilePrefix = "file://"
 
const char * kMemoryFilePrefix = "memory://"
 
const char * kUdpFilePrefix = "udp://"
 
const int64_t kWholeFile = -1
 
const char kAdditionalFileMode [] = "b"
 
const char kEncryptedMp4Scheme [] = "urn:mpeg:dash:mp4protection:2011"
 
const char kPsshElementName [] = "cenc:pssh"
 

Detailed Description

All the methods that are virtual are virtual for mocking.

NOTE: Inclusion of this module will cause curl_global_init and curl_global_cleanup to be called at static initialization / deinitialization time.

All the methods that are virtual are virtual for mocking. NOTE: Inclusion of this module will cause xmlInitParser and xmlCleanupParser to be called at static initialization / deinitialization time.

This file contains helper functions and enums for MpdNotifier implementations.

Enumeration Type Documentation

◆ HlsPlaylistType

Defines the EXT-X-PLAYLIST-TYPE in the HLS specification. For HlsPlaylistType of kLive, EXT-X-PLAYLIST-TYPE tag is omitted.

Definition at line 16 of file hls_params.h.

Function Documentation

◆ AddContentProtectionElements() [1/2]

void shaka::AddContentProtectionElements ( const MediaInfo &  media_info,
Representation parent 
)

Adds <ContentProtection> elements specified by media_info to adaptation_set. Note that this will add the elements as direct chlidren of AdaptationSet.

Parameters
media_infomay or may not have protected_content field.
adaptation_setis the parent element that owns the ContentProtection elements.

Definition at line 424 of file mpd_utils.cc.

◆ AddContentProtectionElements() [2/2]

void shaka::AddContentProtectionElements ( const MediaInfo &  media_info,
AdaptationSet parent 
)

Adds <ContentProtection> elements specified by media_info to representation.

Parameters
media_infomay or may not have protected_content field.
representationis the parent element that owns the ContentProtection elements.

Definition at line 429 of file mpd_utils.cc.

◆ GetContentType()

ContentType shaka::GetContentType ( const MediaInfo &  media_info)

Determines the content type of |media_info|.

Parameters
media_infois the information about the media.
Returns
content type of the media_info.

Definition at line 32 of file mpd_notifier_util.cc.

◆ HexToUUID()

bool shaka::HexToUUID ( const std::string &  data,
std::string *  uuid_format 
)

Converts hex data to UUID format. Hex data must be size 16.

Parameters
datainput hex data.
uuid_formatis the UUID format of the input.

Definition at line 216 of file mpd_utils.cc.

◆ LanguageToISO_639_2()

std::string shaka::LanguageToISO_639_2 ( const std::string &  language)

Convert a language tag to a 3-letter ISO-639-2 code, as required by the ISO BMFF spec. The input is assumed to be a valid ISO-639-2 or ISO-639-1 language code. Regions and variants are not supported.

Definition at line 117 of file language_utils.cc.

◆ LanguageToShortestForm()

std::string shaka::LanguageToShortestForm ( const std::string &  language)

Convert a language tag to its shortest form, as required by RFC 5646 indicated in the MPD and HLS specs. Assumes the input is a valid ISO-639-2 or ISO-639-1 language tag, or an empty string. Regions and variants are preserved in the conversion.

Definition at line 89 of file language_utils.cc.

◆ ParseStreamDescriptor()

base::Optional< StreamDescriptor > shaka::ParseStreamDescriptor ( const std::string &  descriptor_string)

Parses a descriptor string, and inserts into sorted list of stream descriptors.

Parameters
descriptor_stringcontains comma separate name-value pairs describing the stream.
descriptor_listis a pointer to the sorted descriptor list into which the new descriptor should be inserted.
Returns
true if successful, false otherwise. May print error messages.

Definition at line 82 of file stream_descriptor.cc.

◆ PrintError()

void shaka::PrintError ( const std::string &  error_message)

Format and print error message.

Parameters
error_messagespecifies the error message.

Definition at line 15 of file validate_flag.cc.

◆ PrintWarning()

void shaka::PrintWarning ( const std::string &  warning_message)

Format and print warning message.

Parameters
warning_messagespecifies the warning message.

Definition at line 19 of file validate_flag.cc.

◆ TempFilePath()

bool shaka::TempFilePath ( const std::string &  temp_dir,
std::string *  temp_file_path 
)

Create a temp file name in directory temp_dir. Generate the temp file in os specific temporary directory if temp_dir is empty.

Parameters
temp_dirspecifies the directory where the file should go.
temp_file_pathis the result temp file path on success.
Returns
true on success, false otherwise.

Definition at line 38 of file file_util.cc.

◆ ValidateFlag()

template<class FlagType >
bool shaka::ValidateFlag ( const char *  flag_name,
const FlagType &  flag_value,
bool  condition,
bool  optional,
const char *  label 
)

Validate a flag against the given condition.

Parameters
flag_nameis the name of the flag.
flag_valueis the value of the flag.
condition,optionaldetermines how the flag should be validated. If condition is true and optional is false, then this flag is required
labelspecifies the label associated with the condition. It is used to generate the error message on validation failure.
Returns
true on success, false otherwise.

Definition at line 37 of file validate_flag.h.

◆ ValidatePRCryptoFlags()

bool shaka::ValidatePRCryptoFlags ( )

Validate PlayReady encryption flags.

Returns
true on success, false otherwise.

Definition at line 34 of file playready_key_encryption_flags.cc.

◆ ValidateRawKeyCryptoFlags()

bool shaka::ValidateRawKeyCryptoFlags ( )

Validate raw encryption/decryption flags.

Returns
true on success, false otherwise.

Definition at line 51 of file raw_key_encryption_flags.cc.

◆ ValidateWidevineCryptoFlags()

bool shaka::ValidateWidevineCryptoFlags ( )

Validate widevine encryption/decryption flags.

Returns
true on success, false otherwise.

Definition at line 71 of file widevine_encryption_flags.cc.

◆ WriteMpdToFile()

bool shaka::WriteMpdToFile ( const std::string &  output_path,
MpdBuilder mpd_builder 
)

Outputs MPD to output_path.

Parameters
output_pathis the path to the MPD output location.
mpd_builderis the MPD builder instance.

Definition at line 16 of file mpd_notifier_util.cc.