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

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

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

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

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

يوضح نموذج الرمز البرمجي التالي كيفية إنشاء 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));
}

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

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

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

معاينة التقاط فيديو التقاط صورة التحليل متطلبات خاصة
    مع ضمان جميع الكاميرات
  جهاز كاميرا محدود (أو أفضل).
  جهاز كاميرا 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\<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(). كما هو موضح في ما يلي:

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

رائع

dependencies {
  // CameraX core library using the camera2 implementation
  def camerax_version = "1.4.0-rc01"
  // 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-rc01"
    // 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}")
}

لمزيد من المعلومات حول ضبط تطبيقك ليتوافق مع هذه المتطلبات، راجع بيان والتبعيات لديك.

إمكانية التشغيل التفاعلي للكاميرا مع Camera2

صُمِّم تطبيق CameraX على تطبيق Camera2، كما يوفّر CameraX طرقًا للقراءة والكتابة أيضًا. الخصائص في تنفيذ Camera2. للحصول على التفاصيل الكاملة، يمكنك مراجعة حزمة التشغيل التفاعلي:

للاطّلاع على مزيد من المعلومات عن كيفية ضبط CameraX لخصائص Camera2، يمكنك استخدام Camera2CameraInfo لقراءة CameraCharacteristics الأساسية. يمكنك أيضًا اختيار كتابة عدسة الكاميرا2 في أحد المسارين التاليين:

يستخدم نموذج الرمز البرمجي التالي حالات استخدام البث لتحسين مكالمة فيديو. استخدام 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