Inheritance #

VideoStreamPlayer
Table of contents

VideoStreamPlayer #

is_instantiable, Node, core, not_builtin_classes

A control used for video playback.

A control used for playback of VideoStream resources.

Supported video formats are Ogg Theora (.ogv, VideoStreamTheora) and any format exposed via a GDExtension plugin.

Warning: On Web, video playback will perform poorly due to missing architecture-specific assembly optimizations.

Members #

var audio_track: int = 0#

The embedded audio track to play.

var autoplay: bool = false#

If true, playback starts when the scene loads.

var buffering_msec: int = 500#

Amount of time in milliseconds to store in buffer while playing.

var bus: StringName = &"Master"#

Audio bus to use for sound playback.

var expand: bool = false#

If true, the video scales to the control size. Otherwise, the control minimum size will be automatically adjusted to match the video stream's dimensions.

var loop: bool = false#

If true, the video restarts when it reaches its end.

var paused: bool = false#

If true, the video is paused.

var stream: VideoStream#

The assigned video stream. See description for supported formats.

var stream_position: float#

The current position of the stream, in seconds.

Note: Changing this value won't have any effect as seeking is not implemented yet, except in video formats implemented by a GDExtension add-on.

var volume: float#

Audio volume as a linear value.

var volume_db: float = 0.0#

Audio volume in dB.

Methods #

const func get_stream_length() -> float#

The length of the current stream, in seconds.

Note: For VideoStreamTheora streams (the built-in format supported by Godot), this value will always be zero, as getting the stream length is not implemented yet. The feature may be supported by video formats implemented by a GDExtension add-on.

const func get_stream_name() -> String#

Returns the video stream's name, or "" if no video stream is assigned.

const func get_video_texture() -> Texture2D#

Returns the current frame as a Texture2D.

const func is_playing() -> bool#

Returns true if the video is playing.

Note: The video is still considered playing if paused during playback.

func play() -> void#

Starts the video playback from the beginning. If the video is paused, this will not unpause the video.

func stop() -> void#

Stops the video playback and sets the stream position to 0.

Note: Although the stream position will be set to 0, the first frame of the video stream won't become the current frame.

Annotations #

Constants #

Constructors #

Enums #

Operators #

Signals #

signal finished()#

Emitted when playback is finished.

Theme Items #

Tutorials #