Additional support for protected content

Support in HbbTV

Available since: HbbTV 2.0.1 (ETSI TS 102 796 V1.4.1, OIPF DAE V2.3)

Mandatory if the DRM feature is supported or if the terminal supports CI Plus.

NOTE: This clause defines extensions to both the Recording and Download classes. The extensions to the Recording class are mandatory if the PVR feature is supported. The extensions to the Download class are mandatory if the file download feature is supported.

Comment

Security: Trusted

The existing Download and Recording classes shall both be extended with two properties isEncrypted and DRMSystemIds and one method getDRMPrivateData as follows.

readonly Boolean isEncrypted
Has value true if the content is protected by a DRM. or undefined if this information is not available to the OITF. The mapping for different content formats is described in section 8.4.4.
readonly StringCollection DRMSystemIDs
StringCollection object containing the names of the DRM system ID of the DRM protecting the content. OIPF DRMSystemID are defined in Table 9 of Section 3.3.2 of [OIPF_META2]. The collection is empty if this information is not available to the OITF. The mapping for different content formats is described in section 8.4.4.

String getDRMPrivateData( String DRMSystemID )

Description

Gets the private opaque data in the protected content in the scope of the specified DRM system.

The function returns the private data of the protected content in the scope of the DRM system. The function returns undefined if this information is not available to the OITF or if the content is not protected by the specified DRM. The mapping for different content formats is described in section 8.4.4. The private data bytes SHALL be encoded in a string whose characters shall be restricted to the ISO Latin-1 character set. Each character in the string represents a byte of the private data, such that a byte at position “i” in the private data is equal the Latin-1 character code of the character at position “i” in the string

Arguments

DRMSystemID

DRM system ID as defined by element DRMSystemID in Table 9 of section 3.3.2 of [OIPF_META2].