بالنسبة إلى الأجهزة التي تعمل بالإصدار 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: مستوى السطوع التلقائي للمصباح
التنفيذ
لتفعيل ميزة التحكّم في قوة ضوء المصباح على جهازك، استخدِم واجهات ملف HAL لكاميرا AIDL التالية:
الموقع الجغرافي: /camera/device/aidl/android/hardware/camera/device/ICameraDevice.aidl
تأكَّد من أنّ عملية تنفيذ HAL تعلن عن خصائص الكاميرا التالية مفاتيح لتفعيل ميزة التحكّم في سطوع مصباح يدوي:
للحصول على مرجع لتنفيذ Camera HAL يتيح التحكّم في قوة ضوء المصباح،
يُرجى
الاطّلاع علىEmulatedCameraDeviceHWLImpl.cpp.
التحقُّق
للتحقّق من صحة تنفيذ ميزة التحكّم في قوة ضوء المصباح، عليك إجراء اختبارَي VTS وCTS التاليَين: