HTML DOM Audio Object Methods

‎متدهاي شئAudio

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

‎درصفحه قبلي درمورد ويژگي هاي شئ اديو بحث گرديد .دراين صفحه متدهاي شئ اديو تشريح ميشوند. ‎درجدول زير متدها با آدرس بخش مربوطه آمده است .شرح كامل هرمتد دربخش داخلي آمده است.

‎متدهاي شئ اديو ـAudio Object Methods

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

‎متد‎Audio addTextTrack()‎‎

‎متد فوق يك شئTextTrack ايجاده كرده وبرگشت ميدهد .شئ ايجاد شده به ليست تركهاي عنصر ‎اديو مرتبط اضافه ميگردد

‎متد فوق درهيچكدام از مرورگرهاي اصلي پشتيباني نمي شود.

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

var x = document.getElementById("myAudio");
var y = x.addTextTrack("caption");
y.addCue(new TextTrackCue("Test text", 01.000, 04.000,"","","",true));

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

audioObject.addTexttrack(kind , label , language)

‎مقادير پارامتر ـParameter Values

‎متد‎Audio canPlayType()‎‎

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

‎متد‎canPlayType()‎‎ در جواب مقادير زير رابرگشت ميدهد. .

• ‎‎"probably‎"‎ـ مرورگر باحتمال زياد ازاين نوع اديو پشتيباتي ميكند .
• ‎‎"maybe‎"‎ـ مرورگرممكن است ازاين نوع پشتيباني كند .
• ‎‎"‎"‎ـ برگشتي رشته تهي، ازاين نوع مرورگرپشتيباني نميكند .

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

var x = document.createElement("AUDIO");
isSupp = x.canPlayType(vidType+';codecs="'+codType+'"');

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

‎متد
canPlayType()	Yes	9.0	Yes	Yes	Yes

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

audioObject.canPlayType(type)

‎مقادير پارامتر ـParameter Values

‎متد‎Audio play()‎‎

‎متدAudio play()‎ پخش اديوي جاري را شروع ميكند .

‎مثال ـ يك اديوي پخش با دكمه هايplay وpause اين اديو ويژگي .controls را ندارد .

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

function playAudio() {
  x.play();
}

function pauseAudio() {
  x.pause();
}

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

‎متد
play()	Yes	9.0	Yes	Yes	Yes

‎متد‎Audio pause()‎‎

‎متد‎pause()‎‎ اديوي درحال پخش را متوقف ميكند .موقعيت پخش درهمان حالت جاري ‎باقي ميماند .درصورت‎play()‎‎ مجدد، ازهمان موقعيت پخش ادامه مي يابد .

‎مثال ـ يك پخش اديوئي با دكمه هايplay و pause

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

function playAudio() {
  x.play();
}

function pauseAudio() {
  x.pause();
}

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

‎متد
pause()	Yes	9.0	Yes	Yes	Yes