VideoStreamPlayer

继承： Control < CanvasItem < Node < Object

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.

属性

方法

信号

finished ( )

Emitted when playback is finished.

属性说明

int audio_track = 0

• void set_audio_track ( value: int )
• int get_audio_track ( )

The embedded audio track to play.

bool autoplay = false

• void set_autoplay ( value: bool )
• bool has_autoplay ( )

If true, playback starts when the scene loads.

int buffering_msec = 500

• void set_buffering_msec ( value: int )
• int get_buffering_msec ( )

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

StringName bus = &"Master"

• void set_bus ( value: StringName )
• StringName get_bus ( )

Audio bus to use for sound playback.

bool expand = false

• void set_expand ( value: bool )
• bool has_expand ( )

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.

bool loop = false

• void set_loop ( value: bool )
• bool has_loop ( )

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

bool paused = false

• void set_paused ( value: bool )
• bool is_paused ( )

If true, the video is paused.

VideoStream stream

• void set_stream ( value: VideoStream )
• VideoStream get_stream ( )

The assigned video stream. See description for supported formats.

float stream_position

• void set_stream_position ( value: float )
• float get_stream_position ( )

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.

float volume

• void set_volume ( value: float )
• float get_volume ( )

Audio volume as a linear value.

float volume_db = 0.0

• void set_volume_db ( value: float )
• float get_volume_db ( )

Audio volume in dB.

方法说明

float get_stream_length ( ) const¹

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.

String get_stream_name ( ) const¹

Returns the video stream's name, or "<No Stream>" if no video stream is assigned.

Texture2D get_video_texture ( ) const¹

Returns the current frame as a Texture2D.

bool is_playing ( ) const¹

Returns true if the video is playing.

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

void play ( )

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

void stop ( )

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.