تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

التحكّم في قوة الكشاف

بالنسبة إلى الأجهزة التي تعمل بالإصدار 13 من نظام التشغيل Android أو إصدار أحدث، يوفّر إطار عمل Android عناصر تحكّم متعددة المستويات في قوة ضوء المصباح. في نظام التشغيل Android 12 والإصدارات الأقدم، يتيح إطار العمل تفعيل وضع الكشاف أو إيقافه فقط. ومن خلال التحكّم في قوة المصباح المتعدّد المستويات، يمكن للأجهزة الاستفادة من حالات استخدام، مثل التحكّم في سطوع ضوء الفلاش بناءً على ظروف الإضاءة وإرسال إشارات للمساعدة باستخدام تأثير وميض من خلال إرسال نبضات سريعة من الضوء على التوالي. تشمل فوائد هذه الميزة أيضًا إمكانية تحسين عمر البطارية والأداء، لأنّه ليس من الضروري دائمًا تفعيل وضع "مصباح يدوي" بأقصى طاقة، ما قد يؤدي إلى خفض الأداء بسبب الحرارة.

واجهات برمجة التطبيقات العامة

يمكن للتطبيقات استخدام ميزة التحكّم في قوة ضوء المصباح من خلال واجهتَي برمجة التطبيقات المفتتَحتَين التالية ومفاتيح سمات الكاميرا. لا يلزم الحصول على أذونات الكاميرا لاستخدام هذه واجهات برمجة التطبيقات لأنّها لا تتطلب الوصول إلى الكاميرا.

واجهات برمجة تطبيقات 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 التاليَين: