بنية CameraX

تتناول هذه الصفحة بنية CameraX، بما في ذلك هيكلها وكيفية استخدام واجهة برمجة التطبيقات وكيفية التعامل مع دورات الحياة وكيفية الجمع بين حالات الاستخدام.

بنية CameraX

يمكنك استخدام CameraX للتفاعل مع كاميرا الجهاز من خلال تجريد يُعرف باسم حالة الاستخدام. تتوفّر حالات الاستخدام التالية:

  • Preview: تقبل هذه السمة مساحة عرض لمعاينة، مثل PreviewView.
  • تحليل الصور: يوفّر هذا الخيار مخازن مؤقتة يمكن لوحدة المعالجة المركزية الوصول إليها لإجراء التحليل، مثلاً لأغراض تعلُّم الآلة.
  • التقاط صورة: لالتقاط صورة وحفظها
  • تسجيل الفيديو: تسجيل الفيديو والصوت باستخدام VideoCapture

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

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

للعمل مع المكتبة، عليك تحديد ما يلي:

  • حالة الاستخدام المطلوبة مع خيارات الإعداد
  • كيفية التعامل مع بيانات الإخراج من خلال ربط أدوات معالجة
  • سير العمل المقصود، مثل وقت تفعيل الكاميرات ووقت إنشاء البيانات، من خلال ربط حالة الاستخدام بدورات حياة بنية 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);

UseCases التلقائية لـ CameraController هي Preview وImageCapture وImageAnalysis. لإيقاف ImageCapture أو ImageAnalysis أو لتفعيل VideoCapture، استخدِم طريقة setEnabledUseCases().

لمزيد من المعلومات حول استخدامات CameraController، يمكنك الاطّلاع على نموذج الماسح الضوئي لرمز الاستجابة السريعة أو فيديو أساسيات CameraController.

CameraProvider

لا يزال CameraProvider سهل الاستخدام، ولكن بما أنّ مطوّر التطبيق يتولّى المزيد من عملية الإعداد، تتوفّر فرص أكبر لتخصيص الإعدادات، مثل تفعيل تدوير صورة الإخراج أو ضبط تنسيق صورة الإخراج في ImageAnalysis. يمكنك أيضًا استخدام Surface مخصّص لمعاينة الكاميرا يتيح المزيد من المرونة، بينما يتطلّب استخدام CameraController استخدام PreviewView. قد يكون استخدام رمز Surface الحالي مفيدًا إذا كان يُستخدَم حاليًا كإدخال في أجزاء أخرى من تطبيقك.

يمكنك ضبط حالات الاستخدام باستخدام طرق set() وإكمالها باستخدام طريقة build(). يوفّر كل عنصر من عناصر حالة الاستخدام مجموعة من واجهات برمجة التطبيقات الخاصة بحالة الاستخدام. على سبيل المثال، توفّر حالة استخدام التقاط الصور استدعاء الطريقة 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 دورة حياة لتحديد وقت فتح الكاميرا ووقت إنشاء جلسة التقاط ووقت الإيقاف والإغلاق. توفّر واجهات برمجة التطبيقات الخاصة بحالات الاستخدام عمليات استدعاء الطرق وعمليات الاستدعاء لتتبُّع مستوى التقدّم.

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

  • تجميع حالات الاستخدام المتوافقة معًا في أكثر من جزء ثم التبديل بين الأجزاء
  • إنشاء مكوّن مخصّص لدورة الحياة واستخدامه للتحكّم يدويًا في دورة حياة الكاميرا

إذا فصلت مالكي مراحل النشاط لحالات استخدام العرض والكاميرا (على سبيل المثال، إذا كنت تستخدم مرحلة نشاط مخصّصة أو retain fragment)، عليك التأكّد من إلغاء ربط جميع حالات الاستخدام من CameraX باستخدام ProcessCameraProvider.unbindAll() أو عن طريق إلغاء ربط كل حالة استخدام على حدة. بدلاً من ذلك، عند ربط حالات الاستخدام بدورة حياة، يمكنك السماح لمكتبة CameraX بإدارة فتح جلسة الالتقاط وإغلاقها وإلغاء ربط حالات الاستخدام.

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

Custom LifecycleOwners

في الحالات المتقدّمة، يمكنك إنشاء LifecycleOwner مخصّص لتمكين تطبيقك من التحكّم بشكل صريح في دورة حياة جلسة CameraX بدلاً من ربطها بـ LifecycleOwner عادي في 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، يمكن لتطبيقك وضع عمليات انتقال الحالة في النقاط المطلوبة في الرمز. لمزيد من المعلومات حول تنفيذ هذه الوظيفة في تطبيقك، راجِع تنفيذ 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. استنادًا إلى طريقة تنفيذ الشركة المصنّعة للجهاز الأصلي، قد لا يكون من الممكن إضافة 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، باستثناء الأجهزة التي تعمل بالإصدار 10 من نظام التشغيل Android أو الإصدارات الأحدث.

لمزيد من المعلومات حول ضبط أذونات تطبيقك، يُرجى الاطّلاع على طلب أذونات التطبيق.

المتطلبات

تتضمّن CameraX الحدّ الأدنى التالي من متطلبات الإصدار:

  • المستوى 21 لواجهة برمجة التطبيقات في Android
  • مكوّنات الهندسة المتوافقة مع Android 1.1.1

بالنسبة إلى الأنشطة التي تراعي مراحل النشاط، استخدِم FragmentActivity أو AppCompatActivity.

تعريف العناصر التابعة

لإضافة تبعية على CameraX، يجب إضافة مستودع Google Maven إلى مشروعك.

افتح ملف settings.gradle لمشروعك وأضِف مستودع google() كما هو موضّح أدناه:

Groovy

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-beta01"
  // 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-beta01"
    // 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. للاطّلاع على التفاصيل الكاملة، يُرجى الرجوع إلى حزمة إمكانية التشغيل التفاعلي.

لمزيد من المعلومات حول كيفية ضبط 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