RU/playSound3D: Difference between revisions

Revision as of 16:17, 30 January 2016

Создаёт sound елемент в мире GTA и воспроизводит его сразу после создания для локального игрока. setElementPosition можно использовать для установки позиции sound елемента после его создания. Помните о setElementDimension после создания если вам нужно воспроизвести в другом dimension (по-умолчанию 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, bool throttled = true ] )

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

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

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

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

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

Возвращает

Возвращает 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
)

См. Также

@@ Line 3: / Line 3: @@
 Создаёт [[sound]] елемент в мире GTA и воспроизводит его сразу после создания для локального игрока. [[setElementPosition]] можно использовать для установки позиции [[sound]] елемента после его создания. Помните о [[setElementDimension]] после создания если вам нужно воспроизвести в другом dimension (по-умолчанию 0).<br />
 <br />
-'''Примечание:''' Эта функция подерживает только форматы MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M.
+{{Примечание|Эта функция подерживает только форматы 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, bool throttled = true ] )</syntaxhighlight>
 ===Обезательные Аргументы===
@@ Line 17: / Line 17: @@
 {{RU/OptionalArg}}
 *'''looped:''' Значения типа [[boolean]] указывает повторять ли воспроизведения полсле его окончания. Для повторения используйте ''true'' (по-умолчанию ''false'').
+*'''throttled:''' Значение типа [[boolean]] устанавливает будет ли качество звука урезаться (тем самым давать более быструю загрузку). Чтобы включить урезание качества звука нужно использовать значение true. Качество звука будет урезано по-умолчанию только для URL.
 ===Возвращает===