zui docs v0.0.5
GitHub ↗
Multimedia and capture Native Qt

Media Player

A stateful native media engine for playback, tracks, position, buffering, and device routing.

Usage

Ruby example

Paste this complete Builder example inside the app surface from the Quickstart. Replace illustrative asset paths with files from your project.

Ruby
player = media_player "assets/sequence.mp4", auto_play: true, loops: 1, volume: 0.8
API

Component properties

12 component-specific values, plus shared item and layout properties.

sourceSource configuration for Media Player.property
auto_playAuto play configuration for Media Player.property
playbackPlayback configuration for Media Player.property
loopsLoops configuration for Media Player.property
playback_ratePlayback rate configuration for Media Player.property
positionPosition configuration for Media Player.property
volumeVolume configuration for Media Player.property
mutedMuted configuration for Media Player.property
audio_deviceAudio device configuration for Media Player.property
commandCommand configuration for Media Player.property
command_revisionCommand revision configuration for Media Player.property
visibleVisible configuration for Media Player.property
Show 16 shared item properties
enabledopacityscalerotationzwidthheightfill_widthfill_heightpreferred_widthpreferred_heightminimum_widthminimum_heightmaximum_widthmaximum_heightlayout_alignment
Interaction

Events

Subscribe with on widget, :event and keep behavior in Ruby.

playNative event payload
pauseNative event payload
stopNative event payload
statusNative event payload
errorNative event payload
positionNative event payload
durationNative event payload
media_statusNative event payload
bufferNative event payload
progressNative event payload
tracksNative event payload