DefaultDrmSessionManager.Builder

public Builder()

Creates a builder with default values. The default values are:

• keyRequestParameters: An empty map.
• UUID: WIDEVINE_UUID.
• ExoMediaDrm.Provider: DEFAULT_PROVIDER.
• multiSession: false.
• useDrmSessionsForClearContent: No tracks.
• playClearSamplesWithoutKeys: true.
• LoadErrorHandlingPolicy: .
• sessionKeepaliveMs: DEFAULT_SESSION_KEEPALIVE_MS.

public DefaultDrmSessionManager build(MediaDrmCallback mediaDrmCallback)

Builds a DefaultDrmSessionManager instance.

@CanIgnoreReturnValue
public DefaultDrmSessionManager.Builder setKeyRequestParameters(
    @Nullable Map<String, String> keyRequestParameters
)

Sets the key request parameters to pass as the last argument to getKeyRequest. May be null if not parameters need to be passed.

Custom data for PlayReady should be set under PLAYREADY_CUSTOM_DATA_KEY.

@CanIgnoreReturnValue
public DefaultDrmSessionManager.Builder setLoadErrorHandlingPolicy(
    LoadErrorHandlingPolicy loadErrorHandlingPolicy
)

Sets the LoadErrorHandlingPolicy for key and provisioning requests.

@CanIgnoreReturnValue
public DefaultDrmSessionManager.Builder setMultiSession(boolean multiSession)

Sets whether this session manager is allowed to acquire multiple simultaneous sessions.

Users should pass false when a single key request will obtain all keys required to decrypt the associated content. multiSession is required when content uses key rotation.

@CanIgnoreReturnValue
public DefaultDrmSessionManager.Builder setPlayClearSamplesWithoutKeys(boolean playClearSamplesWithoutKeys)

Sets whether clear samples within protected content should be played when keys for the encrypted part of the content have yet to be loaded.

@CanIgnoreReturnValue
public DefaultDrmSessionManager.Builder setSessionKeepaliveMs(long sessionKeepaliveMs)

Sets the time to keep DrmSessions alive when they're not in use.

It can be useful to keep sessions alive during playback of short clear sections of media (e.g. ad breaks) to avoid opening new DRM sessions (and re-requesting keys) at the transition back into secure content. This assumes the secure sections before and after the clear section are encrypted with the same keys.

Defaults to DEFAULT_SESSION_KEEPALIVE_MS. Pass TIME_UNSET to disable keep-alive.

@CanIgnoreReturnValue
public DefaultDrmSessionManager.Builder setUseDrmSessionsForClearContent(
    @C.TrackType int[] useDrmSessionsForClearContentTrackTypes
)

Sets whether this session manager should attach DrmSessions to the clear sections of the media content.

Using DrmSessions for clear content avoids the recreation of decoders when transitioning between clear and encrypted sections of content.

@CanIgnoreReturnValue
public DefaultDrmSessionManager.Builder setUuidAndExoMediaDrmProvider(
    UUID uuid,
    ExoMediaDrm.Provider exoMediaDrmProvider
)

Sets the UUID of the DRM scheme and the ExoMediaDrm.Provider to use.