This translation is community contributed and may not be up to date. We only maintain the English version of the documentation. Read this manual in English
Реализация звука в Defold проста, но мощна. Есть лишь две концепции, о которых необходимо знать:
sound_fx, тогда любой звук, принадлежащий к этой группе, может быть приглушен простым вызовом функции.Звуковые компоненты могут быть инстанцированы только на месте в игровом объекте. Создайте новый игровой объект, кликните на нем ПКМ, выберите Add Component ▸ Sound и нажмите OK.

Созданный компонент имеет набор свойств, которые должны быть настроены:

master.При правильной настройке компонента Sound можно заставить его воспроизвести звук, вызвав sound.play():
local play_id = sound.play("go#sound", {delay = 1, gain = 0.5, pan = -1.0, speed = 1.25})
Каждое воспроизведение — отдельный голос. sound.play() возвращает его числовой идентификатор воспроизведения (play_id); сохраните этот ID для управления отдельным голосом.
Звук будет продолжать воспроизводиться, даже если игровой объект, к которому принадлежал компонент Sound, будет удален. Можно вызвать sound.stop(), чтобы остановить звук (см. ниже).
Каждое сообщение, отправленное компоненту, заставляет его воспроизводить другой экземпляр звука, пока доступный звуковой буфер не будет заполнен и движок не выведет ошибки в консоль. Рекомендуется реализовать какой-либо механизм фильтрации и группировки звуков.
sound.set_gain() и sound.set_pan() принимают необязательный третий аргумент с play_id. Используйте ID, возвращённый sound.play(), и URL того же звукового компонента:
function init(self)
-- Сохранить ID голоса, который начнёт звучать через секунду.
self.voice_id = sound.play("go#sound", { delay = 1 })
-- Запустить ещё один голос на том же компоненте.
sound.play("go#sound")
-- Изменить только отложенный голос.
sound.set_gain("go#sound", 0.4, { play_id = self.voice_id })
sound.set_pan("go#sound", -0.5, { play_id = self.voice_id })
end
Эти адресные вызовы не меняют остальные голоса и значения усиления и панорамы компонента по умолчанию. Они работают для отложенных и приостановленных голосов, поэтому новые значения применяются при запуске или возобновлении голоса. Неизвестный ID или ID завершённого воспроизведения не оказывает эффекта.
Не указывайте play_id, чтобы обновить все голоса и значения компонента по умолчанию для будущего воспроизведения:
sound.set_gain("go#sound", 0.8)
sound.set_pan("go#sound", 0.0)
Передача { play_id = nil } также означает отсутствие ID. Если вы очищаете сохранённый ID при завершении воспроизведения, проверяйте, что он не равен nil, прежде чем использовать его для адресного обновления.
Если необходимо остановить воспроизведение звука, можно вызвать sound.stop():
sound.stop("go#sound")

Звуковая система имеет 4 уровня усиления:
sound.play() или при изменении усиления одного или всех голосов через вызов sound.set_gain().sound.set_group_gain().master. Может быть изменено с помощью sound.set_group_gain(hash("master"), gain).Когда в настройках проекта Sound включён параметр Use Linear Gain (по умолчанию), выходное усиление равно произведению этих четырёх усилений. Усиление 1.0 соответствует единичному усилению (0 dB). Если линейное усиление отключено, Defold применяет при микшировании нелинейную кривую, поэтому прямое перемножение четырёх уровней и приведённое ниже преобразование в децибелы не описывают итоговый уровень сигнала.
Любой звуковой компонент с указанным именем звуковой группы будет помещен в звуковую группу с этим именем. Если группа не указана, звук будет отнесен к группе master. Также можно явно задать звуковому компоненту группу master, что даст тот же эффект.
Имеется несколько функций для получения всех доступных групп, получения строки с именем, получения и установки усиления, среднеквадратичного (RMS, см. http://en.wikipedia.org/wiki/Root_mean_square) и пикового усиления. Также есть функция, позволяющая проверить, запущен ли музыкальный проигрыватель на целевом устройстве:
-- Если на этом iPhone/Android-устройстве воспроизводится звук, заглушить все
if sound.is_music_playing() then
for i, group_hash in ipairs(sound.get_groups()) do
sound.set_group_gain(group_hash, 0)
end
end
Группы идентифицируются с помощью хэш-значения. Строку имени можно получить с помощью sound.get_group_name(), которую можно использовать для отображения имен групп в инструментах разработки, например, в микшере для тестирования уровней групп.

Вы не должны писать код, который полагается на строковое значение звуковой группы, поскольку они недоступны в релизных сборках.
Когда параметр Use Linear Gain включён, положительное значение усиления преобразуется в децибелы по стандартной формуле:
db = 20 \times \log \left( gain \right)
for i, group_hash in ipairs(sound.get_groups()) do
-- Строка имени доступна только в отладке. В релизе возвращается "unknown_*".
local name = sound.get_group_name(group_hash)
local gain = sound.get_group_gain(group_hash)
-- Преобразовать в децибелы.
local db = 20 * math.log10(gain)
-- Получите RMS (среднеквадратичное значение коэффициента усиления). Левый и правый канал отдельно.
local left_rms, right_rms = sound.get_rms(group_hash, 2048 / 65536.0)
left_rmsdb = 20 * math.log10(left_rms)
right_rmsdb = 20 * math.log10(right_rms)
-- Получить пик усиления. Левый и правый отдельно.
left_peak, right_peak = sound.get_peak(group_hash, 2048 * 10 / 65536.0)
left_peakdb = 20 * math.log10(left_peak)
right_peakdb = 20 * math.log10(right_peak)
end
-- Группе "master" задать усиление +6 dB (math.pow(10, 6/20)).
sound.set_group_gain("master", 1.995)
В Defold 1.10.2 было исправлено давнее ослабление примерно на 3 dB в звуковом микшере. Если микс старого проекта компенсировал это ослабление и после обновления стал звучать громче, перенастройте общий параметр Sound ▸ Gain или усиление соответствующих групп.
Если игра воспроизводит один и тот же звук по событию, и это событие срабатывает часто, существует риск воспроизведения одного и того же звука два раза или более одновременно. Если это произойдет, звуки будут сдвинуты по фазе, что может привести к появлению очень заметных артефактов.

Самый простой способ решить эту проблему — построить шлюз, который будет фильтровать звуковые сообщения и не позволит воспроизводить один и тот же звук более одного раза в течение заданного интервала времени:
-- Не допустить воспроизведение одного и того же звука в течение интервала "gate_time".
local gate_time = 0.3
function init(self)
-- Сохранить таймеры воспроизведённых звуков в таблице и уменьшать их значения каждый кадр.
-- Удалять таймеры, когда они пробудут в таблице "gate_time" секунд.
self.sounds = {}
end
function update(self, dt)
-- Уменьшить значения сохранённых таймеров
for k,_ in pairs(self.sounds) do
self.sounds[k] = self.sounds[k] - dt
if self.sounds[k] < 0 then
self.sounds[k] = nil
end
end
end
function on_message(self, message_id, message, sender)
if message_id == hash("play_gated_sound") then
-- Воспроизводить только звуки, которых сейчас нет в таблице блокировки.
if self.sounds[message.soundcomponent] == nil then
-- Сохранить таймер звука в таблице
self.sounds[message.soundcomponent] = gate_time
-- Воспроизвести звук
sound.play(message.soundcomponent, { gain = message.gain })
else
-- Попытка воспроизвести звук заблокирована
print("gated " .. message.soundcomponent)
end
end
end
Чтобы использовать шлюз, достаточно отправить ему сообщение play_gated_sound и указать целевой звуковой компонент и усиление звука. Шлюз вызовет sound.play() с целевым звуковым компонентом, если шлюз открыт:
msg.post("/sound_gate#script", "play_gated_sound", { soundcomponent = "/sounds#explosion1", gain = 1.0 })
Не получится заставить шлюз слушать сообщения play_sound, поскольку это имя зарезервировано движком Defold. Вы получите неожиданное поведение, если будете использовать зарезервированные имена сообщений.
Звуками можно управлять во время выполнения с помощью ряда различных свойств (обращайтесь к документации по API). Следующими свойствами можно манипулировать с помощью go.get() и go.set():
gainnumber).pannumber). Панорамирование должно быть значением между -1 (-45 градусов влево) и 1 (45 градусов вправо).speednumber). Значение 1.0 — нормальная скорость, 0.5 — половина скорости и 2.0 — двойная скорость.soundhash). Путь к ресурсу может быть использован для изменения звука с помощью resource.set_sound(path, buffer). Пример:local boom = sys.load_resource("/sounds/boom.wav")
local path = go.get("#sound", "sound")
resource.set_sound(path, boom)
В файле game.project имеются несколько настроек проекта, относящихся к звуковым компонентам.
Также возможно использование потокового воспроизведения звуков.