إضافة حالة البطارية في كوردوفا

توفر هذه الإضافة تنفيذًا (implementation) لإصدارٍ قديمٍ من الواجهة البرمجية لأحداث حالة البطارية. تضيف هذه الإضافة الأحداث الثلاثة التالية إلى الكائن window:

• batterystatus
• batterycritical
• batterylow

يمكن للتطبيقات أن تستخدم window.addEventListener لإرفاق منصِتٍ (listener) لأيٍّ من الأحداث المذكورة أعلاه بعد اطلاق الحدث deviceready.

التثبيت

cordova plugin add cordova-plugin-battery-status‎

الكائن Status

الكائن الذي تعيده جميع أحداث هذه الإضافة يملك الخصائص التالية:

• level: عدد بين 0 و 100 يمثِّل نسبة شحن البطارية.
• isPlugged: قيمة منطقية توضح ما إن كان الجهاز موصولاً بالشاحن أم لا.

الحدث batterystatus

يُطلق هذا الحدث عندما تتغير نسبة شحن البطارية بنسبة1٪ على الأقل، أو عند توصيل الجهاز أو فصله. ويُعاد كائن يحتوي حالة بطارية. إليك المثال التالي:

window.addEventListener("batterystatus", onBatteryStatus, false);
function onBatteryStatus(status) {
    console.log("Level: " + status.level + " isPlugged: " + status.isPlugged);
}‎

المنصات المدعومة

• iOS
• أندرويد
• ويندوز
• المتصفحات (كروم، فايرفوكس، أوبرا)

ملاحظات خاصة بأندرويد

طريقة تقديم (implementation) أندرويد لهذا الحدث طماعة (greedy)، والاستخدام المُطوّل له سيستنزف بطارية الجهاز.

الحدث batterylow

يُطلق هذا الحدث عندما تصل نسبة شحن البطارية إلى العتبة الدنيا. قيمة العتبة تختلف من جهاز لآخر. ويعاد كائن يحتوي على حالة بطارية. اطلع على المثال التالي:

window.addEventListener("batterylow", onBatteryLow, false);
function onBatteryLow(status) {
    alert("Battery Level Low " + status.level + "%");
}‎

المنصات المدعومة

• iOS
• أندرويد
• ويندوز
• المتصفحات (كروم، فايرفوكس، أوبرا)

الحدث batterycritical

يُطلق هذا الحدث عندما تصل نسبة شحن البطارية إلى العتبة الحرجة. قيمة العتبة تختلف من جهاز لآخر. ويُعاد كائن يحتوي حالة البطارية. إليك المثال التالي عن الحدث batterycritical:

window.addEventListener("batterycritical", onBatteryCritical, false);
function onBatteryCritical(status) {
    alert("Battery Level Critical " + status.level + "%\nRecharge Soon!");
}‎

المنصات المدعومة

• iOS
• أندرويد
• الويندوز
• المتصفحات (كروم، فايرفوكس، أوبرا)

انظر أيضًا

• إضافة حالة الجهاز
• إضافة تحديد الموقع الجغرافي
• دليل تطوير الإضافات في كوردوفا

مصادر

• صفحة cordova-plugin-battery-status في توثيق كوردوفا الرسمي.