HU/playSound3D: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
Line 6: | Line 6: | ||
*Támogatott audió formátumok: MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M and PLS. | *Támogatott audió formátumok: MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M and PLS. | ||
*Teljesítményi okokból, mikor a playSound-ot használjuk egy effekt többszöri lejátszásánál (pl. fegyver lövés), javasoljuk, hogy az audiófájlokat egycsatornás WaV-ba konvertálja (mono), 22050-Hz, vagy kisebb mintavételi frekvenciával. Valamint érdemes hozzáadni egy limitet, ami szabályozza az effekt lejátszási gyakoriságát.}} | *Teljesítményi okokból, mikor a playSound-ot használjuk egy effekt többszöri lejátszásánál (pl. fegyver lövés), javasoljuk, hogy az audiófájlokat egycsatornás WaV-ba konvertálja (mono), 22050-Hz, vagy kisebb mintavételi frekvenciával. Valamint érdemes hozzáadni egy limitet, ami szabályozza az effekt lejátszási gyakoriságát.}} | ||
== | ==Szintaxis== | ||
<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> | ||
{{OOP||[[Sound|Sound3D]]}} | {{OOP||[[Sound|Sound3D]]}} | ||
=== | ===Kötelező argumentumok=== | ||
*'''soundPath:''' a lejátszani kívánt hang [[filepath|elérési helye]]. (A hangfájlt elő kell definiálni a [[meta.xml]] fájlban, <file /> taggel. És az [[filepath|elérési hely]] helyett az URL cím is használható ) | *'''soundPath:''' a lejátszani kívánt hang [[filepath|elérési helye]]. (A hangfájlt elő kell definiálni a [[meta.xml]] fájlban, <file /> taggel. És az [[filepath|elérési hely]] helyett az URL cím is használható ) | ||
*'''soundURL:''' az URL. (Ebben a verzióban a fájlt nem kell elő definiálni a [[meta.xml]]-ben ) | *'''soundURL:''' az URL. (Ebben a verzióban a fájlt nem kell elő definiálni a [[meta.xml]]-ben ) | ||
*'''x:''' | *'''x:''' A térképen az X koordinátát ábrázoló [[float|lebegőpontos]] szám. | ||
*'''y:''' | *'''y:''' A térképen az Y koordinátát ábrázoló [[float|lebegőpontos]] szám. | ||
*'''z:''' | *'''z:''' A térképen az Z koordinátát ábrázoló [[float|lebegőpontos]] szám. | ||
=== | ===Tetszőleges Argumentumok=== | ||
{{OptionalArg}} | {{OptionalArg}} | ||
*'''looped:''' a [[boolean]] representing whether the sound will be looped. To loop the sound, use ''true''. | *'''looped:''' a [[boolean]] representing whether the sound will be looped. To loop the sound, use ''true''. | ||
Line 24: | Line 24: | ||
}} | }} | ||
=== | ===Visszaadott értéks=== | ||
Returns a [[sound]] [[element]] if the sound was successfully created, ''false'' otherwise. | Returns a [[sound]] [[element]] if the sound was successfully created, ''false'' otherwise. | ||
== | ==Példa== | ||
This example creates a looping sound within a pizza shop. The pizza shop is in san fierro near pier 69 | 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"> | <section name="Example" class="client" show="true"> |
Revision as of 18:15, 21 July 2018
Egy hangelemet hoz létre a GTA világban, majd rögtön azután le is játsza azt a játékosnak.. a setElementPosition a hangelem mozgatásához használható a létrehozás után. Ne felejtse el használni a setElementDimension-t, miután létrehozta a hangot a lejátszáshoz a 0-ik dimenzión kívül.
Szintaxis
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(...)
Kötelező argumentumok
- soundPath: a lejátszani kívánt hang elérési helye. (A hangfájlt elő kell definiálni a meta.xml fájlban, <file /> taggel. És az elérési hely helyett az URL cím is használható )
- soundURL: az URL. (Ebben a verzióban a fájlt nem kell elő definiálni a meta.xml-ben )
- x: A térképen az X koordinátát ábrázoló lebegőpontos szám.
- y: A térképen az Y koordinátát ábrázoló lebegőpontos szám.
- z: A térképen az Z koordinátát ábrázoló lebegőpontos szám.
Tetszőleges Argumentumok
NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.
- looped: a boolean representing whether the sound will be looped. To loop the sound, use true.
- throttled: a boolean representing whether the sound will be throttled (i.e. given reduced download bandwidth). To throttle the sound, use true.
Visszaadott értéks
Returns a sound element if the sound was successfully created, false otherwise.
Példa
This example creates a looping sound within a pizza shop. The pizza shop is in san fierro near pier 69
Click to collapse [-]
Examplefunction onResourceStart() local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true) end addEventHandler("onClientResourceStart", resourceRoot, onResourceStart)
This example play internet radio in groove street.
Click to collapse [-]
Example 2addEventHandler( 'onClientResourceStart', resourceRoot, function( ) local uSound = playSound3D( 'http://193.34.51.25:80', 2498, -1659, 12 ) setSoundMaxDistance( uSound, 100 ) end )
See Also
- HU/getRadioChannel
- HU/getRadioChannelName
- HU/getSFXStatus
- HU/getSoundBPM
- HU/getSoundEffects
- HU/getSoundFFTData
- HU/getSoundLength
- HU/getSoundLevelData
- HU/getSoundMaxDistance
- HU/getSoundMetaTags
- HU/getSoundMinDistance
- HU/getSoundPan
- HU/getSoundPosition
- HU/getSoundProperties
- HU/getSoundSpeed
- HU/getSoundVolume
- HU/getSoundWaveData
- HU/isSoundPanningEnabled
- HU/isSoundPaused
- HU/playSFX
- HU/playSFX3D
- HU/playSound
- HU/playSound3D
- HU/playSoundFrontEnd
- HU/setRadioChannel
- HU/setSoundEffectEnabled
- HU/setSoundMaxDistance
- HU/setSoundMinDistance
- HU/setSoundPan
- HU/setSoundPanningEnabled
- HU/setSoundPaused
- HU/setSoundPosition
- HU/setSoundProperties
- HU/setSoundSpeed
- HU/setSoundVolume
- HU/stopSound
Fordította
Surge