RU/playSound3D

Создаёт элемент звука в мире GTA и воспроизводит его для локального игрока сразу после создания. Для изменения позиции элемента звука можно использовать setElementPosition. Не забывайте использовать setElementDimension после создания звука, чтобы воспроизвести его в другом измерении (по-умолчанию 0).

[[{{{image}}}|link=]]

Примечание: Эта функция поддерживает только следующие форматы: MP3, WAV, OGG, RIFF, MOD, XM, IT и S3M. Для повышения производительности при использовании playSound3D для эффектов, которые будут воспроизведены много раз (например, выстрелы оружия), рекомендуется конвертировать аудио-файл в одноканальный (моно) WAV с частотой дискретизации 22050 Гц или менее. Кроме того, рекомендуется добавлять ограничение на частоту проигрывания эффекта, например один раз каждые 50 мс.

Синтаксис

element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false ] )

element playSound3D ( string soundURL, float x, float y, float z, [ bool looped = false, bool throttled = true ] )

Синтаксис ООП Помогите! Я не понимаю, что это!

Метод: Sound3D(...)

Обязательные аргументы

• soundPath: путь к файлу, который нужно воспроизвести. Файл должен быть указан в meta.xml в теге <file />.
• soundURL: URL адрес. В этом случае файл не нужно указывать в meta.xml.
• x: Координата X в пространстве мира.
• y: Координата Y в пространстве мира.
• z: Координата Z в пространстве мира.

Дополнительные Аргументы

Примечание. При использовании необязательных аргументов Вам может потребоваться предоставить все аргументы перед тем аргументом, который Вы хотите использовать. Для более подробной информации ознакомьтесь с необязательными аргументами.

• looped: Значения типа boolean, указывающее повторять ли воспроизведения после его окончания. Чтобы включить повторение, используйте true.
• throttled: Значение типа boolean, указывающее будет ли качество звука сжиматься (тем самым давать более быструю загрузку). Чтобы включить сжатие качества, используйте true.

Возвращает

Возвращает элемент звука, если он был успешно создан, в противном случае false.

Пример

В этом примере создаётся повторяющийся звук внутри пиццерии. Она находится в San Fierro около пирса 69.

Click to collapse [-]

Example

function onResourceStart()
	local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true) 
end
addEventHandler("onClientResourceStart", resourceRoot, onResourceStart)

В этом примере создаётся поток интернет радио на Grove Street.

Click to collapse [-]

Example 2

addEventHandler("onClientResourceStart", resourceRoot,
	function( )
		local uSound = playSound3D("http://193.34.51.25:80", 2498, -1659, 12) 
		setSoundMaxDistance(uSound, 100)
	end
)

См. Также

• getRadioChannel
• getRadioChannelName
• getSFXStatus
• getSoundBPM

• getSoundBufferLength
• getSoundEffects
• getSoundFFTData
• getSoundLength
• getSoundLevelData
• getSoundMaxDistance
• getSoundMetaTags
• getSoundMinDistance
• getSoundPan
• getSoundPosition
• getSoundProperties
• getSoundSpeed
• getSoundVolume
• getSoundWaveData
• isSoundPanningEnabled
• isSoundPaused
• playSFX
• playSFX3D
• playSound
• playSound3D
• playSoundFrontEnd
• setRadioChannel
• setSoundEffectEnabled
• setSoundMaxDistance
• setSoundMinDistance
• setSoundPan
• setSoundPanningEnabled
• setSoundPaused
• setSoundPosition
• setSoundProperties
• setSoundSpeed
• setSoundVolume
• stopSound