Media Object
The media object controls the background view, audio playback, and event trigger timing within a scene.
Configuration Location
Scene → Media → Create media objectIn dialogue scenes, individual media objects can also be created within dialogue lines as backgrounds for specific lines.
Properties
View
A video or image as the scene background. If no media is created, the previously loaded media persists.
Audio
Audio playback paired with an image view. Only effective when the view is an image.
Background Audio
Cross-scene background music. Unlike regular audio, background audio continues playing after the current scene ends and loops in subsequent scenes until replaced by a different background audio track.
Media Fit
Controls how the view is displayed on screen:
| Value | Description |
|---|---|
cover | Scales to fill while maintaining ratio; excess is cropped (default) |
contain | Scales to fit within the screen; may leave black bars |
fill | Stretches to fill; may distort |
none | Original size, centered |
scale-down | Chooses the smaller of none or contain |
Loop Start Time
The video loops between [this time — end]. Not set = no loop, stops after playback.
When playedTime is not set, the loop start time is treated as the playback-complete time.
Played Time
Precisely controls when events appear. When not set, events without a set appearance time will appear at video end or loop start.
Check playback status via story.played.
Duration
When the view is an image without audio, set a duration to control how long the scene stays (ms).