PSSH

class PSSH

Helper for parsing and building PSSH (Protection System Specific Header) boxes. Supports both Widevine and PlayReady headers and provides conversions.

Constructors

PSSH

constructor(data: String, strict: Boolean = false)

Create from a Base64-encoded PSSH box, Widevine CENC header, or PlayReady header.

constructor(data: ByteArray, strict: Boolean = false)

Create from raw bytes of a PSSH box, Widevine CENC header, or PlayReady header.

constructor(systemId: ByteArray, version: Int, flags: Int, keyIds: List<Uuid>, content: ByteArray)

Types

Companion

object Companion

Properties

cryptoPeriodIndex

val cryptoPeriodIndex: Int?

Crypto period this header names, for content using key rotation, or null.

cryptoPeriodSeconds

val cryptoPeriodSeconds: Int?

Duration of each crypto period in seconds, for content using key rotation, or null.

encryptionScheme

val encryptionScheme: String?

Encryption scheme this header declares, e.g. AESCTR or AESCBC, or null when the header does not say.

initData

val initData: ByteArray

Raw init data contained within the PSSH box.

Functions

export

fun export(): ByteArray

Export the PSSH object as a full PSSH box in bytes form.

exportBase64

fun exportBase64(): String

Export the PSSH object as a full PSSH box in Base64 form.

keyIds

fun keyIds(): List<Uuid>

Get all Key IDs from within the Box or Init Data, wherever possible.

setCryptoPeriodIndex

fun setCryptoPeriodIndex(index: Int)

Point this PSSH at a specific crypto period.

setKeyIds

fun setKeyIds(keyIds: List<Uuid>)

Overwrite the Key IDs of this box.

setKeyIdsAny

fun setKeyIdsAny(keyIds: List<Any>)

Overload that accepts a mixed list of UUID | String(hex/base64) | ByteArray.

toPlayready

fun toPlayready(laUrl: String? = null, luiUrl: String? = null, dsId: ByteArray? = null, decryptorSetup: String? = null, customData: String? = null)

Convert a Widevine PSSH to a PlayReady v4.3.0.0 PSSH. Optional LA_URL/LUI_URL/DS_ID/DECRYPTORSETUP/CUSTOMDATA fields can be provided.

toString

open override fun toString(): String

toWidevine

fun toWidevine()

Convert PlayReady PSSH to a Widevine PSSH.