Video
The Video widget is a media player that plays video on an app screen.
Configure playback, stop, volume, playback speed, looping, and more, and show playback controls on top of the video.
Definition and role
The Video widget draws a player area that plays the video source you specify — network, file, or asset. Properties control automatic looping, volume and mute, playback speed, the start position, and whether the playback control UI appears.
- Category: Contents
- Default size: full width, height 200
- Default appearance in the editor: an empty area labeled
Media
Features
| Feature | Description |
|---|---|
| Video playback | Plays video from a network, file, or asset source. |
| Playback control | Sets the play or stop state (status), the start position (seek), and looping (loop). |
| Sound control | Sets the volume (volume) and mute (mute). |
| Playback speed | Adjusts the playback speed from 0.5 to 2.0×. |
| Control UI | Shows play/stop, a progress bar, volume, and speed controls on top of the video. |
| Visible area | Sets the area of the video to show (crop ratio, viewport). |
How to use
- Open the Contents category in the left widget palette.
- Drag and drop the Video item onto the canvas.
- In the properties panel on the right, set the video source (
media). - If needed, adjust
loop,volume,playBackRate,showControlUI, and more.
Properties
| Property | Description | Default | Value / Type |
|---|---|---|---|
media | Video source to play (network, file, or asset) | Not set | Media source |
loop | Replays automatically when playback ends | false (off) | true / false |
volume | Playback volume | 0.5 | Number 0.0–1.0 |
seek | Playback start position (percentage of the total length) | 0 | Number 0–99 |
playBackRate | Playback speed multiplier | 1.0 | Number 0.5–2.0 |
showControlUI | Whether the playback control UI is shown | true (shown) | true / false |
fullScreen | Whether full screen is available | true (available) | true / false |
mute | Whether the sound is muted | false (off) | true / false |
status | Playback state | Stop | Stop, Play |
viewport | Area of the video to show (crop ratio) | Full (x:0, y:0, width:1, height:1) | Viewport value |
Notes and tips
volume ranges from 0.0 to 1.0. When mute is on, no sound plays regardless of the volume value.
seek isn't measured in seconds — it's a percentage of the total length (0–99). For example, 50 starts playback halfway through the video.
Learn more
For the full Widget Control (Property, Method, Event) you use to drive this widget from a script, visit Video Widget Control.