Show Video

Description

'show video <video_id> <mode> [with [properties]]'

The video action allows you to show videos on your novel in different modes.

Action ID: Video

Reversible: Yes

Requires User Interaction: No, unless the close property is not given, then the user will have to click once the video is over to advance.

Parameters

Name	Type	Description
mode	string	Defines what way you want to show the video like. Possible Values: modal - Shows the video as a immersive - Shows the video covering the full game screen background - Shows the video as a background for your characters fullscreen - Attempts to show the video in full screen, if permission is denied, it will fallback to the immersive mode.
video_id	string	The ID of a video asset previously defined.

Properties

The following is a comprehensive list of the properties available for you to modify certain behaviors of the video action.

Name	Type	Description
controls	No value required	Optional. Adding this property will make the video controls (play, pause, seeking) visible for the player.
close	No value required	Optional. Adding this property will make the video close itself once it's over.
loop	No value required	Optional. Adding this property will make the video loop. The close property will not have any effect if the loop property is added.

Assets Declarations

To play a video, you must first add the file to your assets/video/ directory and then declare it. To do so, Monogatari has an has a function that will let you declare all kinds of assets for your game.

Monogatari.assets ('videos', {
    '<video_id>': 'videoFileName'
});

Supported Formats

Each browser has it's own format compatibility. MP4 however is the format supported by most browsers.

If you wish to use other formats, you can check a compatibility table to discover what browsers will be able to play it.

Examples

Script

Monogatari.script ({
    'Start': [
        'show video flowerTimelapse modal'
        'end'
    ]
});

Video Assets

Monogatari.assets ('video', {
    '<video_id>': 'videoFileName'
});