RU/playSound3D: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{RU/Client function}}
{{RU/Client function}}
Создаёт [[sound]] елемент в мире GTA и воспроизводит его сразу после создания для локального игрока. [[setElementPosition]] можно использовать для установки позиции [[sound]] елемента после его создания. Помните о [[setElementDimension]] после создания если вам нужно воспроизвести в другом dimension (по-умолчанию 0).<br />
Создаёт [[звук|элемент звука]] в мире GTA и воспроизводит его для локального игрока сразу после создания. Для изменения позиции [[звук|элемента звука]] можно использовать [[RU/setElementPosition|setElementPosition]]. Не забывайте использовать [[RU/setElementDimension|setElementDimension]] после создания звука, чтобы воспроизвести его в другом измерении (по-умолчанию 0).<br />
<br />
<br />
{{Примечание|Эта функция подерживает только форматы MP3, WAV, OGG, RIFF, MOD, XM, IT и S3M.}}
{{Примечание|
{{Примечание|Для повышения производительности при использовании playSound3D для эффектов, которые будут воспроизведены много раз (например, выстрелы оружия), рекомендуется, конвертировать аудио файл в одноканальный (моно) WAV с частотой дискретизации 22050 Гц или менее. Кроме того, рекомендуется добавлять ограничение на частоту проигрывания эффекта, например один раз каждые 50 мс.}}
*Эта функция поддерживает только следующие форматы: MP3, WAV, OGG, RIFF, MOD, XM, IT и S3M.
*Для повышения производительности при использовании playSound3D для эффектов, которые будут воспроизведены много раз (например, выстрелы оружия), рекомендуется конвертировать аудио-файл в одноканальный (моно) WAV с частотой дискретизации 22050 Гц или менее. Кроме того, рекомендуется добавлять ограничение на частоту проигрывания эффекта, например один раз каждые 50 мс.}}
==Синтаксис==  
==Синтаксис==  
<syntaxhighlight lang="lua">element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false ] )</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>  
<syntaxhighlight lang="lua">element playSound3D ( string soundURL, float x, float y, float z, [ bool looped = false, bool throttled = true ] )</syntaxhighlight>  
 
{{RU/OOP||[[Sound|Sound3D]]}}
===Обезательные Аргументы===
===Обязательные аргументы===
*'''soundPath:''' [[filepath]] к файлу который нужно воспроизвести. (Файл должен быть указан в [[meta.xml]] в теге <file />.
*'''soundPath:''' [[Путь к файлу|путь к файлу]], который нужно воспроизвести. Файл должен быть указан в [[RU/Meta.xml|meta.xml]] в теге ''<file />''.
*'''soundURL:''' URL адрес, в этом варианте файл не нужно указывать в [[meta.xml]].
*'''soundURL:''' URL адрес. В этом случае файл не нужно указывать в [[RU/Meta.xml|meta.xml]].
*'''x:''' Кордината X в 3D пространстве мира GTA.
*'''x:''' Координата X в пространстве мира.
*'''y:''' Кордината Y в 3D пространстве мира GTA.
*'''y:''' Координата Y в пространстве мира.
*'''z:''' Кордината Z в 3D пространстве мира GTA.
*'''z:''' Координата Z в пространстве мира.


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


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


==Пример==  
==Пример==  
В этом примере создается повторяющейся звук внутри магазина пиццы. Магазин пиццы находится в San Fierro около пирса 69.
В этом примере создаётся повторяющийся звук внутри пиццерии. Она находится в San Fierro около пирса 69.
<section name="Example" class="client" show="true">
<section name="Example" class="client" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 31: Line 32:
local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true)  
local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true)  
end
end
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()), onResourceStart)
addEventHandler("onClientResourceStart", resourceRoot, onResourceStart)
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>
В этом примере создается поток интернет радио на groove street.
В этом примере создаётся поток интернет радио на Grove Street.
<section name="Example 2" class="client" show="true" >
<section name="Example 2" class="client" show="true" >
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addEventHandler( 'onClientResourceStart', resourceRoot,
addEventHandler("onClientResourceStart", resourceRoot,
function( )
function( )
local uSound = playSound3D( 'http://193.34.51.25:80', 2498, -1659, 12 )  
local uSound = playSound3D("http://193.34.51.25:80", 2498, -1659, 12)  
setSoundMaxDistance( uSound, 100 )
setSoundMaxDistance(uSound, 100)
end
end
)
)
Line 51: Line 52:
[[DE:playSound3D]]
[[DE:playSound3D]]
[[EN:playSound3D]]
[[EN:playSound3D]]
[[PT-BR:playSound3D]]

Latest revision as of 22:10, 18 August 2021

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

См. Также