PlaySound: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Client function}}
{{Client function}}
Creates a [[sound]] element and plays it immediately after creation for the local player.<br />
يمكنك سماع صوت او موسيقى في هذي الوظيفة للاعب نفسه.<br />
<br />
<br />
'''Note:''' The only supported audio formats are MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M and PLS(e.g. Webstream).
'''ملاحظة:''' MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M and PLS لا يقبل الصوت الا الصيغ التالية.


==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">element playSound ( string soundPath, [ bool looped = false ] )</syntaxhighlight>  
<syntaxhighlight lang="lua">element playSound ( string soundPath, [ bool looped = false ] )</syntaxhighlight>  


===Required Arguments===  
===الاشياء المطلوبة===  
*'''soundPath:''' The [[filepath]] or URL of the sound file you want to play. (Sound specified by filepath has to be predefined in the [[meta.xml]] file with <file /> tag.)
*'''soundPath:''' يمكنك وضع اسم ملف الصوت او رابط صوت مباشر. [يجب وضع اسم ملف الصوت في ملف الميتا حتى يتم قراءة الصوت
 
===Optional Arguments===
{{OptionalArg}}
*'''looped:''' A [[boolean]] representing whether the sound will be looped. To loop the sound, use ''true''. Loop is not available for streaming sounds, only for sound files.
 
===Returns===
Returns a [[sound]] element if the sound was successfully created, ''false'' otherwise.


==Example==
==Example==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function wasted (killer, weapon, bodypart)  
function wasted (killer, weapon, bodypart)  
local sound = playSound("sounds/wasted.mp3") --Play wasted.mp3 from the sounds folder
local sound = playSound("sounds/wasted.mp3") --هنا وضع مكان الصوت واسمه
setSoundVolume(sound, 0.5) -- set the sound volume to 50%
setSoundVolume(sound, 0.5) -- وهنا لارتفاع الصوت
end
end


addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) --add the event handler
addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) --هنا حدث اذا مات الاعب يبدأ الصوت
</syntaxhighlight>
</syntaxhighlight>



Revision as of 13:23, 2 October 2013

يمكنك سماع صوت او موسيقى في هذي الوظيفة للاعب نفسه.

ملاحظة: MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M and PLS لا يقبل الصوت الا الصيغ التالية.

Syntax

element playSound ( string soundPath, [ bool looped = false ] )

الاشياء المطلوبة

  • soundPath: يمكنك وضع اسم ملف الصوت او رابط صوت مباشر. [يجب وضع اسم ملف الصوت في ملف الميتا حتى يتم قراءة الصوت

Example

function wasted (killer, weapon, bodypart) 
	local sound = playSound("sounds/wasted.mp3") --هنا وضع مكان الصوت واسمه
	setSoundVolume(sound, 0.5) -- وهنا لارتفاع الصوت 
end

addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) --هنا حدث اذا مات الاعب يبدأ الصوت 

See Also