AR/getSoundVolume: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(getSoundVolume)
 
mNo edit summary
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Client function}}
{{Client function}}
This function is used to return the volume level of the specified [[sound]] element.
.تستخدم هذه الوظيفة لجلب مستوى الصوت لعنصر الصوت المحدد [[sound]] [[element]]
{{New_feature|3.0139|1.3.2|
{{New_feature|3.0139|1.3.2|
If the element is a player, this function will use the players voice.
اذا كان العنصر للاعب ستجلب الوظيفة صوت الاعب [[player]].
}}
}}
==Syntax==  
==تركيب الوظيفة==  
<syntaxhighlight lang="lua">float getSoundVolume ( element theSound )</syntaxhighlight>  
<syntaxhighlight lang="lua">float getSoundVolume ( element theSound )</syntaxhighlight>  


===Required Arguments===  
===الفرغات المطلوبة===  
*'''theSound:''' The [[sound]] element which volume you want to return.
*'''الصوت:''' .عنصر الصوت الذي تريد جلب منة مستوي صوت [[sound]]


===Returns===
===المعطيات===
Returns a [[float]] representing the volume level of the [[sound]] element, ''false'' if invalid arguments were passed.
* تعطي [[float]] تمثل مستوي لعنصر الصوت  [[sound]] [[element]] .
* تعطي false اذا كانت الفرغات المطلوبة غير صالحة


==Example==
==مثال==
This example creates a sound then outputs the volume for it.
يقوم المثال بتشغيل صوت واخراج نص في الدردشة بمستوي الصوت.
<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") -- تشغيل مقطع صوتي
outputChatBox("Wasted Sound volume: "..getSoundVolume(sound)) --outputs to the client the volume of the sound
outputChatBox("مستوي الصوت: "..getSoundVolume(sound)) -- اخراج مستوي الصوت في الدردشة
end
end -- اغلآق الوظيفة
addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) --add the event handler
addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) -- اضافة حدث للوضيفة
</syntaxhighlight>
</syntaxhighlight>


==Changelog==
==التغيرات==
{{ChangelogHeader}}
{{AR/ChangelogHeader}}
{{ChangelogItem|1.3.2|Added player element to use a players voice}}
{{ChangelogItem|1.3.2|اضافة خاصية التحكم بحجم صوت الآعب}}


==أنظر أيضاً==
==أنظر أيضاً==
{{AR/Audio_functions}}
{{AR/Audio_functions}}
[[hu:getSoundVolume]]
[[en:getSoundVolume]]
[[pt-br:getSoundVolume]]

Latest revision as of 23:25, 17 August 2021

.تستخدم هذه الوظيفة لجلب مستوى الصوت لعنصر الصوت المحدد sound element اذا كان العنصر للاعب ستجلب الوظيفة صوت الاعب player.

تركيب الوظيفة

float getSoundVolume ( element theSound )

الفرغات المطلوبة

  • الصوت: .عنصر الصوت الذي تريد جلب منة مستوي صوت sound

المعطيات

  • تعطي float تمثل مستوي لعنصر الصوت sound element .
  • تعطي false اذا كانت الفرغات المطلوبة غير صالحة

مثال

يقوم المثال بتشغيل صوت واخراج نص في الدردشة بمستوي الصوت.

function wasted (killer, weapon, bodypart) -- وضيفة
	local sound = playSound("sounds/wasted.mp3") -- تشغيل مقطع صوتي
	outputChatBox("مستوي الصوت: "..getSoundVolume(sound)) -- اخراج مستوي الصوت في الدردشة
end -- اغلآق الوظيفة
addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) -- اضافة حدث للوضيفة

التغيرات

الاصدار الوصف
1.3.2 اضافة خاصية التحكم بحجم صوت الآعب

أنظر أيضاً