Cordova - Media كوردوفا - ميديا

 Cordova - Media كوردوفا - ميديا

 الصفحة السابقة

الصفحة التالية  

يُستخدم المكون الإضافي للوسائط من كوردوفا لتسجيل الأصوات الصوتية وتشغيلها في تطبيقات كوردوفا.

الخطوة 1 - تثبيت البرنامج المساعد للوسائط

يمكن تثبيت البرنامج المساعد للوسائط عن طريق تشغيل الكود التالي في نافذة موجه الأوامر .

C:\Users\username\Desktop\CordovaProject>cordova plugin add cordova-plugin-media

الخطوة 2 - إضافة الأزرار

في هذا البرنامج التعليمي ، سننشئ مشغل صوتي بسيط. لنقم بإنشاء الأزرار التي نحتاجها في index.html .

<button id = "playAudio">PLAY</button>
<button id = "pauseAudio">PAUSE</button>
<button id = "stopAudio">STOP</button>
<button id = "volumeUp">VOLUME UP</button>
<button id = "volumeDown">VOLUME DOWN</button>

الخطوة 3 - إضافة مستمعين الحدث

نحتاج الآن إلى إضافة مستمعين للأحداث لأزرارنا داخل وظيفة onDeviceReady داخل index.js .

document.getElementById("playAudio").addEventListener("click", playAudio);
document.getElementById("pauseAudio").addEventListener("click", pauseAudio);
document.getElementById("stopAudio").addEventListener("click", stopAudio);
document.getElementById("volumeUp").addEventListener("click", volumeUp);
document.getElementById("volumeDown").addEventListener("click", volumeDown);

الخطوة 4 أ - وظيفة التشغيل

الوظيفة الأولى التي سنضيفها هي playAudio . نحن نحدد myMedia خارج الوظيفة لأننا نريد استخدامها في الوظائف التي سيتم إضافتها لاحقًا (إيقاف مؤقت ، وإيقاف ، و VolumeUp ، و volumeDown). يتم وضع هذا الرمز في ملف index.js .

var myMedia = null;
function playAudio() {
   var src = "/android_asset/www/audio/piano.mp3";

   if(myMedia === null) {
      myMedia = new Media(src, onSuccess, onError);

      function onSuccess() {
         console.log("playAudio Success");
      }

      function onError(error) {
         console.log("playAudio Error: " + error.code);
      }
   }
   myMedia.play();
}

يمكننا النقر فوق الزر PLAY لبدء تشغيل موسيقى البيانو من مسار src .

الخطوة 4 ب - وظائف الإيقاف المؤقت والإيقاف

الوظائف التالية التي نحتاجها هي pauseAudio و stopAudio .

function pauseAudio() {
   if(myMedia) {
      myMedia.pause();
   }
}

function stopAudio() {
   if(myMedia) {
      myMedia.stop(); 
   }
   myMedia = null;
}

الآن يمكننا إيقاف صوت البيانو مؤقتًا أو إيقافه عن طريق النقر فوق أزرار PAUSE أو STOP .

الخطوة 4 ج - وظائف الصوت

لضبط الحجم ، يمكننا استخدام طريقة setVolume . تأخذ هذه الطريقة معلمة بقيم من 0 إلى 1 . سنقوم بتعيين قيمة البداية على 0.5 .

var volumeValue = 0.5;
function volumeUp() {
   if(myMedia && volumeValue < 1) {
      myMedia.setVolume(volumeValue += 0.1);
   }
}

function volumeDown() {
   if(myMedia && volumeValue > 0) {
      myMedia.setVolume(volumeValue -= 0.1);
   }
}

بمجرد الضغط على VOLUME UP أو VOLUME DOWN ، يمكننا تغيير قيمة الحجم بمقدار 0.1 .

يوضح الجدول التالي الطرق الأخرى التي يوفرها هذا البرنامج المساعد.

لا	الطريقة والتفاصيل
1	getCurrentPosition إرجاع الموضع الحالي للصوت.
2	getDuration يعيد مدة الصوت.
3	play يستخدم لبدء أو استئناف الصوت.
4	pause يستخدم لإيقاف الصوت مؤقتًا.
5	release يحرر الموارد الصوتية لنظام التشغيل الأساسي.
6	seekTo تستخدم لتغيير موضع الصوت.
7	setVolume يستخدم لضبط حجم الصوت.
8	startRecord ابدأ في تسجيل ملف صوتي.
9	stopRecord توقف عن تسجيل ملف صوتي.
10	stop توقف عن تشغيل ملف صوتي.