بنية CameraX

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

بنية CameraX

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

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

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

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

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

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

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

CameraController

يوفّر CameraController معظم الوظيفة الأساسية في فئة واحدة. يتطلّب هذا المكوّن رمز إعداد بسيطًا، ويتولّى تلقائيًا إعداد الكاميرا وإدارة حالات الاستخدام وتدوير الهدف والنقر للتركيز والتكبير أو التصغير بإصبعين وغير ذلك. الفئة الملموسة التي تمدّد 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

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

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

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

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

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

‫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، باستثناء الأجهزة التي تعمل بنظام التشغيل 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 لكل وحدة في التطبيق:

Groovy

dependencies {
  // CameraX core library using the camera2 implementation
  def camerax_version = "1.7.0-alpha02"
  // 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.7.0-alpha02"
    // 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، يُرجى الاطّلاع على المراجع الإضافية التالية.

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

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

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