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