ממשק API של תוספי Camera2

הערה: הדף הזה מתייחס לחבילה Camera2. אם האפליקציה לא דורשת תכונות ספציפיות ברמה נמוכה מ-Camera2, מומלץ להשתמש ב-CameraX. גם CameraX וגם Camera2 תומכים ב-Android מגרסה 5.0 (רמת API‏ 21) ואילך.

‫Camera2 מספק ממשק Extensions API לגישה לתוספים שיצרני המכשירים הטמיעו במכשירי Android שונים. כאן אפשר לעיין ברשימה של מצבי התוספים הנתמכים.

כאן אפשר לראות רשימה של מכשירים שתומכים בתוספים.

ארכיטקטורת התוספים

בתמונה הבאה מוצגת הארכיטקטורה של תוספי המצלמה.

איור 1. ארכיטקטורת Camera Extensions

אפליקציית Camera2 יכולה להשתמש בתוספים דרך Camera2 API. ‫Camera2 API מספק דרכים לשלוח שאילתות לגבי תוספים זמינים, להגדיר סשן של מצלמה עם תוספים ולתקשר עם ספריית ה-OEM של תוספי המצלמה. כך האפליקציה יכולה להשתמש בתוספים כמו "ראיית לילה", HDR, "אוטומטי", "אפקט בוקה" או "ריטוש פנים".

בדיקת התאימות של מצלמה ל-Camera2 Extensions API

קטע הקוד הבא בודק אם המכשיר תומך ב-Camera2 Extensions API. לא כל המכשירים תומכים בתוספים, ויכול להיות שהמכשיר תומך רק בחלק מהתוספים. קטע הקוד מחזיר רשימה של מזהי מצלמות תואמות שתומכות בתוספים למצלמה.

private fun getExtensionCameraIds(cameraManager: CameraManager): List<String> =
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        cameraManager.cameraIdList.filter { cameraId ->
            val characteristics = cameraManager.getCameraCharacteristics(cameraId)
            val extensionCharacteristics =
                cameraManager.getCameraExtensionCharacteristics(cameraId)
            val capabilities =
                characteristics.get(CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES)
            extensionCharacteristics.supportedExtensions.isNotEmpty() &&
                capabilities?.contains(
                    CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE
                ) ?: false
        }
    } else emptyList()

יצירת CameraExtensionSession באמצעות Camera2 Extensions API

כשמשתמשים ב-Camera2 Extensions API במכשירים תואמים, אפשר לגשת לתוספים מסוימים של המצלמה. בקטע הקוד הבא יש דוגמה לאיך ליצור CameraExtensionSession כדי להשתמש במצב צילום בלילה באפליקציה קיימת של Camera2.

private val captureCallbacks = object : CameraExtensionSession.ExtensionCaptureCallback() {
    // Implement Capture Callbacks.
}
private val extensionSessionStateCallback = object : CameraExtensionSession.StateCallback() {
    override fun onConfigured(session: CameraExtensionSession) {
        cameraExtensionSession = session
        try {
            val captureRequest =
                cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW).apply {
                    addTarget(previewSurface)
                }.build()
            session.setRepeatingRequest(
                captureRequest,
                Dispatchers.IO.asExecutor(),
                captureCallbacks
            )
        } catch (e: CameraAccessException) {
            Snackbar.make(
                previewView,
                "Failed to preview capture request",
                Snackbar.LENGTH_SHORT
            ).show()
            requireActivity().finish()
        }
    }

    override fun onClosed(session: CameraExtensionSession) {
        super.onClosed(session)
        cameraDevice.close()
    }

    override fun onConfigureFailed(session: CameraExtensionSession) {
        Snackbar.make(
            previewView,
            "Failed to start camera extension preview",
            Snackbar.LENGTH_SHORT
        ).show()
        requireActivity().finish()
    }
}

private fun startExtensionSession() {
    val outputConfig = arrayListOf(
        OutputConfiguration(stillImageReader.surface),
        OutputConfiguration(previewSurface)
    )
    val extensionConfiguration = ExtensionSessionConfiguration(
        CameraExtensionCharacteristics.EXTENSION_NIGHT,
        outputConfig,
        Dispatchers.IO.asExecutor(),
        extensionSessionStateCallback
    )
    cameraDevice.createExtensionSession(extensionConfiguration)
}

מקורות מידע נוספים

מידע נוסף זמין במאמר CameraExtensionCharacteristics ובדוגמאות הציבוריות ל-Camera2 Extensions API.