ארכיטקטורת CameraX

בדף הזה נסביר על הארכיטקטורה של CameraX, כולל המבנה שלה, איך לעבוד עם ה-API, איך לעבוד עם מחזורי חיים ואיך לשלב תרחישים לדוגמה.

מבנה CameraX

אפשר להשתמש ב-CameraX כדי ליצור ממשק עם מצלמת המכשיר באמצעות הפשטה שנקראת תרחיש לדוגמה. אלה התרחישים לדוגמה שאפשר להשתמש בהם:

  • Preview: מקבלת משטח להצגת תצוגה מקדימה, כמו PreviewView.
  • ניתוח תמונות: מספק מאגרים שנגישים למעבד (CPU), למשל לצורך ניתוח למידת מכונה.
  • צילום תמונה: צילום ושמירה של תמונה.
  • צילום וידאו: צילום וידאו ואודיו באמצעות VideoCapture

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

מודל API

כדי לעבוד עם הספרייה, צריך לציין את הפרטים הבאים:

  • התרחיש לדוגמה הרצוי עם אפשרויות הגדרה.
  • מה לעשות עם נתוני פלט על ידי צירוף מאזינים.
  • התהליך המתוכנן, למשל מתי להפעיל מצלמות ומתי ליצור נתונים, על ידי קישור התרחיש לדוגמה למחזורי החיים של ארכיטקטורת Android.

יש שתי דרכים לכתוב אפליקציית CameraX: CameraController (מצוינת אם אתם רוצים את הדרך הפשוטה ביותר להשתמש ב-CameraX) או CameraProvider (מצוינת אם אתם צריכים גמישות רבה יותר).

CameraController

CameraController מספק את רוב פונקציונליות הליבה של CameraX בכיתה. נדרש קוד הגדרה קצר, והוא מטפל במצלמה באופן אוטומטי אתחול, ניהול תרחישי שימוש, רוטציית יעדים, הקשה למיקוד, צביטה = שינוי מרחק התצוגה ועוד. מחלקת הבטון שמשתרעת על ידי CameraController היא LifecycleCameraController.

Kotlin

val previewView: PreviewView = viewBinding.previewView
var cameraController = LifecycleCameraController(baseContext)
cameraController.bindToLifecycle(this)
cameraController.cameraSelector = CameraSelector.DEFAULT_BACK_CAMERA
previewView.controller = cameraController

Java

PreviewView previewView = viewBinding.previewView;
LifecycleCameraController cameraController = new LifecycleCameraController(baseContext);
cameraController.bindToLifecycle(this);
cameraController.setCameraSelector(CameraSelector.DEFAULT_BACK_CAMERA);
previewView.setController(cameraController);

ערכי ברירת המחדל של UseCase עבור CameraController הם Preview,‏ ImageCapture ו-ImageAnalysis. כדי להשבית את ImageCapture או ImageAnalysis, או כדי להפעיל את VideoCapture, משתמשים ב-method‏ setEnabledUseCases().

לשימושים נוספים ב-CameraController אפשר לעיין ב דוגמה לסורק של קודי QR או סרטון בסיסי של CameraController.

CameraProvider

עדיין קל להשתמש ב-CameraProvider, אבל מכיוון שמפתח האפליקציה מטפל בחלק גדול מההגדרה, יש יותר הזדמנויות להתאים אישית את ההגדרות, למשל הפעלת סיבוב של תמונות הפלט או הגדרת הפורמט של תמונות הפלט ב-ImageAnalysis. אפשר גם להשתמש ב-Surface בהתאמה אישית כדי לאפשר תצוגה מקדימה של המצלמה לספק גמישות רבה יותר. לעומת זאת, כשמשתמשים ב- CameraController, PreviewView. שימוש בקוד Surface הקיים יכול להיות שימושי שכבר מוגדר כקלט בחלקים אחרים של האפליקציה.

מגדירים תרחישים לדוגמה באמצעות השיטות set() ומסיימים אותם באמצעות השיטה build(). כל אובייקט של תרחיש לדוגמה מספק קבוצה של ממשקי API ספציפיים לתרחיש לדוגמה. עבור למשל, התרחיש לדוגמה של צילום תמונה מספק הפעלת method takePicture().

במקום להשתמש באפליקציה שמבצעת הפעלות של שיטת הפעלה ועצירה ספציפיות onResume() ו-onPause(), האפליקציה מציינת מחזור חיים לשיוך המצלמה עם, באמצעות cameraProvider.bindToLifecycle(). מחזור החיים הזה מאפשר ל-CameraX לדעת מתי להגדיר את סשן הצילום במצלמה, ולוודא שסטטוס המצלמה ישתנה בהתאם למעברים במחזור החיים.

לשלבים להטמעה לכל תרחיש לדוגמה, ראו יישום של תצוגה מקדימה, ניתוח תמונות, תמונה צילום מסך וצילום וידאו

התרחיש לדוגמה של התצוגה המקדימה מתקשר עם Surface להצגה. אפליקציות יוצרות את תרחיש לדוגמה עם אפשרויות ההגדרה באמצעות הקוד הבא:

Kotlin

val preview = Preview.Builder().build()
val viewFinder: PreviewView = findViewById(R.id.previewView)

// The use case is bound to an Android Lifecycle with the following code
val camera = cameraProvider.bindToLifecycle(lifecycleOwner, cameraSelector, preview)

// PreviewView creates a surface provider and is the recommended provider
preview.setSurfaceProvider(viewFinder.getSurfaceProvider())

Java

Preview preview = new Preview.Builder().build();
PreviewView viewFinder = findViewById(R.id.view_finder);

// The use case is bound to an Android Lifecycle with the following code
Camera camera = cameraProvider.bindToLifecycle(lifecycleOwner, cameraSelector, preview);

// PreviewView creates a surface provider, using a Surface from a different
// kind of view will require you to implement your own surface provider.
preview.previewSurfaceProvider = viewFinder.getSurfaceProvider();

דוגמאות נוספות לקוד זמינות באפליקציית הדוגמה הרשמית של CameraX.

מחזורי חיים של CameraX

CameraX עוקב אחרי מחזור חיים כדי לקבוע מתי לפתוח את המצלמה, מתי ליצור סשן צילום ומתי לעצור את הצילום ולסגור את המצלמה. ממשקי API לתרחישים לדוגמה מספקים קריאות לפעולה וקריאות חוזרות (callback) כדי לעקוב אחר ההתקדמות.

כפי שמוסבר בקטע שילוב תרחישים לדוגמה, אפשר לשייך שילובים מסוימים של תרחישים לדוגמה למחזור חיים יחיד. מתי האפליקציה צריכה לתמוך בתרחישים לדוגמה לא ניתן לשלב אותם, ניתן לבצע אחת מהפעולות הבאות:

  • קיבוץ של תרחישים תואמים לדוגמה בכמה תרחישים לדוגמה מקטע ולאחר מכן לעבור בין מקטעים
  • יצירת רכיב מחזור חיים בהתאמה אישית ולהשתמש בו כדי לשלוט באופן ידני במחזור החיים של המצלמה

אם מבטלים את הקישור בין הבעלים של מחזור החיים של תרחישי השימוש של התצוגה והמצלמה (לדוגמה, אם משתמשים במחזור חיים מותאם אישית או בקטע שמתבצע בו שמירה), צריך לוודא שכל תרחישי השימוש לא מקושרים ל-CameraX באמצעות ProcessCameraProvider.unbindAll() או על ידי ביטול הקישור של כל תרחיש שימוש בנפרד. לחלופין, אחרי שתקשרו את השימוש למחזור חיים, ניתן לאפשר ל- CameraX ניהול פתיחה וסגירה של סשן הצילום וביטול הקישור בין תרחישים לדוגמה.

אם כל הפונקציונליות של המצלמה תואמת למחזור החיים של שמודע למחזור חיים, כמו AppCompatActivity או מקטע AppCompat, ולאחר מכן שימוש במחזור החיים של הרכיב הזה במהלך הקישור את כל התרחישים לדוגמה הרצויים יבטיחו שהפונקציונליות של המצלמה תהיה מוכנה כשהרכיב המודע למחזור החיים פעיל ומושליך באופן בטוח, וצריכת משאבים כלשהי, אחרת.

בעלים של מחזור חיים בהתאמה אישית

במקרים מתקדמים, אפשר ליצור LifecycleOwner כדי להפעיל את כדי לשלוט במפורש במחזור החיים של הפעלת CameraX במקום לקשר אותו משתמש רגיל של Android LifecycleOwner.

דוגמת הקוד הבאה מראה איך ליצור בעלים פשוט של מחזור חיים בהתאמה אישית:

Kotlin

class CustomLifecycle : LifecycleOwner {
    private val lifecycleRegistry: LifecycleRegistry

    init {
        lifecycleRegistry = LifecycleRegistry(this);
        lifecycleRegistry.markState(Lifecycle.State.CREATED)
    }
    ...
    fun doOnResume() {
        lifecycleRegistry.markState(State.RESUMED)
    }
    ...
    override fun getLifecycle(): Lifecycle {
        return lifecycleRegistry
    }
}

Java

public class CustomLifecycle implements LifecycleOwner {
    private LifecycleRegistry lifecycleRegistry;
    public CustomLifecycle() {
        lifecycleRegistry = new LifecycleRegistry(this);
        lifecycleRegistry.markState(Lifecycle.State.CREATED);
    }
   ...
   public void doOnResume() {
        lifecycleRegistry.markState(State.RESUMED);
    }
   ...
    public Lifecycle getLifecycle() {
        return lifecycleRegistry;
    }
}

באמצעות LifecycleOwner, האפליקציה יכולה למקם את מעברי המצב בנקודות הרצויות בקוד שלה. כדי לקבל מידע נוסף על הטמעת הפונקציונליות הזו באפליקציה, מידע נוסף זמין בקטע יישום של בעלים של מחזור חיים.

תרחישים לדוגמה בו-זמנית

אפשר להריץ תרחישי לדוגמה בו-זמנית. אומנם אפשר לקשר ברצף את התרחישים לדוגמה במחזור החיים, עדיף לקשר את כל התרחישים לדוגמה באמצעות קריאה אחת CameraProcessProvider.bindToLifecycle() לקבלת מידע נוסף על לשינויי הגדרות אישיות, אפשר לעיין במאמר הגדרת כינוי .

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

Kotlin

private lateinit var imageCapture: ImageCapture

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val cameraProviderFuture = ProcessCameraProvider.getInstance(this)

    cameraProviderFuture.addListener(Runnable {
        // Camera provider is now guaranteed to be available
        val cameraProvider = cameraProviderFuture.get()

        // Set up the preview use case to display camera preview.
        val preview = Preview.Builder().build()

        // Set up the capture use case to allow users to take photos.
        imageCapture = ImageCapture.Builder()
                .setCaptureMode(ImageCapture.CAPTURE_MODE_MINIMIZE_LATENCY)
                .build()

        // Choose the camera by requiring a lens facing
        val cameraSelector = CameraSelector.Builder()
                .requireLensFacing(CameraSelector.LENS_FACING_FRONT)
                .build()

        // Attach use cases to the camera with the same lifecycle owner
        val camera = cameraProvider.bindToLifecycle(
                this as LifecycleOwner, cameraSelector, preview, imageCapture)

        // Connect the preview use case to the previewView
        preview.setSurfaceProvider(
                previewView.getSurfaceProvider())
    }, ContextCompat.getMainExecutor(this))
}

Java

private ImageCapture imageCapture;

@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    PreviewView previewView = findViewById(R.id.previewView);

    ListenableFuture<ProcessCameraProvider> cameraProviderFuture =
            ProcessCameraProvider.getInstance(this);

    cameraProviderFuture.addListener(() -> {
        try {
            // Camera provider is now guaranteed to be available
            ProcessCameraProvider cameraProvider = cameraProviderFuture.get();

            // Set up the view finder use case to display camera preview
            Preview preview = new Preview.Builder().build();

            // Set up the capture use case to allow users to take photos
            imageCapture = new ImageCapture.Builder()
                    .setCaptureMode(ImageCapture.CAPTURE_MODE_MINIMIZE_LATENCY)
                    .build();

            // Choose the camera by requiring a lens facing
            CameraSelector cameraSelector = new CameraSelector.Builder()
                    .requireLensFacing(lensFacing)
                    .build();

            // Attach use cases to the camera with the same lifecycle owner
            Camera camera = cameraProvider.bindToLifecycle(
                    ((LifecycleOwner) this),
                    cameraSelector,
                    preview,
                    imageCapture);

            // Connect the preview use case to the previewView
            preview.setSurfaceProvider(
                    previewView.getSurfaceProvider());
        } catch (InterruptedException | ExecutionException e) {
            // Currently no exceptions thrown. cameraProviderFuture.get()
            // shouldn't block since the listener is being called, so no need to
            // handle InterruptedException.
        }
    }, ContextCompat.getMainExecutor(this));
}

CameraX מאפשר שימוש סימולטני במכונה אחת בכל אחד מ-Preview, VideoCapture, ImageAnalysis וגם ImageCapture. בנוסף,

  • כל תרחיש לדוגמה יכול לפעול בפני עצמו. לדוגמה, אפליקציה יכולה להקליט סרטונים בלי להשתמש בתצוגה מקדימה.
  • כשהתוספים מופעלים, רק השילוב של ImageCapture ו-Preview מובטח לפעול. בהתאם להטמעת ה-OEM, ייתכן שלא תהיה אפשרות להוסיף גם ImageAnalysis; תוספים לא יכולים בתרחיש לדוגמה VideoCapture. כדאי לבדוק את מסמך עזר בנושא תוסף אפשר לקבל פרטים נוספים.
  • בהתאם ליכולות של המצלמה, יכול להיות שחלק מהמצלמות יתמכו בשילוב הזה במצבי רזולוציה נמוכים יותר, אבל לא יוכלו לתמוך באותו שילוב ברזולוציות גבוהות יותר.
  • במכשירים עם רמת חומרה של המצלמה FULL ומטה, בשילוב של Preview, VideoCapture, וגם ImageCapture או ImageAnalysis יכולים לאלץ את CameraX כדי לשכפל את השידור PRIV של המצלמה בשביל Preview ו-VideoCapture. הכפילות הזו, שנקראת 'שיתוף סטרימינג', מאפשרת להשתמש בו-זמנית בתכונות האלה, אבל היא גורמת לעלייה בדרישה לעיבוד. ייתכן ש כתוצאה מכך, זמן האחזור יהיה מעט יותר ארוך ויקצר את חיי הסוללה.

רמת החומרה הנתמכת ניתן לאחזר מ-Camera2CameraInfo. לדוגמה, הקוד הבא הפונקציה בודקת אם המצלמה האחורית שמוגדרת כברירת מחדל היא מכשיר LEVEL_3:

Kotlin

@androidx.annotation.OptIn(ExperimentalCamera2Interop::class)
fun isBackCameraLevel3Device(cameraProvider: ProcessCameraProvider) : Boolean {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
        return CameraSelector.DEFAULT_BACK_CAMERA
            .filter(cameraProvider.availableCameraInfos)
            .firstOrNull()
            ?.let { Camera2CameraInfo.from(it) }
            ?.getCameraCharacteristic(CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL) ==
            CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL_3
    }
    return false
}

Java

@androidx.annotation.OptIn(markerClass = ExperimentalCamera2Interop.class)
Boolean isBackCameraLevel3Device(ProcessCameraProvider cameraProvider) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
        List\<CameraInfo\> filteredCameraInfos = CameraSelector.DEFAULT_BACK_CAMERA
                .filter(cameraProvider.getAvailableCameraInfos());
        if (!filteredCameraInfos.isEmpty()) {
            return Objects.equals(
                Camera2CameraInfo.from(filteredCameraInfos.get(0)).getCameraCharacteristic(
                        CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL),
                CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL_3);
        }
    }
    return false;
}

הרשאות

לאפליקציה שלך יידרשו הרשאה CAMERA. כדי לשמור תמונות בקבצים, נדרשת גם ההרשאה WRITE_EXTERNAL_STORAGE, מלבד במכשירים עם Android מגרסה 10 ואילך.

למידע נוסף על הגדרת הרשאות לאפליקציה, אפשר לקרוא את המאמר שליחת בקשה הרשאות הניתנות לאפליקציה.

הדרישות

ל- CameraX יש את דרישות הגרסה המינימליות הבאות:

  • Android API ברמה 21
  • רכיבי הארכיטקטורה של Android 1.1.1

לפעילויות שמתחשבות למחזור החיים, השתמשו FragmentActivity או AppCompatActivity

הצהרה על יחסי תלות

כדי להוסיף יחסי תלות ל-CameraX, צריך להוסיף לפרויקט את מאגר Google Maven.

פותחים את הקובץ settings.gradle של הפרויקט ומוסיפים את המאגר google() כפי שמוצג באופן הבא:

מגניב

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

Kotlin

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

מוסיפים את הטקסט הבא לסוף הבלוק של Android:

Groovy

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    // For Kotlin projects
    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }
    // For Kotlin projects
    kotlinOptions {
        jvmTarget = "1.8"
    }
}

מוסיפים את הפרטים הבאים לקובץ build.gradle של כל מודול לאפליקציה:

Groovy

dependencies {
  // CameraX core library using the camera2 implementation
  def camerax_version = "1.5.0-alpha03"
  // The following line is optional, as the core library is included indirectly by camera-camera2
  implementation "androidx.camera:camera-core:${camerax_version}"
  implementation "androidx.camera:camera-camera2:${camerax_version}"
  // If you want to additionally use the CameraX Lifecycle library
  implementation "androidx.camera:camera-lifecycle:${camerax_version}"
  // If you want to additionally use the CameraX VideoCapture library
  implementation "androidx.camera:camera-video:${camerax_version}"
  // If you want to additionally use the CameraX View class
  implementation "androidx.camera:camera-view:${camerax_version}"
  // If you want to additionally add CameraX ML Kit Vision Integration
  implementation "androidx.camera:camera-mlkit-vision:${camerax_version}"
  // If you want to additionally use the CameraX Extensions library
  implementation "androidx.camera:camera-extensions:${camerax_version}"
}

Kotlin

dependencies {
    // CameraX core library using the camera2 implementation
    val camerax_version = "1.5.0-alpha03"
    // The following line is optional, as the core library is included indirectly by camera-camera2
    implementation("androidx.camera:camera-core:${camerax_version}")
    implementation("androidx.camera:camera-camera2:${camerax_version}")
    // If you want to additionally use the CameraX Lifecycle library
    implementation("androidx.camera:camera-lifecycle:${camerax_version}")
    // If you want to additionally use the CameraX VideoCapture library
    implementation("androidx.camera:camera-video:${camerax_version}")
    // If you want to additionally use the CameraX View class
    implementation("androidx.camera:camera-view:${camerax_version}")
    // If you want to additionally add CameraX ML Kit Vision Integration
    implementation("androidx.camera:camera-mlkit-vision:${camerax_version}")
    // If you want to additionally use the CameraX Extensions library
    implementation("androidx.camera:camera-extensions:${camerax_version}")
}

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

יכולת פעולה הדדית של CameraX עם Camera2

CameraX מבוסס על Camera2, ו-CameraX חושף דרכים לקרוא ואפילו לכתוב מאפיינים בהטמעה של Camera2. פרטים מלאים זמינים בחבילת ה-Interop.

למידע נוסף על האופן שבו CameraX מגדיר את המאפיינים של Camera2, תוכלו להשתמש ב-Camera2CameraInfo כדי לקרוא את CameraCharacteristics הבסיסי. אפשר גם לכתוב את ה- Camera2 באחד משני המסלולים הבאים:

בדוגמת הקוד הבאה נעשה שימוש בתרחישי שימוש של סטרימינג כדי לבצע אופטימיזציה לשיחות וידאו. שימוש ב-Camera2CameraInfo כדי לאחזר אם התרחיש לדוגמה של שידור שיחת וידאו זמין. לאחר מכן, משתמשים Camera2Interop.Extender כדי להגדיר את התרחיש לדוגמה של השידור הבסיסי.

Kotlin

// Set underlying Camera2 stream use case to optimize for video calls.

val videoCallStreamId =
    CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_VIDEO_CALL.toLong()

// Check available CameraInfos to find the first one that supports
// the video call stream use case.
val frontCameraInfo = cameraProvider.getAvailableCameraInfos()
    .first { cameraInfo ->
        val isVideoCallStreamingSupported = Camera2CameraInfo.from(cameraInfo)
            .getCameraCharacteristic(
                CameraCharacteristics.SCALER_AVAILABLE_STREAM_USE_CASES
            )?.contains(videoCallStreamId)
        val isFrontFacing = (cameraInfo.getLensFacing() == 
                             CameraSelector.LENS_FACING_FRONT)
        (isVideoCallStreamingSupported == true) && isFrontFacing
    }

val cameraSelector = frontCameraInfo.cameraSelector

// Start with a Preview Builder.
val previewBuilder = Preview.Builder()
    .setTargetAspectRatio(screenAspectRatio)
    .setTargetRotation(rotation)

// Use Camera2Interop.Extender to set the video call stream use case.
Camera2Interop.Extender(previewBuilder).setStreamUseCase(videoCallStreamId)

// Bind the Preview UseCase and the corresponding CameraSelector.
val preview = previewBuilder.build()
camera = cameraProvider.bindToLifecycle(this, cameraSelector, preview)

Java

// Set underlying Camera2 stream use case to optimize for video calls.

Long videoCallStreamId =
    CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_VIDEO_CALL.toLong();

// Check available CameraInfos to find the first one that supports
// the video call stream use case.
List<CameraInfo> cameraInfos = cameraProvider.getAvailableCameraInfos();
CameraInfo frontCameraInfo = null;
for (cameraInfo in cameraInfos) {
    Long[] availableStreamUseCases = Camera2CameraInfo.from(cameraInfo)
        .getCameraCharacteristic(
            CameraCharacteristics.SCALER_AVAILABLE_STREAM_USE_CASES
        );
    boolean isVideoCallStreamingSupported = Arrays.List(availableStreamUseCases)
                .contains(videoCallStreamId);
    boolean isFrontFacing = (cameraInfo.getLensFacing() ==
                             CameraSelector.LENS_FACING_FRONT);

    if (isVideoCallStreamingSupported && isFrontFacing) {
        frontCameraInfo = cameraInfo;
    }
}

if (frontCameraInfo == null) {
    // Handle case where video call streaming is not supported.
}

CameraSelector cameraSelector = frontCameraInfo.getCameraSelector();

// Start with a Preview Builder.
Preview.Builder previewBuilder = Preview.Builder()
    .setTargetAspectRatio(screenAspectRatio)
    .setTargetRotation(rotation);

// Use Camera2Interop.Extender to set the video call stream use case.
Camera2Interop.Extender(previewBuilder).setStreamUseCase(videoCallStreamId);

// Bind the Preview UseCase and the corresponding CameraSelector.
Preview preview = previewBuilder.build()
Camera camera = cameraProvider.bindToLifecycle(this, cameraSelector, preview)

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

מידע נוסף על CameraX זמין במקורות המידע הבאים.

Codelab

  • תחילת העבודה עם CameraX

    • דוגמת קוד

  • אפליקציות לדוגמה של CameraX

    •