بالنسبة إلى الأجهزة التي تعمل بالإصدار 13 من نظام التشغيل Android أو الإصدارات الأحدث، يوفّر إطار عمل Android عنصر تحكّم متعدّد المستويات في قوة المصباح اليدوي. في الإصدار 12 من نظام التشغيل Android والإصدارات الأقدم، لا يتيح إطار العمل سوى تفعيل وضع المصباح اليدوي أو إيقافه. ومن خلال إتاحة التحكّم في قوة المصباح اليدوي على عدة مستويات، يمكن للأجهزة تفعيل حالات استخدام، مثل التحكّم في سطوع المصباح اليدوي استنادًا إلى ظروف الإضاءة وإرسال إشارات طلب المساعدة باستخدام تأثير ضوئي متقطع من خلال إرسال نبضات ضوئية سريعة متتالية. من المزايا الأخرى لهذه الميزة أنّها يمكن أن تحسّن عمر البطارية وأداءها، لأنّه ليس من الضروري أن يكون وضع المصباح قيد التشغيل دائمًا بأقصى قوة، ما قد يؤدي إلى حدوث حالات خفض الأداء الحراري.
واجهات برمجة التطبيقات العامة
يمكن للتطبيقات استخدام ميزة التحكّم في قوة ضوء المصباح من خلال واجهات برمجة التطبيقات العامة ومفاتيح خصائص الكاميرا التالية. لا تتطلّب واجهات برمجة التطبيقات هذه أي أذونات للوصول إلى الكاميرا لأنّه لا يتم الوصول إليها.
واجهات برمجة تطبيقات CameraManager
-
public void turnOnTorchWithStrengthLevel (String cameraId, int torchStrength): تضبط هذه السمة مستوى سطوع المصباح المرتبط بقيمةcameraIdالمحدّدة في وضع المصباح. إذا كان وضع المصباح اليدوي غير مفعّل وكانت قيمةtorchStrengthأكبر من أو تساوي1، سيتم تشغيل المصباح اليدوي بمستوى السطوع المحدّد فيtorchStrength. public int getTorchStrengthLevel (String cameraId): تعرض هذه السمة مستوى سطوع وحدة الفلاش المرتبطة بـcameraId.
مفاتيح CameraCharacteristics
FLASH_INFO_STRENGTH_MAXIMUM_LEVEL: أقصى مستوى سطوع يعلن HAL الخاص بالكاميرا عن هذه الميزة من خلال ضبط قيمة أكبر من1.FLASH_INFO_STRENGTH_DEFAULT_LEVEL: مستوى السطوع التلقائي لمصباح الإضاءة
التنفيذ
لاستخدام ميزة التحكّم في قوة ضوء المصباح على جهازك، استخدِم واجهات AIDL HAL التالية الخاصة بالكاميرا:
الموقع الجغرافي: /camera/device/aidl/android/hardware/camera/device/ICameraDevice.aidl
تأكَّد من أنّ تنفيذ طبقة تجريد الأجهزة (HAL) يعلن عن مفاتيح خصائص الكاميرا التالية لإتاحة ميزة التحكّم في سطوع المصباح اليدوي:
للحصول على مرجع لتنفيذ طبقة تجريد الأجهزة (HAL) للكاميرا التي تتيح التحكّم في قوة ضوء المصباح، يُرجى الاطّلاع على EmulatedCameraDeviceHWLImpl.cpp.
التحقُّق
للتحقّق من صحة تنفيذ ميزة التحكّم في قوة ضوء المصباح، نفِّذ اختبارات VTS وCTS التالية: