DE/playSound3D: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{DE/Client function}}
{{DE/Client function}}
Erstellt einen Sound und spielt ihn für den lokalen Spieler ab. [[DE/setElementPosition|setElementPosition]] kann benutzt werden, um den Sound zu positionieren.<br />
Erstellt ein [[Sound]] [[Element]] in der GTA Welt spielt ihn sofort ab für den lokalen Spieler. [[setElementPosition]] kann genutzt werden zum Positionieren des [[Sound]] Elements nachdem es erstellt wurde. Vergiss nicht [[setElementDimension]] nach der Erstellung zu benutzen, um es außerhalb in der Dimension 0 zu spielen.<br />
<br />
<br />
'''Beachte:''' Unterstützte Audio Formate sind MP3, WAV, OGG, RIFF, MOD, XM, IT und S3M.
{{Bemerkung|
 
*Die unterstützten Audio-Formate sind MP3, WAV, OGG, RIFF, MOD, XM, IT und S3M.
*Aus Performance Gründen wird empfohlen, wenn playSound3D für Effekte genutzt wird, die Audio Datei in einen Kanal (Mono) WAV zu konvertieren mit einer Beispielrate von 22050 Hz oder weniger. Bedenke auch ein Limit hinzuzufügen wie oft der Effekt abgespielt werden kann, z.B. alle 50ms
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">element playSound3D ( string soundPfad, float x, float y, float z, [ bool wiederholend = 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>
{{OOP||[[Sound|Sound3D]]}}
===Benötigte Argumente===
*'''soundPath:''' der Dateipfad zur Datei, die du spielen möchtest. (Die Sounddatei muss in der [[meta.xml]] Datei definiert sein mit dem <file /> Tag. Du kannst auch URLs statt Pfade nehmen. )
*'''soundURL:''' die URL. (In dieser Version muss die Datei nicht in der [[meta.xml]] definiert sein )
*'''x:''' eine Fließkommazahl, welche die X-Koordinate auf der Map repräsentiert.
*'''y:''' eine Fließkommazahl, welche die Y-Koordinate auf der Map repräsentiert.
*'''z:''' eine Fließkommazahl, welche die Z-Koordinate auf der Map repräsentiert.


===Benötigte Argumente===  
===Optionale Argumente===  
*'''soundPfad:''' Der [[DE/filepath|Dateipfad]] wo sich der Sound befindet.
{{DE/OptionalArg}}
*'''x:''' Eine Fließkommazahl, welche die X Koordinate in der Karte darstellt.
*'''looped:''' Ein [[boolean]] Wert, der angibt ob der Sound wiederholt werden soll. Um den Sound in Dauerschleife zu wiederholen, nutze ''true''.
*'''y:''' Eine Fließkommazahl, welche die Y Koordinate in der Karte darstellt.
{{New feature/item|3.0150|1.5||
*'''z:''' Eine Fließkommazahl, welche die Z Koordinate in der Karte darstellt
*'''throttled:''' Ein [[boolean]] Wert, der angibt ob der Sound gedrosselt werden soll (z.B. bei geringer Download Bandbreite). Um den Sound zu drosseln, nutze ''true''.
 
}}
===Optimale Argumente===
*'''looped:''' Ein [[DE/bool|bool]], welcher angibt, ob sich der Sound wiederholen soll. Standard: '''true'''.


===Rückgabe===
===Rückgabe===
Gibt ein Sound-Element zurück, wenn der Sound erfolgreich erstellt wurde, falls nicht ''false''.
Gibt ein [[Sound]] [[Element]] zurück wenn es erfolgreich erstellt wurde, ''false'' wenn nicht.


==Beispiel==  
==Beispiel==  
Dieses Beispiel erstellt ein Sound, der sich am Pier 69 in San Fierro befindet, und wiederholt.
Dieses Beispiel erstellt ein Sound in Dauerschleife am Pizza Shop. Der Pizza Shop ist in San Fierro am Pier 69
<section name="Example" class="client" show="true">
<section name="Beispiel" class="client" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function onResourceStart()
function onResourceStart()
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>
</section>
Dieses Beispiel spielt ein Internet Radio in der Grove Street ab.
<section name="Beispiel 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>
</syntaxhighlight>
</section>
</section>
Line 33: Line 51:
==Siehe auch==
==Siehe auch==
{{DE/Client_audio_functions}}
{{DE/Client_audio_functions}}
[[EN:playSound3D]]
[[AR:playSound3D]]
[[AR:playSound3D]]
[[DE:playSound3D]]
[[RU:playSound3D]]

Revision as of 12:51, 24 October 2016

Erstellt ein Sound Element in der GTA Welt spielt ihn sofort ab für den lokalen Spieler. setElementPosition kann genutzt werden zum Positionieren des Sound Elements nachdem es erstellt wurde. Vergiss nicht setElementDimension nach der Erstellung zu benutzen, um es außerhalb in der Dimension 0 zu spielen.

{{Bemerkung|

  • Die unterstützten Audio-Formate sind MP3, WAV, OGG, RIFF, MOD, XM, IT und S3M.
  • Aus Performance Gründen wird empfohlen, wenn playSound3D für Effekte genutzt wird, die Audio Datei in einen Kanal (Mono) WAV zu konvertieren mit einer Beispielrate von 22050 Hz oder weniger. Bedenke auch ein Limit hinzuzufügen wie oft der Effekt abgespielt werden kann, z.B. alle 50ms

Syntax

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 ] )

OOP Syntax Help! I don't understand this!

Method: Sound3D(...)


Benötigte Argumente

  • soundPath: der Dateipfad zur Datei, die du spielen möchtest. (Die Sounddatei muss in der meta.xml Datei definiert sein mit dem <file /> Tag. Du kannst auch URLs statt Pfade nehmen. )
  • soundURL: die URL. (In dieser Version muss die Datei nicht in der meta.xml definiert sein )
  • x: eine Fließkommazahl, welche die X-Koordinate auf der Map repräsentiert.
  • y: eine Fließkommazahl, welche die Y-Koordinate auf der Map repräsentiert.
  • z: eine Fließkommazahl, welche die Z-Koordinate auf der Map repräsentiert.

Optionale Argumente

HINWEIS: Bei der Verwendung von optionalen Argumenten, müssen alle Argumente vor dem gewünschten Argument bestimmt werden. Mehr Informationen unter Optionale Argumente.

  • looped: Ein boolean Wert, der angibt ob der Sound wiederholt werden soll. Um den Sound in Dauerschleife zu wiederholen, nutze true.
  • throttled: Ein boolean Wert, der angibt ob der Sound gedrosselt werden soll (z.B. bei geringer Download Bandbreite). Um den Sound zu drosseln, nutze true.

Rückgabe

Gibt ein Sound Element zurück wenn es erfolgreich erstellt wurde, false wenn nicht.

Beispiel

Dieses Beispiel erstellt ein Sound in Dauerschleife am Pizza Shop. Der Pizza Shop ist in San Fierro am Pier 69

Click to collapse [-]
Beispiel
function onResourceStart()
	local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true) 
end
addEventHandler("onClientResourceStart", resourceRoot, onResourceStart)

Dieses Beispiel spielt ein Internet Radio in der Grove Street ab.

Click to collapse [-]
Beispiel 2
addEventHandler( 'onClientResourceStart', resourceRoot,
	function( )
		local uSound = playSound3D( 'http://193.34.51.25:80', 2498, -1659, 12 ) 
		setSoundMaxDistance( uSound, 100 )
	end
)

Siehe auch