Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

VideoStreamPlayer

Eredita: Control < CanvasItem < Node < Object

Un controllo utilizzato per la riproduzione video.

Descrizione

Un controllo utilizzato per la riproduzione di risorse VideoStream.

I formati video supportati sono Ogg Theora (.ogv, VideoStreamTheora) e qualsiasi formato esposto tramite un estensione in GDExtension.

Attenzione: Sul Web, la riproduzione video avrà prestazioni scadenti a causa della mancanza di ottimizzazioni in assembly specifiche per l'architettura.

Tutorial

Proprietà

int

audio_track

0

bool

autoplay

false

int

buffering_msec

500

StringName

bus

&"Master"

bool

expand

false

bool

loop

false

bool

paused

false

float

speed_scale

1.0

VideoStream

stream

float

stream_position

float

volume

float

volume_db

0.0

Metodi

float

get_stream_length() const

String

get_stream_name() const

Texture2D

get_video_texture() const

bool

is_playing() const

void

play()

void

stop()


Segnali

finished() 🔗

Emesso al termine della riproduzione.


Descrizioni delle proprietà

int audio_track = 0 🔗

  • void set_audio_track(value: int)

  • int get_audio_track()

La traccia audio incorporata da riprodurre.


bool autoplay = false 🔗

  • void set_autoplay(value: bool)

  • bool has_autoplay()

Se true, la riproduzione viene avviata quando la scena viene caricata.


int buffering_msec = 500 🔗

  • void set_buffering_msec(value: int)

  • int get_buffering_msec()

La durata in millisecondi da memorizzare nel buffer durante la riproduzione.


StringName bus = &"Master" 🔗

Il bus audio da usare per la riproduzione del suono.


bool expand = false 🔗

  • void set_expand(value: bool)

  • bool has_expand()

Se true, il video si adatta alle dimensioni del controllo. Altrimenti, le dimensioni minime del controllo saranno regolate automaticamente per adattarsi alle dimensioni del flusso video.


bool loop = false 🔗

  • void set_loop(value: bool)

  • bool has_loop()

Se true, il video si riavvia quando raggiunge la sua fine.


bool paused = false 🔗

  • void set_paused(value: bool)

  • bool is_paused()

Se true, il video è messo in pausa.


float speed_scale = 1.0 🔗

  • void set_speed_scale(value: float)

  • float get_speed_scale()

La scala di velocità attuale del flusso. 1.0 è la velocità normale, mentre 2.0 è una velocità doppia e 0.5 è una velocità dimezzata. Una scala di velocità di 0.0 mette in pausa il video, come impostare paused su true.


VideoStream stream 🔗

Il flusso video assegnato. Vedi la descrizione per i formati supportati.


float stream_position 🔗

  • void set_stream_position(value: float)

  • float get_stream_position()

La posizione attuale del flusso, in secondi.


float volume 🔗

  • void set_volume(value: float)

  • float get_volume()

Il volume audio come valore lineare.


float volume_db = 0.0 🔗

  • void set_volume_db(value: float)

  • float get_volume_db()

Il volume audio in dB.


Descrizioni dei metodi

float get_stream_length() const 🔗

La lunghezza del flusso attuale, in secondi.


String get_stream_name() const 🔗

Restituisce il nome del flusso video oppure "<No Stream>" se nessun flusso video è assegnato.


Texture2D get_video_texture() const 🔗

Restituisce il fotogramma attuale sotto forma di una Texture2D.


bool is_playing() const 🔗

Restituisce true se il video è in riproduzione.

Nota: il video è ancora considerato in riproduzione se messo in pausa durante la riproduzione.


void play() 🔗

Avvia la riproduzione del video dall'inizio. Se il video è in pausa, questo non lo farà riprendere.


void stop() 🔗

Arresta la riproduzione video e imposta la posizione del flusso su 0.

Nota: Sebbene la posizione del flusso sia impostata su 0, il primo fotogramma del flusso video non diventerà il fotogramma attuale.