بنية CameraX

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

بنية CameraX

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

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

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

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

لاستخدام المكتبة، يجب تحديد الأشياء التالية:

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

هناك طريقتان لكتابة تطبيق CameraX: إما CameraController (طريقة رائعة إذا كنت تريد أبسط طريقة لاستخدام CameraX) أو CameraProvider (رائعة إذا كنت بحاجة إلى مزيد من المرونة).

وحدة تحكُّم في الكاميرا

يوفّر 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، استخدِم الطريقة setEnabledUseCases().

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

مزوّد الكاميرا

لا يزال 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 دورة حياة لتحديد الوقت المناسب لفتح الكاميرا، ومتى يجب إنشاء جلسة التقاط ومتى تتوقف عن استخدام الكاميرا. توفر واجهات برمجة التطبيقات لحالة الاستخدام استدعاءات الطرق واستدعاءات الاتصال لمراقبة التقدم.

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

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

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

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

مالكو مراحل النشاط المخصّصة

في الحالات المتقدمة، يمكنك إنشاء رمز LifecycleOwner مخصّص لتمكين تطبيقك من التحكّم بشكل واضح في مراحل نشاط جلسة CameraX، وذلك بدلاً من ربطه بإصدار LifecycleOwner عادي من نظام التشغيل Android.

يوضح نموذج الرمز البرمجي التالي كيفية إنشاء مالك دورة حياة مخصص بسيط:

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));
}

نؤكّد لك إتاحة مجموعات الضبط التالية (عندما تكون المعاينة أو التقاط الفيديو مطلوبة، ولكن ليس كلاهما في الوقت نفسه):

المعاينة أو VideoCapture التقاط الصور التحليل الأوصاف
يمكنك توفير معاينة أو تسجيل فيديو للمستخدم والتقاط صورة وتحليل بث الصور.
  التقِط صورة وحلِّل بث الصور.
  امنح المستخدم معاينة أو تسجيل فيديو والتقط صورة.
  وفِّر للمستخدم معاينة أو تسجيل فيديو، وحلِّل بث الصور.

عند الحاجة إلى كل من المعاينة والتقاط الفيديو، تتم إتاحة مجموعات حالات الاستخدام التالية بشروط:

معاينة التقاط الفيديوهات التقاط الصور التحليل متطلبات خاصة
    عرض مضمون لجميع الكاميرات
  جهاز كاميرا محدود (أو أفضل).
  كاميرا بالمستوى LEVEL_3 (أو أفضل).

بالإضافة إلى ذلك،

  • يمكن أن تعمل كل حالة استخدام بمفردها. على سبيل المثال، يمكن للتطبيق تسجيل فيديو بدون استخدام المعاينة.
  • عند تفعيل الإضافات، يتم ضمان عمل تركيبة ImageCapture وPreview فقط. وتبعًا لتنفيذ المصنِّع الأصلي للجهاز، قد لا يكون من الممكن إدراج ImageAnalysis أيضًا، ولا يمكن تفعيل الإضافات لحالة استخدام 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\ 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 الحد الأدنى من متطلبات الإصدار التالية:

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

للأنشطة الواعية بمراحل النشاط، استخدِم 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:

رائع

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 الخاص بكل وحدة في أحد التطبيقات:

رائع

dependencies {
  // CameraX core library using the camera2 implementation
  def camerax_version = "1.4.0-alpha04"
  // 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.4.0-alpha04"
    // 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 وكاميرا2

تم تصميم 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، يُرجى الاطّلاع على الموارد الإضافية التالية.

درس تطبيقي حول الترميز

  • بدء استخدام CameraX
  • نموذج التعليمات البرمجية

  • نماذج تطبيقات من CameraX