AR/playSound3D: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(playSound3D)
 
mNo edit summary
 
(5 intermediate revisions by 2 users not shown)
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 و 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">
Line 45: Line 50:
==أنظر أيضاً==
==أنظر أيضاً==
{{AR/Audio_functions}}
{{AR/Audio_functions}}
{{Client_audio_functions}}
[[EN:playSound3D]]
[[DE:playSound3D]]
[[PT-BR:playSound3D]]

Latest revision as of 22:10, 18 August 2021

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

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

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

MP3 و WAV و OGG و RIFF و MOD و XM و IT و 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
)

أنظر أيضاً