Triton Audio Player

The Quickplay Audio Player supports Client-Side Ad Insertion (CSAI) for both VOD and Live Audio content, enabling seamless ad playback with video pre-rolls.

Triton Cue Points for Live Streaming

For live audio streams, the Triton player listens to Triton cue points, allowing real-time tracking of tracks and advertisements. This ensures accurate ad playback and metadata synchronization.

Setup

1. To enable audio playback functionality, add the following permissions and service to your AndroidManifest.xml:

<manifest>
    <!--  Add the necessary permissions -->
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />
    <uses-permission android:name="android.permission.WAKE_LOCK" />

    <service
        android:name=".AudioBrowserService"
        android:enabled="true"
        android:exported="true"
        android:foregroundServiceType="mediaPlayback">
        <intent-filter>
            <action android:name="android.media.browse.MediaBrowserService"/>
        </intent-filter>
    </service>
</manifest>

2. Start the Audio Player Service Ensure that the audio player service is started. This is mandatory for the player to be ready at launch of the application

TritonPlayerFactory.prepareAudioPlayerService()

Create the Triton Player

The triton audio player can be created by configuring the player with the required parameters, such as the stream connection configuration and playback session configuration.

// Creates [TritonPlayer] instance that plays Triton audio streams.
val tritonPlayer = TritonPlayerFactory.createTritonAudioPlayer(
    tritonStreamConfig,
    playbackConfig,
    PlayerNotificationProperties.Builder().build(),
)

Parameters

Property Name	Type	Description
streamConnectionConfig	TritonAudioStreamConnectionConfig	Represents Triton end points connectivity information.
playbackSessionConfig	TritonAudioPlaybackSessionConfig	Declares the configuration properties for [TritonPlayer] playback session initialization.
playerNotificationProperties	PlayerNotificationProperties instance	Encapsulates all the configurable properties applicable for audio playback to post the player notification.

Create TritonAudioStreamConnectionConfig

This configuration handles the stream connection. It can be set up for live or on-demand content.

Parameters

Property Name	Type	Description
contentURL	String	The primary URL to start Triton audio stream playback session. session with [contentURL].
sidebandMetadataURL	String	The primary URL to retrieve sideband metadata. NOTE: that this attribute is not applicable on on-demand content.
playerNotificationProperties	Int	The number of attempts trying to establish previously failed connection to sideband metadata end point.
sidebandMetadataConnectionRetryDelayFactorMs	Long	The reconnection retry delay factor, in milliseconds, used in exponential back-off retry computation. This scheme is used in order to prevent excessive simultaneous requests hitting servers.

val tritonStreamConfig = if (isLive)
    TritonAudioStreamConnectionConfig(
        contentURL,
        sidebandMetadataURL = siedbandMetadataUrl
    ) else
    TritonAudioStreamConnectionConfig(contentURL)

Create TritonAudioPlaybackSessionConfig

Create IMA targeted AdRequest instance.

val adRequest: CSAIAdsRequest? = playbackItem.adURL?.let {
    CSAIAdsRequest(
        it,
        adOverlayUIScopes
    )
}

To create a playback configuration for the audio player, you can use the following snippet:

val playbackConfig = TritonAudioPlaybackSessionConfig(
    playbackProperties = playbackPropertiesBuilder.build(),
    mediaType = playbackItem.mediaType,
    adRequest = adRequest,
    mediaMetadata = mediaMetadata
)

Listening to Triton Track/ Ad events.

override fun onEventReceived(
    streamTimelineEvent: StreamTimelineEvent,
    suggestedAction: Action,
    streamTimelineMetadata: StreamTimelineMetadata?
) {
    when (streamTimelineEvent) {
        StreamTimelineEvent.TRITON_AUDIO_MEDIA_TRACK -> {
            when (suggestedAction) {
                Action.DISPLAY -> {
                    // Display the Track event
                }
                Action.HIDE -> {
                    // Hide the Track event
                }
            }
            StreamTimelineEvent.TRITON_AD -> {
                when (suggestedAction) {
                    Action.DISPLAY -> {
                        // Display the Ad event
                    }
                    Action.HIDE -> {
                        // Hide the Ad event
                    }
                }
            }
        }
    }
}