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.

Checking the stable version of the documentation...

AudioStreamRandomizer

Eredita: AudioStream < Resource < RefCounted < Object

Incorpora un'insieme di flussi audio con spostamento del tono e del volume.

Descrizione

Sceglie un AudioStream casuale dal pool, a seconda della modalità di riproduzione, e applica una variazione casuale del tono e del volume durante la riproduzione.

Tutorial

Proprietà

PlaybackMode

playback_mode

0

float

random_pitch

1.0

float

random_pitch_semitones

0.0

float

random_volume_offset_db

0.0

AudioStream

stream_{index}/stream

float

stream_{index}/weight

1.0

int

streams_count

0

Metodi

void

add_stream(index: int, stream: AudioStream, weight: float = 1.0)

AudioStream

get_stream(index: int) const

float

get_stream_probability_weight(index: int) const

void

move_stream(index_from: int, index_to: int)

void

remove_stream(index: int)

void

set_stream(index: int, stream: AudioStream)

void

set_stream_probability_weight(index: int, weight: float)

Enumerazioni

enum PlaybackMode: 🔗

PlaybackMode PLAYBACK_RANDOM_NO_REPEATS = 0

Sceglie un flusso a caso in base ai pesi di probabilità scelti per ciascuno flusso, ma evita di riprodurre lo stesso flusso due volte consecutive quando possibile. Se nel pool è presente solo 1 suono, verrà riprodotto sempre lo stesso suono, consentendo effettivamente le ripetizioni.

PlaybackMode PLAYBACK_RANDOM = 1

Sceglie un flusso a caso in base ai pesi di probabilità scelti per ciascun flusso. Se nel pool è presente solo 1 suono, verrà riprodotto sempre lo stesso suono.

PlaybackMode PLAYBACK_SEQUENTIAL = 2

Riproduce i flussi nell'ordine in cui appaiono nel pool di flussi. Se nel pool è presente solo 1 suono, verrà riprodotto sempre lo stesso suono.

Descrizioni delle proprietà

PlaybackMode playback_mode = 0 🔗

Controlla il modo in cui l'AudioStreamRandomizer sceglie quale AudioStream riprodurre successivamente.

float random_pitch = 1.0 🔗

  • void set_random_pitch(value: float)

  • float get_random_pitch()

Il moltiplicatore di frequenza massimo possibile per la variazione casuale del tono. il tono verrà scelto a caso entro un intervallo compreso tra 1.0 / random_pitch e random_pitch. Un valore di 1.0 significa nessuna variazione. Un valore di 2.0 significa che il tono verrà randomizzato tra il doppio e la metà.

Nota: L'impostazione di questa proprietà imposta anche random_pitch_semitones.

float random_pitch_semitones = 0.0 🔗

  • void set_random_pitch_semitones(value: float)

  • float get_random_pitch_semitones()

La massima distanza possibile, in semitoni, della variazione casuale del tono. Un valore di 0.0 significa nessuna variazione.

Nota: Impostare questa proprietà imposta anche random_pitch.

float random_volume_offset_db = 0.0 🔗

  • void set_random_volume_offset_db(value: float)

  • float get_random_volume_offset_db()

L'intensità della variazione casuale del volume. Il volume sarà aumentato o diminuito di un valore casuale fino a random_volume_offset_db. Un valore di 0.0 significa nessuna variazione. Un valore di 3.0 significa che il volume sarà randomizzato tra -3.0 dB e +3.0 dB.

AudioStream stream_{index}/stream 🔗

L'AudioStream all'indice index.

Nota: index è un valore compreso nell'intervallo 0 .. streams_count - 1.

float stream_{index}/weight = 1.0 🔗

Il peso di probabilità dell'AudioStream all'indice index.

Nota: index è un valore compreso nell'intervallo 0 .. streams_count - 1.

int streams_count = 0 🔗

  • void set_streams_count(value: int)

  • int get_streams_count()

Il numero di flussi disponibili nell'insieme di flussi.

Descrizioni dei metodi

void add_stream(index: int, stream: AudioStream, weight: float = 1.0) 🔗

Inserisci un flusso nell'indice specificato. Se l'indice è minore di zero, l'inserimento avviene alla fine del pool sottostante.

AudioStream get_stream(index: int) const 🔗

Restituisce il flusso all'indice specificato.

float get_stream_probability_weight(index: int) const 🔗

Restituisce il peso di probabilità associato con il flusso all'indice indicato.

void move_stream(index_from: int, index_to: int) 🔗

Sposta un flusso da un indice all'altro.

void remove_stream(index: int) 🔗

Rimuove il flusso all'indice specificato.

void set_stream(index: int, stream: AudioStream) 🔗

Imposta l'AudioStream all'indice specificato.

void set_stream_probability_weight(index: int, weight: float) 🔗

Imposta il peso di probabilità del flusso all'indice specificato. Più è alto questo valore, maggiore è la probabilità che il randomizzatore scelga questo flusso durante le modalità di riproduzione casuale.