RU/playSound3D: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Примечание и новый аргумент throttled)
No edit summary
Line 6: Line 6:
{{Примечание|Для повышения производительности при использовании playSound3D для эффектов, которые будут воспроизведены много раз (например, выстрелы оружия), рекомендуется, конвертировать аудио файл в одноканальный (моно) WAV с частотой дискретизации 22050 Гц или менее. Кроме того, рекомендуется добавлять ограничение на частоту проигрывания эффекта, например один раз каждые 50 мс.}}
{{Примечание|Для повышения производительности при использовании playSound3D для эффектов, которые будут воспроизведены много раз (например, выстрелы оружия), рекомендуется, конвертировать аудио файл в одноканальный (моно) WAV с частотой дискретизации 22050 Гц или менее. Кроме того, рекомендуется добавлять ограничение на частоту проигрывания эффекта, например один раз каждые 50 мс.}}
==Синтаксис==  
==Синтаксис==  
<syntaxhighlight lang="lua">element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false, bool throttled = true ] )</syntaxhighlight>  
<syntaxhighlight lang="lua">element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false ] )</syntaxhighlight>
<syntaxhighlight lang="lua">element playSound3D ( string soundURL, float x, float y, float z, [ bool looped = false, bool throttled = true ] )</syntaxhighlight>  


===Обезательные Аргументы===  
===Обезательные Аргументы===
*'''soundPath:''' [[filepath]] к файлу который нужно воспроизвести. (Файл должен быть указан в [[meta.xml]] в теге <file />. Так же можно использовать URL адрес вместо [[filepath]], тогда файл не нужно указывать в [[meta.xml]] )
*'''soundPath:''' [[filepath]] к файлу который нужно воспроизвести. (Файл должен быть указан в [[meta.xml]] в теге <file />.
*'''soundURL:''' URL адрес, в этом варианте файл не нужно указывать в [[meta.xml]].
*'''x:''' Кордината X в 3D пространстве мира GTA.
*'''x:''' Кордината X в 3D пространстве мира GTA.
*'''y:''' Кордината Y в 3D пространстве мира GTA.
*'''y:''' Кордината Y в 3D пространстве мира GTA.
*'''z:''' Кордината Z в 3D пространстве мира GTA.
*'''z:''' Кордината Z в 3D пространстве мира GTA.


===Дополнительные Аргументы===  
===Дополнительные Аргументы===
{{RU/OptionalArg}}  
{{RU/OptionalArg}}  
*'''looped:''' Значения типа [[boolean]] указывает повторять ли воспроизведения полсле его окончания. Для повторения используйте ''true'' (по-умолчанию ''false'').
*'''looped:''' Значения типа [[boolean]] указывает повторять ли воспроизведения полсле его окончания. Для повторения используйте ''true'' (по-умолчанию ''false'').
*'''throttled:''' Значение типа [[boolean]] устанавливает будет ли качество звука урезаться (тем самым давать более быструю загрузку). Чтобы включить урезание качества звука нужно использовать значение true. Качество звука будет урезано по-умолчанию только для URL.
*'''throttled:''' Значение типа [[boolean]] устанавливает будет ли качество звука урезаться (тем самым давать более быструю загрузку). Чтобы включить урезание качества звука нужно использовать значение true.


===Возвращает===
===Возвращает===

Revision as of 14:16, 26 July 2016

Создаёт sound елемент в мире GTA и воспроизводит его сразу после создания для локального игрока. setElementPosition можно использовать для установки позиции sound елемента после его создания. Помните о setElementDimension после создания если вам нужно воспроизвести в другом dimension (по-умолчанию 0).

[[{{{image}}}|link=|]] Примечание: Эта функция подерживает только форматы MP3, WAV, OGG, RIFF, MOD, XM, IT и S3M.
[[{{{image}}}|link=|]] Примечание: Для повышения производительности при использовании 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 ] )

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

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

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

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

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

Возвращает

Возвращает sound елемент если он был создан, 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", getResourceRootElement(getThisResource()), onResourceStart)

В этом примере создается поток интернет радио на groove 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
)

См. Также