דף זה תורגם על ידי Cloud Translation API.

שליטה בעוצמת הלפיד

במכשירי Android מגרסה 13 ואילך, Android framework מספקת שליטה רב-שלבית על עוצמת הלפיד. לחשבון Android מגרסה 12 ומטה, ה-framework מאפשר רק להפעיל או לכבות את מצב הפנס. באמצעות תמיכה בעוצמת הלפיד רב-שלבית בקרה, מכשירים יכולים להפעיל תרחישים לדוגמה, כמו שליטה בבהירות של פנס בהתאם לתנאי התאורה ושולח אותות לסיוע באמצעות אפקט מהבהב על ידי שליחת פעימות אור מהירות בשורה. עוד היתרון של תכונה זו הוא שהיכולת לשפר את חיי הסוללה ואת הביצועים לא תמיד צריך להפעיל את מצב הפנס בעוצמה המקסימלית מה שעלול להוביל לתנאים של ויסות נתונים (throttle) תרמי.

ממשקי API ציבוריים

האפליקציות יכולות להשתמש בתכונה 'בקרה על חוזק הלפיד' דרך מקשים של מאפייני מצלמה וממשקי API. לא נדרשות הרשאות גישה למצלמה כדי את ממשקי ה-API האלה כי אין גישה למצלמה.

ממשקי API של CameraManager

public void turnOnTorchWithStrengthLevel (String cameraId, int torchStrength): הגדרת רמת הבהירות של הפנס לפי הערך הנתון ערך cameraId במצב לפיד. אם מצב הפנס מושבת ואז torchStrength שווה לערך 1 או גדול ממנו, הפנס מופעל עם רמת העוצמה צוין ב-torchStrength.
public int getTorchStrengthLevel (String cameraId): מחזירה את רמת הבהירות של יחידת ה-Flash המשויכת ל-cameraId.

מקשי מאפייני המצלמה

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 הבאות: