HTML DOM Audio Object Properties

‎ويژگي هاي شئAudio

‎شئ اديو‎(Audio Object)‎ كه توسط امكانات جاوااسكريت ايجادويا قابل دسترسي ‎است، داراي ويژگي هاي خاص بوده كه توسط جاوااسكريت بسادگي مطابق الگوي شئ گرائي قابل ‎تنظيم بوده ويا قابل دسترسي است .اين اشياء نماينده هاي عنصر‎HTML <audio> tag‎ ‎ميباشند، و درصفحه ميتوان آنهارا توسط جاوااسكريپت مديريت نمود.

‎ويژگي هاي شئ اديو ـAudio Object Properties

ويژگي	شرح
autoplay	‎مشخص ميكند كه در صورت آماده بودن اديو، پخش شود.
audiotracks	‎يك شئAudio Tracklist رابرگشت ميدهد كه ترك هاي موجود اديو رانشان ميدهد . ‎اين شئ داراي ويژگيlenght ميباشد كه تعداد ترك را برگشت ميدهد .
bufferd	‎يك شئTimeRanges كه براي نمايش قسمت هاي بافر شده اديو ميباشد، برگشت ميشود.
contoroller	‎شئMediaController راكه نشان دهنده كنترلر رسانه فعلي يك اديواست برميگرداند.
crossOigin	‎تنظيماتCORS يك اديو را تنظيم ويابرگشت ميدهد .
controls	‎مشخص ميكند كه كنترل هاي دستگاه صوتي نمايش داده شود.مثل دكمه هاي (play/puse and etc)
currentSrc	url‎جاري اديو رابرگشت ميدهد .
currentTime	‎موقعيت پحش فعلي را دريك اديو برحسب ثانيه تنظيم ويابرگشت ميدهد.
defaultMuted	‎ويژگيdefaultMuted وضعيت پيش فرض بي صدا بودن اديو راتنظيم يا برگشت مي.دهد.
PlaybackRate	‎سرعت پخش پيش فرض اديو راتنظيم ويا برگشت ميدهد.
duration	‎طول زمان پخش اديو را برحسب ثانيه برگشت ميدهد.
ended	‎نشان ميدهد كه آيا پخش اديو پايان يافته ياخير
error	‎شئMediaError را براي نشان دادن وضعيت خطا ي پخش برميگرداند .
loop	‎مشخص ميكند كه پخش بايد تكرار شود.
mediaGroup	‎نام گروه رسانه اي را تنظيم ويا برگشت ميدهد
muted	‎پخش خاموش را مشخص ميكند
networkState	‎وضعيت شبكه فعلي يك اديورا برميگرداند.
paused	‎وضعيت توقف يا پخش يك اديو رابرگشت ميدهد.
playbackRate	‎شرعت پخش اديو را تنظيم ويابرگشت ميدهد.
played	‎يك شئTimeRanges رابرگشت ميدهد كه قسمت هاي يخش شده رانشان ميدهد.
preload	‎مشخص ميكند هنگام بارگذازي صفحه ،فايل صوتي بارگذاري شود يانه
readyState	‎وضعيت آمادگي فعلي يك اديو رابرگشت ميدهد.
seekable	‎يك شئTimeRanges رابرگشت ميدهد كه قسمت هاي قابل جستجوي يك اديو رانشان ميدهد .
seeking	‎نشان ميدهد كه آيا كاربر درحال حاضر دراديو جستجوميكند.
src	‎آدرس يوآرال فايل صوتي كه بايد پخش شود.
textTracks	‎يك شئTextTrackList رابرگشت ميدهد كه ترك هاي متني اديو رانشان ميدهد.
volume	‎ميزان صداي يك اديو راتنظيم يابرگشت ميدهد.

‎ويژگيAudio audioTracks

‎ويژگيAudio audioTracks شئTracklist اديو رابرگشت ميدهد.اين شئ نشان دهنده ترك هاي موجود ‎اديو ميباشد .هر ترك موجود در اديو بوسيله شئAudioTrack نمايش داده ميشود .

‎مثال ـ تعداد ترك هاي موجود دراديو دريافت ميشود.

var x = document.getElementById("myAudio").audioTracks.length;

‎توجه ـ درهيچ مرورگر اصلي پشتيباني نمي شود.

‎اگر عنصر اديوئي با‎id="myAudio‎"‎توسط جاوااسكريپت بصورت زير قابل دسترس است .

audioObject=document.getElementById("myAudio");

‎وروش استفاده از شئ فوق مطابق زيراست

audioObject..audioTracks

‎مقدار برگشتيReturn Value

‎نوع شئ	‎شرح
Audoio Tracklist	‎نشان دهنده ترك هاي موجود يك اديو وداراي ويژگي هاي زير ‎تعداد ترك موجودaudioTracks.length ‎دريافت شئ ترك‎audioTrack.getTrackById(id)‎ ‎دريافت شئ ترك باانديس آن‎audioTracks[‎index‎]‎ ‎توجه ـ انديس اولين ترك موجود‎0‎ است
audioTrack	‎نشان دهنده تركي از اديواست .ويژگي آن مطابق زير id‎ـ شناسه ترك برگشت ميشود. kind‎ـ نوع ترك برگشت مي شود . مانند نمونه مقادير زير "alternative","description","main", "translation", commentary", "" label‎ـ برچسب ترك اديو دريافت ميشود . language‎ـ زبان ترك اديو دريافت ميشود . enabled‎ـ وضعت ترك اديو تنظيم يا دريافت ميشود ‎(true/false)‎ .

‎نوع شئ

‎شرح

Audoio Tracklist

‎نشان دهنده ترك هاي موجود يك اديو وداراي ويژگي هاي زير

‎تعداد ترك موجودaudioTracks.length
‎دريافت شئ ترك‎audioTrack.getTrackById(id)‎
‎دريافت شئ ترك باانديس آن‎audioTracks[‎index‎]‎

‎توجه ـ انديس اولين ترك موجود‎0‎ است

audioTrack

‎نشان دهنده تركي از اديواست .ويژگي آن مطابق زير

id‎ـ شناسه ترك برگشت ميشود.
kind‎ـ نوع ترك برگشت مي شود . مانند نمونه مقادير زير
"alternative","description","main", "translation", commentary", ""
label‎ـ برچسب ترك اديو دريافت ميشود .
language‎ـ زبان ترك اديو دريافت ميشود .
enabled‎ـ وضعت ترك اديو تنظيم يا دريافت ميشود ‎(true/false)‎ .

‎ويژگيAudio autoplay

‎ويژگيAudio autoplay وضعيت پخش خودكار اديو را به محض بارگذاري تنظيم يا برگشت ميدهد. ‎اين ويژگي ،ويژگي عنصر‎<audio>‎ را نشان ميدهد .در هنگاميكه وجود داشته ‎باشد، به محض بارگذاري عنصر فوق ، پخش شروع ميگردد.

‎مثال ـ بررسي ميشود كه اديو بمحض آمادگي پخش شود . بصورت خودكار

var x = document.getElementById("myAudio").autoplay;

‎مقادير ويژگيAudio autoplay ـ مقادير آنtrue ياfalse استtrue . بمعني پخش خود كار اديو ‎بمحض آمده بودن وfalse پخش اديو از طريق كاربر دراولين مرحله.

‎مثال ـ با فعال نمودن پخش خودكار وبارگذاري دوباره ،اديو خودكار پخش ميشود.

var x = document.getElementById("myAudio");
x.autoplay = true;
x.load();

‎درمثال فوقX شئ اديو و دستور ‎x.autoplay=true‎ پخش خودكار رافعال نموده ودستور x.load‎شئ را مجدد بار گذاري ميكند .

‎مثال ـ روش ايجاد شئ اديو وتنظيم پخش خودكار آن

var x = document.createElement("AUDIO");

--(go to editor for change code and run)

‎در مثال فوق با كليك روي كليد تنظيمي شئ اديو ايجاد و بصورت خودكار اجرا ميشود.

‎صفحات مرتبط

HTML <audio>

‎ويژگيAudio buffered

‎ويژگيAudio buffered يك شئ TimeRanges برگشت ميدهد .اين شئ نشان دهنده محدوده بافر شده ‎كاربر رانشان ميدهد.

‎يك محدوده بافري ، محدوده زماني است كه اديو بافر شده است .درصورتيكه دراديو پرشي انجام ‎شود ، كاربر چندين محدوده بافري بدست مي آورد.

‎نكته ـ اين ويژگي فقط خواندني است.

‎مثال ـ اولين ناحيه بافر شده را بدست مي آورد.

var x = document.getElementById("myAudio");
document.getElementById("demo").innerHTML = "Start: " + x.buffered.start(0)
+ " End: " + x.buffered.end(0);

‎ويژگيAudio buffered شئي رابرگشت ميدهد كه نشان دهنده قسمت هاي بافر شده است .ويژگي هاي ‎مطابق زير است.

length‎ـ تعداد محدوده بافرينگ را مشخص ميكند .
‎start(‎index‎)‎ـ شروع ناحيه بافرينگ‎index‎
‎end(‎index‎)‎ـ پايان ناحيه بافرينگ ‎ index‎

‎نكته ـ شروع وپايان ناحيه بافرينگ موقعيت زماني آنها در اديواست.

‎ويژگيAudio Controller

‎ويژگيAudio Controller كنترل جاري يك رسانه اديو رابرگشت ميدهد .عنصراديو بصورت پيش فرض ‎داراي يك كنترلر رسانه نيست.

‎در صورتيكه كنترلر رسانه اي براي آن مشخص شود، ويژگي فوق آنرا بعنوان شئMediaController ‎برگشت ميدهد.

‎نكته ـ از ويژگيcontrols براي تنظيم ويا دريافت اينكه آيا يك اديو بايد كنترل هاي ويدوئي ‎استاندارد رانمايش دهد، استفاده نمائيد.

‎توجه ـ مرورگرهاي اصلي ويژگيAudio Controller را پشتيباني نمي كنند .

‎مثال ـ بررسي كنترلر رسانه براي اديو

var x = document.getElementById("myAudio").controller;

‎شئ‎‎audioObject‎.controller‎ كه نشان دهنده كنترلر رسانه اديواست، داراي ‎ويژگي ومتدهاي زيراست.

buffered‎ـ محدوده بافرينگ اديو رابرگشت ميدهد .

seekable‎ـ محدوده قابل جستجوي اديو برگشت ميشود .

duration‎ـ مدت زمان اديو رابرگشت ميدهد .

currentTime‎ـ موقعيت فعلي پخش در اديو رابرگشت ميدهد .

paused‎ـ وضعيت توقف اديورا برگشت ميدهد

‎play()‎‎ـ شروع پخش اديو

‎pause()‎‎ـ پخش را متوقف ميكند .

play‎ـ وضعيت پخش اديو رابرگشت ميدهد .

defaultPlaybackRate‎ـ سرعت پخش پيش فرض اديو رابرگشت ميدهد.

playbackRate‎ـ سرعت پخش اديو رابرگشت ميدهد .

volume‎ـ حجم صداي پخش اديو رابرگشت ميدهد .

muted‎ـ وضعيت پخش خاموش را برگشت ميدهد .

‎ويژگيAudio controls

‎ويژگيAudio controls وضعيت نمايش كنترلهاي استاندارد اديو را تنظيم ويا برگشت ميدهد . اين
‎ويژگي كنترل هاي عنصر اديو را منعكس ميكند .در صورت وجود ، مشخص ميكند كه بايد نمايش داده ‎شود.

‎كنترل هاي استاندارد اديو بايد شامل موارد زيرباشد.

play

pause

seeking

Volume

‎مثال ـ فعال كردن كنترل ها براي اديو

document.getElementById("myAudio").controls = true;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio><br> <button onclick="enableControls()" type="button">Enable controls</button> <button onclick="disableControls()" type="button">Disable controls</button> <button onclick="checkControls()" type="button">Check controls status</button> <script> var x = document.getElementById("myAudio"); function enableControls() { x.controls = true; x.load(); } function disableControls() { x.controls = false; x.load(); } function checkControls() { alert(x.controls); } </script> </body> </html>
--(go to editor for change code and run)

‎مثال ـ بررسي نمايش كنترلهاي اديو

var x = document.getElementById("myAudio").controls;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio> <p>Click the button to find out if the audio controls are displayed.</p> <button onclick="myFunction()">Try it</button> <p id="demo"></p> <script> function myFunction() { var x = document.getElementById("myAudio").controls; document.getElementById("demo").innerHTML = x; } </script> </body> </html>
--(go to editor for change code and run)

‎ويژگيAudio currentSrc

‎ويژگيAudio currentSrc آدرس URL اديوي جاري را برگشت ميدهد .اگر هيچ اديوئي تنظيم نشده ‎باشد، يك رشته تهي برگشت ميشود.

‎توجه ـ اين ويژگي فقط خواندني است.

‎نكته ـ از ويژگيsrc براي تنظيم URL يك فايل صوتي استفاده كنيد .

‎مثال ـ آدرسURL اديوي جاري برگشت ميشود .

var x = document.getElementById("myAudio").currentSrc;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio> <p>Click the button to get the URL of the current audio.</p> <button onclick="myFunction()">Try it</button> <p id="demo"></p> <script> function myFunction() { var x = document.getElementById("myAudio").currentSrc; document.getElementById("demo").innerHTML = x; } </script> </body> </html>
--(go to editor for change code and run)

‎اگر شئ اديو‎‎audioObject‎‎ باشد ويژگي مطابق فرمت زير بكارگرفته ميشود.

audioObject.currentSrc

‎مقدار برگشتي

‎رشته ايست كه نشان دهنده آدرسURL اديوي جاريست . محتوي برگشتي شامل پروتكل مثل ‎(http://)‎ميباشد .اگر اديوئي تنظيم نشده باشد، رشته تهي برگشت ميشود .

‎ويژگيAudio currentTime

‎ويژگيcurrentTime موقعيت فعلي ‎)‎ در ثانيه‎(‎پخش اديو را تنظيم ويا ‎برگشت ميدهد .هنگاميكه ويژگي تنظيم ميشود، اديو به موقعيت مشخص شده پرش ميكند.

‎مثال ـ موقعيت پخش را بيك ثانيه تنظيم ميكند.

document.getElementById("myAudio").currentTime = 1;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio><br> <button onclick="getCurTime()" type="button">Get current time position</button> <button onclick="setCurTime()" type="button">Set time position to 1 second</button> <script> var x = document.getElementById("myAudio"); function getCurTime() { alert(x.currentTime); } function setCurTime() { x.currentTime = 1; } </script> </body> </html>
--(go to editor for change code and run)

‎نكته ـ تنظيم موقعيت پخش به ثانيه مي باشد.

‎ويژگيAudio defaultMuted

‎ويژگيAudio defaultMuted وضعيت پخش پيش فرض اديو را درحالت بيصدائي تنظيم يابرگشت ‎ميدهد .تنظيم اين ويژگي فقط حالت پيش فرض بيصدا را تغييرميدهد ، نه وضعيت فعلي .براي تغيير ‎وضعيت خاموش فعلي، از ويژگيmuted اديو استفاده كنيد.

‎مثال ـ تنظيم اديود بصورت پيش فرض خاموش

document.getElementById("myAudio").defaultMuted = true;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio><br> <button onclick="getMuted()" type="button">Is the audio muted by default?</button> <button onclick="setToMuted()" type="button">Set audio to be muted by default, and reload video</button> <script> var x = document.getElementById("myAudio"); function getMuted() { alert(x.defaultMuted); } function setToMuted() { x.defaultMuted = true; x.load() } </script> </body> </html>
--(go to editor for change code and run)

‎پشتيباني مرورگرBrowser Support -‎

‎ويژگي

defaultMuted Yes Not Supported 11.0 6.0 Yes

‎ويژگيAudio defaultPlaybackRate

‎ويژگي فوق سرعت پخش پيش فرض اديو را تنظيم يا برگشت ميدهد.تنظيم اين ويژگي فقط سرعت ‎پخش پيش فرض را تغييرميدهد، نه سرعت پخش جاري را .براي تغيير در سرعت پخش جاري از ‎ويژگيplaybackRate استفاده كنيد .

‎مثال ـ اديو بصورت پيش فرض روي حركت آهسته تنظيم ميگردد.

document.getElementById("myAudio").defaultPlaybackRate = 0.5;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio><br> <button onclick="getPlaySpeed()" type="button">What is the default playback speed?</button> <button onclick="setPlaySpeed()" type="button">Set video to be play in slow motion</button> <script> var x = document.getElementById("myAudio"); function getPlaySpeed() { alert(x.defaultPlaybackRate); } function setPlaySpeed() { x.defaultPlaybackRate = 0.5; x.load(); } </script> </body> </html>
--(go to editor for change code and run)

‎پشتيباني مرورگرBrowser Support -‎

‎ويژگي

defaultPlaybackRate Yes Yes Yes Not supported Yes

‎مقادير ويژگي

‎بعضي از مثالهاي سرعت

‎1.0‎ـ سرعت معمول

‎0.5‎ـ سرعت نصف معمول يعني آهسته تر

‎2.0‎ـ دوبرابر معمول يعني سريعتر

‎-‎1.0‎ـ سرعت معمول به عقب

‎-‎0.5‎ـ نصف سرعت معمول به عقب

‎توجه ـ مقدار صفر براي سرعت پخش غيرقابل قبول ومنجر به خطا ميشود.

‎مثال ـ تنظيم سريعتر سرعت پيش فرض

document.getElementById("myAudio").defaultPlaybackRate = 2;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio><br> <button onclick="getPlaySpeed()" type="button">What is the default playback speed?</button> <button onclick="setPlaySpeed()" type="button">Set video to be play fast</button> <script> var x = document.getElementById("myAudio"); function getPlaySpeed() { alert(x.defaultPlaybackRate); } function setPlaySpeed() { x.defaultPlaybackRate = 2; x.load(); } </script> </body> </html>
--(go to editor for change code and run)

‎ويژگيAudio duration

‎ويژگي فوق طول اديو را برحسب تانيه برگشت ميدهد .اين ويژگي فقط خواندني است.

‎مثال ـ دريافت طول يك اديو

var x = document.getElementById("myAudio").duration;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio> <p>Click the button to get the exact length (duration) of the audio, in seconds.</p> <button onclick="myFunction()">Try it</button> <p id="demo"></p> <script> function myFunction() { var x = document.getElementById("myAudio").duration; document.getElementById("demo").innerHTML = x; } </script> </body> </html>
--(go to editor for change code and run)

‎ويژگيAudio ended

‎ويژگي فوق وضعيت پاياني اديو را برگشت ميدهد، كه پايان يافته يا نه .زمانيكه موقعيت پخش در ‎انتها باشد، اديو به پايان رسيده است .اين ويژگي فقط خواندني است.

‎مثال ـ بررسي پايان يافتن اديو.

var x = document.getElementById("myAudio").ended;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio> <p>Click the button to find out if the audio has ended.</p> <p><strong>Tip:</strong> Press play on the audio and click the "Try it" button at the beginning and at the end of the audio.</p> <button onclick="myFunction()">Try it</button> <p id="demo"></p> <script> function myFunction() { var x = document.getElementById("myAudio").ended; document.getElementById("demo").innerHTML = x; } </script> </body> </html>
--(go to editor for change code and run)

‎مقدار برگشتي براي پايان اديو‎‎true/false‎‎

‎ويژگيAudio error

‎ويژگي فوق يك شئMediaError برگشت ميدهد .شئ مذكور داراي ويژگيcode بوده كه حاوي
‎وضعيت خطاي اديو است .اين ويژگي فقط خواندني است.

‎مثال ـ دريافت وضعيت خطا در اديو.

var x = document.getElementById("myAudio").error.code;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="mov_broken.ogg" type="audio/ogg"> <source src="mov_broken.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio> <p>Click the button to get the error state of the audio.</p> <button onclick="myFunction()">Try it</button> <p id="demo"></p> <script> function myFunction() { let x = document.getElementById("myAudio").error.code; document.getElementById("demo").innerHTML = x; } </script> </body> </html>
--(go to editor for change code and run)

‎پشتيباني مرورگرBrowser Support -‎

‎ويژگي

error Not
supported 9.0 Not
supported Not
supported Not
supported

‎مقادير بازگشتي ـReturn Value

‎نوع ‎شرح

Number ‎ويژگيcode شئ Mediaerror عددي رانشان ميدهد .
‎كه وضعت خطاي اديو رانشان ميدهد.

MEDIA_ERR_ABORTED -1
‎فرايند واكشي توسط كاربرمتوقف شود

MEDIA_ERR_NETWORK -2
‎خطا درهنگام دانلو شدن بوجود آيد.

MEDIA_ERR_DECODE - 3
‎هنگام رمزگشائي رخ دهد.

MEDIA_ERR_SRC_NOT_SUPPORTED - 4
‎اديو پشتيباني نمي شود.

‎ويژگيAudio loop

‎ويژگي فوق تنظيم ويا برگشت ميدهد ، وضعيت اجراي دوباره اديو را .يعني هنگاميكه پخش به پايان ‎دوباره پخش تكرار شوديا نه.

‎اين ويژگي شئAudio همان ويژگيloop عنصر مرتبط‎HTML <audi>‎ است

‎درصورت وجود ، مشخص ميكند كه پس از اتمام پخش اديو، پخش مجدد بايد تكرار گردد.

‎مثال ـ ويژگيloop رابراي اديو مشخص ميكند .

document.getElementById("myAudio").loop = true;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio><br> <button onclick="enableLoop()" type="button">Enable loop</button> <button onclick="disableLoop()" type="button">Disable loop</button> <button onclick="checkLoop()" type="button">Check loop status</button> <script> var x = document.getElementById("myAudio"); function enableLoop() { x.loop = true; x.load(); } function disableLoop() { x.loop = false; x.load(); } function checkLoop() { alert(x.loop); } </script> </body> </html>
--(go to editor for change code and run)

‎مقادير اين ويژگي‎true/false‎ است .مقدار true بمعني اينكه پخش تكرار ميشود . ‎ومقدارfalse پخش تكرار نميگردد .

‎ويژگيAudio mediaGroup

‎ويژگي فوق نام گروه رسانه اي را كه اديو بخشي ازآن است تنظيم ميكند ويابرميگرداند .يك گروه ‎رسانه اي اجازه ميدهد دو وياچند عنصر‎<audio>‎ هماهنگ نگه داشته شوند .

‎مثال ـ يك گروه رسانه براي دوعنصر‎<audio>‎ تنظيم ميشود .

var x = document.getElementById("myAudio1"); var y = document.getElementById("myAudio2"); x.mediaGroup = "test"; y.mediaGroup = "test";

<!DOCTYPE html> <html> <body> <audio id="myAudio1" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio> <audio id="myAudio2" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio><br> <button onclick="setMedGroup()" type="button">Set media group for audios</button> <button onclick="getMedGroup()" type="button">Get media group for audios</button> <script> var x = document.getElementById("myAudio1"); var y = document.getElementById("myAudio2"); function setMedGroup() { x.mediaGroup = "test"; y.mediaGroup = "test"; } function getMedGroup() { alert("Audio 1 media group: " + x.mediaGroup + ". Audio 2 media group: " + y.mediaGroup); } </script> </body> </html>
--(go to editor for change code and run)

‎ويژگيAudio muted

‎ويژگيAudio muted وضعيت پخش خاموش اديو را تنظيم ويا برگشت ميدهد .ويژگي فوق مرتبط با ‎ويژگيmuted عنصري از HTML ‎<audio>‎ است . ‎هنگاميكه ويژگي برقرار باشد، پخش اديو بدون صدا است.

‎مثال ـ پخش با صداي خاموش ويا خاموش كردن صدا.

document.getElementById("myAudio").muted = true;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio><br> <button onclick="enableMute()" type="button">Mute sound</button> <button onclick="disableMute()" type="button">Enable sound</button> <button onclick="checkMute()" type="button">Check muted status</button> <script> var x = document.getElementById("myAudio"); function enableMute() { x.muted = true; } function disableMute() { x.muted = false; } function checkMute() { alert(x.muted); } </script> </body> </html>
--(go to editor for change code and run)

‎مقادير برگشتي ـReturn Values

‎مقدار ‎شرح

true/false ‎مشخص ميكند كه پخش اديو بايد بدون صدا باشد يا خير

true‎ـ نشان ميدهد كه پخش بدون صداست

false‎ـ نشان ميدهد كه پخش اديو باصداست

‎مثال ـ بررسي ميكند كه پخش بدون صداست

var x = document.getElementById("myAudio").muted;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls muted> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio><br> <p>Click the button to find out if the sound is on mute.</p> <button onclick="myFunction()">Try it</button> <p id="demo"></p> <script> function myFunction() { var x = document.getElementById("myAudio").muted; document.getElementById("demo").innerHTML = x; } </script> </body> </html>
--(go to editor for change code and run)

‎ويژگيAudio networkState

‎ويژگي فوق وضعيت فعال بودن شبكه جاري را براي اديو برگشت ميدهد .مقدار برگشتي براي وضعيت ‎ارقام‎(0,1,2,3)‎ ميباشد كه بدنبال تشريح ميشوند .

‎مثال ـ دريافت وضعيت شبكه فعلي اديو را دريافت ميكند.

var x = document.getElementById("myAudio").networkState;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls autoplay> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio> <p>Click the button to get the network state of the audio.</p> <button onclick="myFunction()">Try it</button> <p id="demo"></p> <script> function myFunction() { var x = document.getElementById("myAudio").networkState; document.getElementById("demo").innerHTML = x; } </script> </body> </html>
--(go to editor for change code and run)

‎نحوي استفاده ـSyntax

audioObject.networkState

‎مقدار برگشتي ـReturn value

‎نوع ‎شرح

Number ‎نشان دهنده وضعيت شبكه جاري براي عنصر اديو

‎NETWORKEMPTY_ 0‎اديو براي پخش آمادگي اوليه راندارد

NETWORK_IDLE _ 1
‎فعال است ومنبعي راانتخاب كرده است، اما از شبكه استفاده نمي كند

NETWORK_LOADING - 2 ‎مرورگر در حال دانلود اطلاعات است

NETWORK_NO_SOURCE - 3 ‎منبع اديوئي پيدانشده است

‎ويژگيAudio paused

‎ويژگي فوق وضعيت توقف پخش اديو رابرگشت ميدهد .درصورت توقفtrue برگشت و درحالت پخش false‎برگشت ميشود .ويژگي مذكور فقط خواندني است .

‎مثال ـ بررسي توقف اديو

var x = document.getElementById("myAudio").paused;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio> <p>Click the button to find out if the audio is paused.</p> <button onclick="myFunction()">Try it</button> <p id="demo"></p> <script> function myFunction() { var x = document.getElementById("myAudio").paused; document.getElementById("demo").innerHTML = x; } </script> </body> </html>
--(go to editor for change code and run)

‎ويژگيAudio playbackRate

‎ويژگي فوق سرعت پخش اديو را تنظيم ويا برگشت ميدهد.

‎مثال ـ اديو را براي پخش در روال آهسته تنظيم ميكند.

document.getElementById("myAudio").playbackRate = 0.5;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio><br> <button onclick="getPlaySpeed()" type="button">What is playback speed?</button> <button onclick="setPlaySpeed()" type="button">Set audio to be play in slow motion</button> <script> var x = document.getElementById("myAudio"); function getPlaySpeed() { alert(x.playbackRate); } function setPlaySpeed() { x.playbackRate = 0.5; } </script> </body> </html>
--(go to editor for change code and run)

‎پشتيباني مرورگرBrowser Support -‎

‎ويژگي

playbackRate 39 79 48 Not
supported 26

‎مقادير ويژگي ـProperty Values

‎بعضي از مثالهاي سرعت

‎1.0‎ـ سرعت معمول

‎0.5‎ـ سرعت نصف معمول يعني آهسته تر

‎2.0‎ـ دوبرابر معمول يعني سريعتر

‎-‎1.0‎ـ سرعت معمول به عقب

‎-‎0.5‎ـ نصف سرعت معمول به عقب

‎توجه ـ مقدار صفر براي سرعت پخش غيرقابل قبول ومنجر به خطا ميشود.

‎مثال ـ تنظيم اديو براي پخش سريع

document.getElementById("myaudio").playbackRate = 2;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio><br> <button onclick="getPlaySpeed()" type="button">What is playback speed?</button> <button onclick="setPlaySpeed()" type="button">Set audio to be play fast</button> <script> var x = document.getElementById("myAudio"); function getPlaySpeed() { alert(x.playbackRate); } function setPlaySpeed() { x.playbackRate = 2; } </script> </body> </html>
--(go to editor for change code and run)

‎ويژگيAudio played

‎ويژگيAudio played يك شئ TimeRanges رابراي اديو برگشت ميدهد .شئ فوق محدوده هاي ‎پخش شده از اديو را كه قبلا توسط كاربر پخش شده نشان ميدهد.

‎يك محدوده پخش شده ، محدوده زماني پخش شده اديو ميباشد .درصورتيكه پرش روي اديو انجام ‎گيرد، كاربر چند محدوده پخشي را دريافت ميكند.

‎مثال ـ اولين محدوده پخش شده را دريافت ميشود.

var x = document.getElementById("myAudio"); document.getElementById("demo").innerHTML = "Start: " + x.played.start(0) + " End: " + x.played.end(0)

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio> <p>Click the button to get the first played range (part) of the audio in seconds.</p> <button onclick="myFunction()">Try it</button> <p id="demo"></p> <script> function myFunction() { var x = document.getElementById("myAudio"); document.getElementById("demo").innerHTML = "Start: " + x.played.start(0) + " End: " + x.played.end(0); } </script> </body> </html>
--(go to editor for change code and run)

‎نكته ـ ويژگي فوق فقط خواندني است

‎مقداربرگشتي ـReturn Value

‎نوع ‎شرح

TimeRanges object ‎نمايش دهنده قسمت هاي پخش شده اديو
‎ويژگي هاي شئTimeRanges

length‎ـ تعداد نواحي پخش شده اديو

‎start(‎index‎)‎ـ موقعيت شروع ناحيه پخش شدهindex

‎end(‎index‎)‎ـ موقعيت پايان ناحيه پخش شده index

‎توجه ـ اولين محدوده پخش شده باindex=0 است .

‎ويژگيAudio preload

‎ويژگي فوق مقدار ويژگيpreload يك اديو را تنظيم يابرگشت ميدهد .ويژگي مذكور مشخص ميكند ‎كه آيا وچگونه نويسنده فكر ميكند كه اديو بايد هنگام بارگيري صفحه بارگذاري شود.

‎ويژگي پيش بارگذاري‎(preload)‎ به نويسنده اجازه ميدهد تا درمورد آنچه تفكر تجربه ‎مناسب است ، يه مرورگر اشاره نمايد .اين ويژگي مكن است دربعضي موارد ناديده گرفته شود.

‎توجه ـ اگر ويژگيautoplay فعال باشد ويژگي preload ناديده گرفته ميشود .

‎مثال ـ ويژگيpreload

var x = document.getElementById("myAudio").preload;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls preload="none"> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio> <p>Click the button to return the value of the preload attribute of the audio.</p> <button onclick="myFunction()">Try it</button> <p><b>Note:</b> The preload attribute is not supported in IE.</p> <p id="demo"></p> <script> function myFunction() { var x = document.getElementById("myAudio").preload; document.getElementById("demo").innerHTML = x; } </script> </body> </html>
--(go to editor for change code and run)

‎مقادير ويژگيAudio preload

‎مقدار ‎شرح
auto ‎مرورگر بايد كل اديو را هنگام بارگيري صفحه بارگذاري كند.

metadata ‎مرورگر بايد فقط فراداده هارا‎(metadata)‎ هنگام بارگيري صفحه، بارگذاري كند .

none ‎مرورگر نبايد اديو را هنگام بارگيري صفحه بارگذاري كند.

‎مثال ـ نمايشي ازنحوه تنظيم مقادير مختلف ويژگي

document.getElementById("myAudio").preload = "none"; document.getElementById("myaudio").preload = "auto";

<!DOCTYPE html> <html> <body> <p>Click the buttons to create an AUDIO element, one with preload set to "none", and one with preload set to "auto".</p> <button onclick="myFunction('none')">Audio without preload</button> <button onclick="myFunction('auto')">Audio with preload</button> <br> <script> function myFunction(p) { var x = document.createElement("AUDIO"); x.setAttribute("controls", "controls"); var y = document.createElement("SOURCE"); y.setAttribute("src", "horse.ogg"); y.setAttribute("type", "audio/ogg"); x.appendChild(y); var z = document.createElement("SOURCE"); z.setAttribute("src", "horse.mp3"); z.setAttribute("type", "audio/mpeg"); x.appendChild(z); // Set the preload property: x.preload = p; document.body.appendChild(x); } </script> </body> </html>
--(go to editor for change code and run)

‎ويژگيAudio readyState

‎ويژگي فوق وضعيت آمادگي فعلي اديو را رابرگشت ميدهد .ويژگيreadyState مشخص ميكند كه ‎اديو آماده پخش بوده ياخير.

‎توجه ـ ويژگي فوق فقط خواندني است.

‎مثال ـ وضعت آماده گي اديو را براي پخش مشخص ميكند.

var x = document.getElementById("myAudio").readyState; document.getElementById("demo").innerHTML = x;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio> <p>Click the button to get the current ready state of the audio.</p> <button onclick="myFunction()">Try it</button> <p id="demo"></p> <script> function myFunction() { var x = document.getElementById("myAudio").readyState; document.getElementById("demo").innerHTML = x; } </script> </body> </html>
--(go to editor for change code and run)

‎فرمت استفاده ـSyntax
audioObject.readyState

‎مقدار برگشتي ـReturn Value

‎نوع ‎شرح

Number ‎نشان دهنده وضعيت آمادگي عنصراديو

0=Have_NOTHING
‎هيچ اطلاعاتي دربلره آماده بودن يانبودن اديو وجود ندارد

1=HAVE_METADATA
‎فراداده اي‎(metadata)‎ براي اديو آماده است.

2=HAVE_CURRENT_DATA
‎داده هاي موقعيت فعلي پخش آماده است ولي‎frame/millisecond‎ بعدي وجود ندارد

3=HAVE_FUTURE_DATA
‎داده براي فريم فعلي وحداقل بعدي موجود است.

4=HAVE_ENOUGH_DATA
‎داده كافي براي پخش كافي است

‎ويژگيAudio seekable

‎ويژگيAudio seekable يك شئTimeRanges رابرگشت ميدهد .اين شئ محدوده هاي <>‎اديو كه براي كاربر قابل جستجواست، رانشان ميدهد.
‎يك محدوده قابل جستجو ، يك بازه زماني اديو بوده كه كاربر ميتواند به دنبال حركت موقعيت پخش <>‎درآن باشد.
‎براي فايل هاي صوتي غيراستريم‎(non-‎streamming)‎ اغلب ميتوان هرجائي ازاديو را ‎حتي قبل ازبافر شدن آن جستجو. كرد.

‎توجه ـ ويژگي فوق فقط خواندني است.

‎مثال ـ اولين محدوده قابل جستجو اديو برحسب ثانيه بدست مي آيد.

var x = document.getElementById("myAudio"); document.getElementById("demo").innerHTML = "Start: " + x.seekable.start(0) + " End: " + x.seekable.end(0);

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio> <p>Click the button to get the first seekable range (part) of the audio in seconds.</p> <button onclick="myFunction()">Try it</button> <p id="demo"></p> <script> function myFunction() { var x = document.getElementById("myAudio"); document.getElementById("demo").innerHTML = "Start: " + x.seekable.start(0) + " End: " + x.seekable.end(0); } </script> </body> </html>
--(go to editor for change code and run)

‎مقداربرگشتي ـReturn Value

‎نوع ‎شرح

TimeRanges object ‎نمايش دهنده قسمت هاي قابل جستجوي اديو
‎ويژگي هاي شئTimeRanges

length‎ـ تعداد نواحي قابل جستچوي اديو

‎start(‎index‎)‎ـ موقعيت شروع ناحيه قابل جسجويindex

‎end(‎index‎)‎ـ موقعيت پايان ناحيه قابل جستجويindex

‎توجه ـ اولين محدوده قابل جستجو باindex=0 است.

‎ويژگيAudio seeking

‎اگر كاربر درحال جستجو در فايل صوتي باشد، مقدار ويژگيseeking برگشت ميشود .عمل جستجو ‎هنگامي است كه انتقال يا پرش به موقعيت جديدي انجام گيرد.

‎ويژگي فوق فقط خواندني است.

‎مقادير ويژگي‎true/false‎ است .اگر جستجو انجام گيردtrue درغيراينصورت false

‎ويژگيAudio src

‎ويژگي فوق مقدارsrc يك اديو راتنظيم ويابرگشت ميدهد .ويژگي src محل ‎(URL)‎فايل ‎اديو را مشخص ميكند.

‎مثال ـ آدرس فايل اديو را برگشت ميدهد.

var x = document.getElementById("myAudio").src;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls src="horse.ogg"> </audio> <p>Click the button to get the URL of the audio.</p> <button onclick="myFunction()">Try it</button> <p id="demo"></p> <script> function myFunction() { let x = document.getElementById("myAudio").src; document.getElementById("demo").innerHTML = x; } </script> </body> </html>
--(go to editor for change code and run)

‎ويژگيAudio src در همه مرورگرهاي اصلي پشتيباني ميشود، اما ممكن است روي فرمت فايل ‎در بعضي پشتيباني نشود.

‎صفحات مرتبط

HTML src attribute

‎ويژگيAudio textTracks

‎ويژگيAudio textTracks يك شئ textTrackList برگشت ميدهد .شئ مذكور نشان دهنده ترك هاي ‎متني دريك اديو است.

‎هر ترك متني موجود با يك شئTextTrack نمايش داده ميشود.

‎مثال ـ تعداد ترك هاي موجود دريافت ميشود.

var x = document.getElementById("myAudio").textTracks.length;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> <track src="demo_sub.vtt"> Your browser does not support the audio element. </audio> <p>Click the button to get the number of available text tracks.</p> <button onclick="myFunction()">Try it</button> <p id="demo"></p> <script> function myFunction() { var x = document.getElementById("myAudio").textTracks.length; document.getElementById("demo").innerHTML = x; } </script> </body> </html>
--(go to editor for change code and run)

‎فرمت استفاده ـSyntax

audioObject.textTracks

‎مقدار برگشتي ـReturn Value

‎نوع ‎شرح

textTracklList
object ‎نمايش دهنده ترك هاي موجود در اديو
‎شئTextTrackList

length‎ـ تعداد ترك هاي متني در اديو

‎[‎index‎]‎ـ شئtextTrack مرتبط با انديس دريافت ميگردد .

‎توجه ـ اولين شئ ترك موجود باانديس صفراست

TextTrack
Object ‎نشان دهنده يك ترك متني است
‎ويژگي هاي شئTextTrack

kind‎ـ نوع ترك متني دريافت ميشود . مقادير زير
"subtitles" , "caption","descriptions","chapters", or "metadata"

lable‎ـ برچسب ترك متني دريافت ميشود .

language‎ـ دريافت زبان ترك متني

mode‎ـ دريافت يا تنظيم حالت اگر ترك فعال است .مقادير
"disabled" , "hidden" , "showing"

cues‎ـ ليست cues را ازشئ TextTrackCueList دريافت ميكند .

activeCues‎ـ ترك متني فعالcues را از شئTextTrackCueList دريافت ميكند .

‎addCue(‎cue‎)‎ـ يكcue به ليست cues اضافه ميشود .

‎removeCue(‎cue‎)‎ـ حذف يك cue ازليست

‎ويژگيAudio volume

‎ويژگي فوق ميزان صداي اديو راتنظيم يابرگشت ميدهد .مقدار آن بين‎[0 , 1]‎ است. ‎مقدار‎0‎ صداي خاموش ومقدار‎1‎ صداي بلندترين.

‎مثال ـ مقدار صداي اديو رابه‎20%‎ تنظيم ميكند .

document.getElementById("myAudio").volume = 0.2;

<!DOCTYPE html> <html> <body> <audio id="myAudio" controls> <source src="horse.ogg" type="audio/ogg"> <source src="horse.mp3" type="audio/mpeg"> Your browser does not support the audio element. </audio> <p>Click the buttons to get or set the volume of the audio player.</p> <button onclick="getVolume()" type="button">What is the volume?</button> <button onclick="setHalfVolume()" type="button">Set volume to 0.2</button> <button onclick="setFullVolume()" type="button">Set volume to 1.0</button> <script> var x = document.getElementById("myAudio"); function getVolume() { alert(x.volume); } function setHalfVolume() { x.volume = 0.2; } function setFullVolume() { x.volume = 1.0; } </script> </body> </html>
--(go to editor for change code and run)

Previous > <Next

‎مقدار	‎شرح
auto	‎مرورگر بايد كل اديو را هنگام بارگيري صفحه بارگذاري كند.
metadata	‎مرورگر بايد فقط فراداده هارا‎(metadata)‎ هنگام بارگيري صفحه، بارگذاري كند .
none	‎مرورگر نبايد اديو را هنگام بارگيري صفحه بارگذاري كند.

HTML DOM Audio Object Properties

‎ويژگي هاي شئAudio

‎ويژگي هاي شئ اديو ـAudio Object Properties

‎ويژگيAudio audioTracks

--(go to editor for change code and run)

audioObject=document.getElementById("myAudio");

audioObject..audioTracks

‎مقدار برگشتيReturn Value

‎ويژگيAudio autoplay

--(go to editor for change code and run)

--(go to editor for change code and run)

--(go to editor for change code and run)

‎صفحات مرتبط

‎ويژگيAudio buffered

--(go to editor for change code and run)

‎ويژگيAudio Controller

--(go to editor for change code and run)

‎ويژگيAudio controls

--(go to editor for change code and run)

--(go to editor for change code and run)

‎ويژگيAudio currentSrc

--(go to editor for change code and run)

audioObject.currentSrc

‎مقدار برگشتي

‎ويژگيAudio currentTime

--(go to editor for change code and run)

‎ويژگيAudio defaultMuted

--(go to editor for change code and run)

‎پشتيباني مرورگرBrowser Support -‎

‎ويژگيAudio defaultPlaybackRate

--(go to editor for change code and run)

‎پشتيباني مرورگرBrowser Support -‎

‎مقادير ويژگي

--(go to editor for change code and run)

‎ويژگيAudio duration

--(go to editor for change code and run)

‎ويژگيAudio ended

--(go to editor for change code and run)

‎ويژگيAudio error

--(go to editor for change code and run)

‎پشتيباني مرورگرBrowser Support -‎

‎مقادير بازگشتي ـReturn Value

‎ويژگيAudio loop

--(go to editor for change code and run)

‎ويژگيAudio mediaGroup

--(go to editor for change code and run)

‎ويژگيAudio muted

--(go to editor for change code and run)

‎مقادير برگشتي ـReturn Values

--(go to editor for change code and run)

‎ويژگيAudio networkState

--(go to editor for change code and run)

‎نحوي استفاده ـSyntax

audioObject.networkState

‎مقدار برگشتي ـReturn value

‎ويژگيAudio paused

--(go to editor for change code and run)

‎ويژگيAudio playbackRate

--(go to editor for change code and run)

‎پشتيباني مرورگرBrowser Support -‎

‎مقادير ويژگي ـProperty Values

--(go to editor for change code and run)

‎ويژگيAudio played

--(go to editor for change code and run)

‎مقداربرگشتي ـReturn Value

‎ويژگيAudio preload

--(go to editor for change code and run)

‎مقادير ويژگيAudio preload

--(go to editor for change code and run)

‎ويژگيAudio readyState

--(go to editor for change code and run)

‎فرمت استفاده ـSyntax

audioObject.readyState

‎مقدار برگشتي ـReturn Value

‎ويژگيAudio seekable

--(go to editor for change code and run)

‎مقداربرگشتي ـReturn Value

‎ويژگيAudio seeking

‎ويژگيAudio src

--(go to editor for change code and run)