mediaplayer/io.github.kdroidfilter.composemediaplayer.mac/MacVideoPlayerState

MacVideoPlayerState

class MacVideoPlayerState : VideoPlayerState

macOS implementation of the video player state.

Handles media playback through a native AVFoundation player (via MacNativeBridge).

The architecture intentionally mirrors the Windows implementation 1:1 so the two platforms behave identically: a producer/consumer coroutine pair drives frames through a single-slot drop-oldest Channel, frames are deduplicated by content hash, triple-buffered Skia bitmaps avoid tearing, and the playback position is derived from each frame's timestamp rather than a separate polling loop. The one place macOS deliberately diverges is the aspect ratio: it uses AVFoundation's display aspect ratio (pixel-aspect-ratio / clean-aperture corrected) so anamorphic content renders correctly — see displayAspectRatio.

Constructors

MacVideoPlayerState

constructor()

Properties

aspectRatio

open override val aspectRatio: Float

availableSubtitleTracks

open override val availableSubtitleTracks: MutableList<SubtitleTrack>

currentSubtitleTrack

open override var currentSubtitleTrack: SubtitleTrack?

currentTime

open override val currentTime: Double

duration

open override val duration: Double

Returns the total duration of the media in seconds.

durationText

open override val durationText: String

Returns the total duration of the video as a formatted string.

error

open override val error: VideoPlayerError?

hasMedia

open override val hasMedia: Boolean

isFullscreen

open override var isFullscreen: Boolean

isLoading

open override var isLoading: Boolean

isPipActive

open var isPipActive: Boolean

isPipEnabled

open var isPipEnabled: Boolean

isPipSupported

open val isPipSupported: Boolean

isPlaying

open override val isPlaying: Boolean

Indicates whether the video is currently playing.

loop

open override var loop: Boolean

Specifies if the video should loop when it reaches the end.

metadata

open override val metadata: VideoMetadata

onPlaybackEnded

open override var onPlaybackEnded: () -> Unit?

Callback invoked when playback reaches the end of the media. Only called when loop is false. May be invoked from a background thread.

onRestart

open override var onRestart: () -> Unit?

Callback invoked when playback restarts from the beginning due to looping. Only called when loop is true. May be invoked from a background thread.

playbackSpeed

open override var playbackSpeed: Float

positionText

open override val positionText: String

Returns the current playback position as a formatted string.

sliderPos

open override var sliderPos: Float

Represents the current playback position as a value between 0.0 and 1000.0.

subtitleBackgroundColor

open override var subtitleBackgroundColor: Color

subtitlesEnabled

open override var subtitlesEnabled: Boolean

subtitleTextStyle

open override var subtitleTextStyle: TextStyle

userDragging

open override var userDragging: Boolean

Denotes whether the user is manually adjusting the playback position.

volume

open override var volume: Float

Controls the playback volume. Valid values are within the range of 0.0 (muted) to 1.0 (maximum volume).

Functions

clearCache

open fun clearCache()

Clears the shared video cache, removing all cached media data from disk.

clearError

open override fun clearError()

disableSubtitles

open override fun disableSubtitles()

dispose

open override fun dispose()

Releases all resources used by the video player (native players, coroutines, observers, etc.).

enterPip

open suspend fun enterPip(): PipResult

onResized

fun onResized(width: Int = 0, height: Int = 0)

openAsset

open fun openAsset(fileName: String, initializeplayerState: InitialPlayerState = InitialPlayerState.PLAY)

Opens a media file bundled with the application.

openFile

open override fun openFile(file: PlatformFile, initializeplayerState: InitialPlayerState = InitialPlayerState.PLAY)

openUri

open override fun openUri(uri: String, initializeplayerState: InitialPlayerState = InitialPlayerState.PLAY)

Opens a video file or URL for playback.

pause

open override fun pause()

Pauses video playback.

play

open override fun play()

Starts or resumes video playback.

restart

open fun restart()

Restarts playback from the beginning. Works reliably from any state, including when playback has ended.

seekFinished

open fun seekFinished()

Commits the seek after a user-driven seek interaction. Performs the actual seek on the player and ends the dragging state.

seekStart

open fun seekStart(value: Float)

Begins a user-driven seek interaction (e.g. slider drag). Updates the visual slider position without performing the actual seek on the player. Must be followed by seekFinished to commit the seek.

seekTo

open override fun seekTo(value: Float)

Seeks to a specific playback position. The value should be between 0.0 and 1000.0.

selectSubtitleTrack

open override fun selectSubtitleTrack(track: SubtitleTrack?)

stop

open override fun stop()

Stops playback and resets the player state.

toggleFullscreen

open override fun toggleFullscreen()