APIs for automatic deletion of downloaded content

Support in HbbTV

Available since: HbbTV 2.0.1 (ETSI TS 102 796 V1.4.1)

The following additional property on the Download object (as defined in the OIPF DAE specification [1]) shall be supported.

Boolean flaggedForDeletion

Description

Boolean property set by the application indicating whether the content item has been flagged as suitable for automatic deletion. When additional storage space is needed to complete a download that has been registered, if deleting content items flagged for automatic deletion would provide the additional storage space needed then enough of these content items shall be deleted by the terminal to provide the space needed.

When a download is removed automatically as a result of this flag being set, the effect shall be the same as the effect of the remove() method: the download and any data and media content associated with it shall be removed, and all properties on the Download object shall be set to undefined.

The storage space corresponding to the downloads which are flagged for deletion shall be deemed as free by the checkDownloadPossible() method.

The order in which items flagged for deletion are actually removed by the terminal, and the time at which they are removed, is implementation-dependent, and may take into account factors such as the time at which the item was flagged for deletion, the size of the item compared to the amount of space needed. Items flagged for deletion shall not be removed automatically if they are currently being referred to by an A/V Control object or a <video> element.