MediaDrm.SecureStops Property

Definition

Secure stops are a way to enforce limits on the number of concurrent streams per subscriber across devices.

public System.Collections.Generic.IList<byte[]> SecureStops { [Android.Runtime.Register("getSecureStops", "()Ljava/util/List;", "")] get; }
[<get: Android.Runtime.Register("getSecureStops", "()Ljava/util/List;", "")>]
member this.SecureStops : System.Collections.Generic.IList<byte[]>

Property Value

IList<Byte[]>

a list of all secure stops from secure persistent memory

Attributes

Remarks

Secure stops are a way to enforce limits on the number of concurrent streams per subscriber across devices. They provide secure monitoring of the lifetime of content decryption keys in MediaDrm sessions.

A secure stop is written to secure persistent memory when keys are loaded into a MediaDrm session. The secure stop state indicates that the keys are available for use. When playback completes and the keys are removed or the session is destroyed, the secure stop state is updated to indicate that keys are no longer usable.

After playback, the app can query the secure stop and send it in a message to the license server confirming that the keys are no longer active. The license server returns a secure stop release response message to the app which then deletes the secure stop from persistent memory using #releaseSecureStops.

Each secure stop has a unique ID that can be used to identify it during enumeration, access and removal.

This member is deprecated. This method is deprecated and may be removed in a future release. Secure stops are a way to enforce limits on the number of concurrent streams per subscriber across devices. They provide secure monitoring of the lifetime of content decryption keys in MediaDrm sessions. Limits on concurrent streams may also be enforced by periodically renewing licenses. This can be achieved by calling #getKeyRequest to initiate a renewal. MediaDrm users should transition away from secure stops to periodic renewals.

Java documentation for android.media.MediaDrm.getSecureStops().

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to