Multi Theft Auto: Wiki - User contributions [en]

RU/playSound3D

2014-06-20T03:01:32Z

Serinc: Serinc moved page RU/PlaySound3D to RU/playSound3D

__NOTOC__
{{RU/Client function}}
Создаёт [[sound]] елемент в мире GTA и воспроизводит его сразу после создания для локального игрока. [[setElementPosition]] можно использовать для установки позиции [[sound]] елемента после его создания. Помните о [[setElementDimension]] после создания если вам нужно воспроизвести в другом dimension (по-умолчанию 0).<br />
<br />
'''Примечание:''' Эта функция подерживает только форматы MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M.

==Синтаксис==
<syntaxhighlight lang="lua">element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false ] )</syntaxhighlight>

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

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

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

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

==См. Также==
{{Client_audio_functions}}
[[AR:playSound3D]]
[[DE:playSound3D]]
[[EN:playSound3D]]

RU/playSound3D

2014-06-18T22:55:21Z

Serinc: Serinc moved page ?title=RU/PlaySound3D to RU/PlaySound3D over redirect

RU/playSound3D

2014-06-18T22:54:01Z

Serinc: Serinc moved page RU/PlaySound3D to ?title=RU/PlaySound3D

PlaySound3D

2014-06-18T22:51:45Z

Serinc: Add link to RU page.

__NOTOC__
{{Client function}}
Creates a [[sound]] element in the GTA world and plays it immediately after creation for the local player. [[setElementPosition]] can be used to move the [[sound]] element around after it has been created. Remember to use [[setElementDimension]] after creating the sound to play it outside of dimension 0.<br />
<br />
'''Note:''' The only supported audio formats are MP3, WAV, OGG, RIFF, MOD, XM, IT and S3M.

==Syntax==
<syntaxhighlight lang="lua">element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false ] )</syntaxhighlight>

===Required Arguments===
*'''soundPath:''' The [[filepath]] to the sound file you want to play. (Sound file has to be predefined in the [[meta.xml]] file with <file /> tag. And also can use url instead of [[filepath]] )
*'''x:''' A floating point number representing the X coordinate on the map.
*'''y:''' A floating point number representing the Y coordinate on the map.
*'''z:''' A floating point number representing the Z coordinate on the map.

===Optional Arguments===
{{OptionalArg}}
*'''looped:''' A [[boolean]] representing whether the sound will be looped. To loop the sound, use ''true''.

===Returns===
Returns a [[sound]] element if the sound was successfully created, ''false'' otherwise.

==Example==
This example creates a looping sound within a pizza shop. The pizza shop is in san fierro near pier 69
<section name="Example" class="client" show="true">
<syntaxhighlight lang="lua">
function onResourceStart()
local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true)
end
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()), onResourceStart)
</syntaxhighlight>
</section>
This example play internet radio in groove street.
<section name="Example 2" class="client" show="true" >
<syntaxhighlight lang="lua">
addEventHandler( 'onClientResourceStart', resourceRoot,
function( )
local uSound = playSound3D( 'http://193.34.51.25:80', 2498, -1659, 12 )
setSoundMaxDistance( uSound, 100 )
end
)
</syntaxhighlight>
</section>

==See Also==
{{Client_audio_functions}}
[[AR:playSound3D]]
[[DE:playSound3D]]
[[RU:playSound3D]]

RU/playSound3D

2014-06-18T22:50:53Z

Serinc: Добавил ссылку на EN Версию

RU/playSound3D

2014-06-18T22:47:05Z

Serinc: Русификация описания функции