RU/playSound3D

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Создаёт элемент звука в мире 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
)

См. Также