PlaybackGlue

Kotlin |Java

abstract class PlaybackGlue

kotlin.Any
↳	androidx.leanback.media.PlaybackGlue

Known Direct Subclasses

PlaybackBaseControlGlue, PlaybackControlGlue

PlaybackBaseControlGlue	A base abstract class for managing a `PlaybackControlsRow` being displayed in `PlaybackGlueHost`.
PlaybackControlGlue	A helper class for managing a `PlaybackControlsRow` and `PlaybackGlueHost` that implements a recommended approach to handling standard playback control actions such as play/pause, fast forward/rewind at progressive speed levels, and skip to next/previous.

Known Indirect Subclasses

MediaControllerGlue, PlaybackBannerControlGlue, PlaybackTransportControlGlue

MediaControllerGlue	A helper class for implementing a glue layer for `MediaControllerCompat`.
PlaybackBannerControlGlue	A helper class for managing a `PlaybackControlsRow` being displayed in `PlaybackGlueHost`.
PlaybackTransportControlGlue	A helper class for managing a `PlaybackControlsRow` being displayed in `PlaybackGlueHost`, it supports standard playback control actions play/pause, and skip next/previous.

Base class for abstraction of media play/pause feature. A subclass of PlaybackGlue will contain implementation of Media Player or a connection to playback Service. App initializes PlaybackGlue subclass, associated it with a PlaybackGlueHost. PlaybackGlueHost is typically implemented by a Fragment or an Activity, it provides the environment to render UI for PlaybackGlue object, it optionally provides SurfaceHolder via SurfaceHolderGlueHost to render video. A typical PlaybackGlue should release resources (e.g. MediaPlayer or connection to playback Service) in onDetachedFromHost(). onDetachedFromHost() is called in two cases:

app manually change it using setHost(PlaybackGlueHost) call
When host (fragment or activity) is destroyed

In rare case if an PlaybackGlue wants to live outside fragment / activity life cycle, it may manages resource release by itself.

Summary

Nested classes
abstract	`PlayerCallback` Interface to allow clients to take action once the video is ready to play and start stop.

Public constructors
`<init>(context: Context!)` Constructor.

Public methods
open Unit	`addPlayerCallback(playerCallback: PlaybackGlue.PlayerCallback!)` Add a PlayerCallback.
open Context!	`getContext()` Returns the context.
open PlaybackGlueHost!	`getHost()`
open Boolean	`isPlaying()` Returns true if media is currently playing.
open Boolean	`isPrepared()` Returns true when the media player is prepared to start media playback.
open Unit	`next()` Goes to the next media item.
open Unit	`pause()` Pauses the media player.
open Unit	`play()` Starts the media player.
open Unit	`playWhenPrepared()` Starts play when `isPrepared()` becomes true.
open Unit	`previous()` Goes to the previous media item.
open Unit	`removePlayerCallback(callback: PlaybackGlue.PlayerCallback!)` Remove a PlayerCallback.
Unit	`setHost(host: PlaybackGlueHost!)` This method is used to associate a PlaybackGlue with the `PlaybackGlueHost` which provides UI and optional `SurfaceHolderGlueHost`.

Protected methods
open MutableList<PlaybackGlue.PlayerCallback!>!	`getPlayerCallbacks()`
open Unit	`onAttachedToHost(host: PlaybackGlueHost!)` This method is called attached to associated `PlaybackGlueHost`.
open Unit	`onDetachedFromHost()` This method is called when current associated `PlaybackGlueHost` is attached to a different `PlaybackGlue` or `PlaybackGlueHost` is destroyed .
open Unit	`onHostPause()` This method is called when `PlaybackGlueHost` is paused.
open Unit	`onHostResume()` This method is called when `PlaybackGlueHost` is resumed.
open Unit	`onHostStart()` This method is called when `PlaybackGlueHost` is started.
open Unit	`onHostStop()` This method is called when `PlaybackGlueHost` is stopped.

Public constructors

<init>

PlaybackGlue(context: Context!)

Constructor.

Public methods

addPlayerCallback

open fun addPlayerCallback(playerCallback: PlaybackGlue.PlayerCallback!): Unit

Add a PlayerCallback.

Parameters
`playerCallback`	PlaybackGlue.PlayerCallback!: The callback to add.

getContext

open fun