AR/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__  
{{Client function}}
{{Client function}}
Creates a [[sound]] element in the GTA world and plays it immediately after creation for the local player. [[setElementPosition]] can be used to move the [[sound]] element around after it has been created.<br />
.3D بحيث ان يكون ملائم لعالم ال GTA تصنع صوت في عالم
 
.بعد ان يتم تكوين الصوت باستخدام الوظيفة GTA لتحريك الصوت في اي مكان في عالم [[setElementPosition]] يمكن استخدام
 
.بعد ان يتم تكوين الصوت لتشغيله في عالم وهمي [[setElementDimension]] تذكر ان تستخدم
<br />
<br />
<br />
'''Note:''' The only supported audio formats are MP3, WAV, OGG, RIFF, MOD, XM, IT and S3M.
MP3, WAV, OGG, RIFF, MOD, XM, IT and S3M :الصيغات المدعومة هي التالي :t'''ملاحظة'''


==Syntax==  
==Syntax==  
Line 9: Line 14:


===Required Arguments===  
===Required Arguments===  
*'''soundPath:''' The [[filepath]] to the sound file you want to play. (Sound file has to be predefined in the [[meta.xml]] file with <file /> tag. And also can use url instead of [[filepath]] )
*'''soundPath:''' ايضاً يمكنك وضع رابط صوت بدلاً من مسار الملف .<file /> بشعار [[meta.xml]] ملف الصوت يجب ان يكون معرف في ملف) t.مسار ملف الصوت الذي تريد تشغيله
*'''x:''' A floating point number representing the X coordinate on the map.
*'''x:''' لمكان الصوت في اللعبة xاحداثيات الـ
*'''y:''' A floating point number representing the Y coordinate on the map.
*'''y:''' لمكان الصوت في اللعبة yاحداثيات الـ
*'''z:''' A floating point number representing the Z coordinate on the map.
*'''z:''' لمكان الصوت في اللعبة zاحداثيات الـ


===Optional Arguments===  
===Optional Arguments===  
{{OptionalArg}}  
{{OptionalArg}}  
*'''looped:''' A [[boolean]] representing whether the sound will be looped. To loop the sound, use ''true''.
*'''looped:''' ([[Boolean]]) false او true هذه الخاصية تتمثل في سواء اكان الصوت متكرر او لا باستخدام


===Returns===
===Returns===
Returns a [[sound]] element if the sound was successfully created, ''false'' otherwise.
اذا لم يتم صنع الصوت بنجاح false تنتج المنت صوت اذا تم صنع الصوت بنجاح, أو تنتج


==Example==  
==Example==  
This example creates a looping sound within a pizza shop. The pizza shop is in san fierro near pier 69
San fierro هذا المثال يصنع صوت متكرر في محل بيتزا, محل البيتزا في
<section name="Example" class="client" show="true">
<section name="Example" class="client" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">

Revision as of 01:37, 6 November 2013

.3D بحيث ان يكون ملائم لعالم ال GTA تصنع صوت في عالم

.بعد ان يتم تكوين الصوت باستخدام الوظيفة GTA لتحريك الصوت في اي مكان في عالم setElementPosition يمكن استخدام

.بعد ان يتم تكوين الصوت لتشغيله في عالم وهمي setElementDimension تذكر ان تستخدم

MP3, WAV, OGG, RIFF, MOD, XM, IT and S3M :الصيغات المدعومة هي التالي :tملاحظة

Syntax

element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false ] )

Required Arguments

  • soundPath: ايضاً يمكنك وضع رابط صوت بدلاً من مسار الملف .<file /> بشعار meta.xml ملف الصوت يجب ان يكون معرف في ملف) t.مسار ملف الصوت الذي تريد تشغيله
  • x: لمكان الصوت في اللعبة xاحداثيات الـ
  • y: لمكان الصوت في اللعبة yاحداثيات الـ
  • z: لمكان الصوت في اللعبة zاحداثيات الـ

Optional Arguments

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: (Boolean) false او true هذه الخاصية تتمثل في سواء اكان الصوت متكرر او لا باستخدام

Returns

اذا لم يتم صنع الصوت بنجاح false تنتج المنت صوت اذا تم صنع الصوت بنجاح, أو تنتج

Example

San fierro هذا المثال يصنع صوت متكرر في محل بيتزا, محل البيتزا في

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

This example play internet radio in groove street.

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

أنظر أيضاً