AudioStreamPlayer2D

public uint AreaMask { get; set; }

Определяет, какие слои Area2D влияют на звук для эффектов реверберации и аудиошины. Области можно использовать для перенаправления AudioStreams так, чтобы они воспроизводились на определенной аудиошине. Примером того, как это можно использовать, является создание области «воды», чтобы звуки, воспроизводимые в воде, перенаправлялись через аудиошину, чтобы они звучали так, как будто они воспроизводятся под водой.

public float Attenuation { get; set; }

Громкость звука уменьшается с расстоянием, причем показатель степени равен этому показателю.

public bool Autoplay { get; set; }

Если true, звук воспроизводится при добавлении в дерево сцен.

public StringName Bus { get; set; }

Шина, на которой воспроизводится этот звук. Примечание: При установке этого свойства имейте в виду, что проверка соответствия данного имени существующей шине не выполняется. Это связано с тем, что макеты аудиошин могут быть загружены после установки этого свойства. Если данное имя не может быть разрешено во время выполнения, оно вернется к "Master".

public float MaxDistance { get; set; }

Максимальное расстояние при котором можно услышать аудио.

public int MaxPolyphony { get; set; }

Максимальное число одновременных голосов этого плеера. Новый Play при превышении лимита вытесняет самый старый голос. Используйте положительное значение; для одного управляемого музыкального потока задайте 1.

public float PanningStrength { get; set; }

Масштабирует силу панорамирования для этого узла, умножая базу ProjectSettings.audio/general/2d_panning_strength на этот коэффициент. Более высокие значения будут панорамировать аудио слева направо более драматично, чем более низкие значения.

public float PitchScale { get; set; }

Высота тона и темп звука как множитель частоты дискретизации аудиосэмпла.

public AudioServer.PlaybackType PlaybackType { get; set; }

Тип воспроизведения потокового проигрывателя. Если установлено значение, отличное от значения по умолчанию, будет принудительно выбран этот тип воспроизведения.

public bool Playing { get; set; }

Если true, звук воспроизводится или поставлен в очередь на воспроизведение (см. AudioStreamPlayer2D.Play).

public AudioStream Stream { get; set; }

Объект AudioStream для воспроизведения.

public bool StreamPaused { get; set; }

Приостанавливает существующие голоса или возобновляет их. Без голосов предварительная команда не сохраняется. В режиме Stream пауза делает IsPlaying() ложным, сохраняя HasStreamPlayback().

public float VolumeDb { get; set; }

Базовая громкость до затухания, в децибелах.

public float VolumeLinear { get; set; }

Базовый объем до затухания, как линейное значение. Примечание: Этот член изменяет AudioStreamPlayer2D.VolumeDb для удобства. Возвращаемое значение эквивалентно результату @GlobalScope.db_to_linear для AudioStreamPlayer2D.VolumeDb. Установка этого члена эквивалентна установке AudioStreamPlayer2D.VolumeDb на результат @GlobalScope.linear_to_db для значения.

public float GetPlaybackPosition();

Возвращает позицию последнего созданного голоса в секундах, а не общее время всех голосов. Между смешиваниями значение может меняться ступенчато. Для одного потока со скоростью 1 оценку можно уточнить временем после последнего mix; паузу, перемотку и задержку вывода учитывайте отдельно.

public AudioStreamPlayback GetStreamPlayback();

Возвращает объект AudioStreamPlayback, связанный с этим AudioStreamPlayer2D.

public bool HasStreamPlayback();

Проверяет, хранит ли плеер объекты воспроизведения, включая приостановленные. Это не признак слышимого сигнала: mute, расстояние или пауза могут давать тишину.

public bool IsPlaying();

В режиме Stream возвращает true для активно играющего голоса. На паузе false; для наличия сохранённого воспроизведения проверяйте HasStreamPlayback() или StreamPaused. Не отсекайте этим методом команду возобновления.

public void Play(float fromPosition = 0f);

Ставит звук в очередь для воспроизведения в следующем физическом кадре, начиная с указанной позиции from_position в секундах.

public void Seek(float toPosition);

Перезапускает плеер с заданной позиции в секундах только при активном воспроизведении. Останавливает прежние голоса и запускает новый с позиции. В режиме Stream на паузе или остановке ничего не делает. Для перемотки с сохранением паузы явно сохраните флаг, вызовите Stop(), Play(position) и восстановите StreamPaused.

public void Stop();

Остановка звука.

public event Action Finished;

Выдаётся, когда при обновлении удалён один или несколько естественно завершившихся голосов. Другие голоса могут ещё играть. Stop() и вытеснение по лимиту не означают естественное завершение; цикл не выдаёт этот сигнал на каждом круге.