Play DRM-protected content

Play Widevine DRM-protected FastPix streams in the FastPix Android Player.

The FastPix Android Player SDK plays Widevine-protected HLS streams. To play a protected stream, provide both a playbackToken, which authorizes secure playback, and a drmConfig, which enables DRM on the media item. If you set a playbackToken without a drmConfig, playback fails with a DRM configuration error, reported through PlaybackListener.onError.

Before you begin

Make sure you have the following:

• The FastPix Android Player SDK installed and a player set up. See Install FastPix Android player and Set up the player.
• DRM enabled on your FastPix account, plus a playback token for the protected stream. To enable DRM and generate tokens, see Set up DRM encryption.

Set up basic DRM playback

Provide the playbackToken and a default drmConfig in your setFastPixMediaItem configuration. The default DrmConfig() targets the Widevine UUID with multiSession enabled. Use streamType so the SDK resolves the correct FastPix DRM license endpoint for on-demand or live content.

1
import io.fastpix.media3.core.DrmConfig
2
import io.fastpix.media3.core.FastPixPlayer
3
import io.fastpix.media3.core.StreamType
4
5
val player = FastPixPlayer.Builder(this)
6
    .setAutoplay(true)
7
    .build()
8
binding.playerView.player = player
9
10
player.setFastPixMediaItem {
11
    playbackId = "your-playback-id"
12
    streamType = StreamType.onDemand // Use StreamType.live for live streams
13
    playbackToken = "your-secure-playback-token"
14
    drmConfig = DrmConfig() // Defaults to Widevine UUID, multiSession=true
15
}

Customize DRM options

Pass a configured DrmConfig to set the DRM UUID and session behavior explicitly.

1
import androidx.media3.common.C
2
import io.fastpix.media3.core.DrmConfig
3
4
player.setFastPixMediaItem {
5
    playbackId = "your-playback-id"
6
    playbackToken = "your-secure-playback-token"
7
    drmConfig = DrmConfig(
8
        uuid = C.WIDEVINE_UUID,
9
        multiSession = true
10
    )
11
}

Things to know

• The current SDK DRM flow targets Widevine-protected FastPix HLS playback.
• streamType helps resolve the correct FastPix DRM license endpoint (on-demand or live).
• Always test DRM streams on real devices, and target the Android API levels you support.
• A playbackToken without a drmConfig produces a DRM configuration error through PlaybackListener.onError.

What’s next

• Enable secure video playback to protect non-DRM streams with playback tokens.
• Set up DRM encryption to enable DRM on your FastPix account.