بنية 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\ 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;
}

ملاحظة: في حال إنشاء مجموعة غير متوافقة من حالات الاستخدام، سيتم عرض خطأ وقت التشغيل عند استدعاء createCaptureSession() لأول مرة. وإذا تمت إضافة حالات استخدام أخرى إلى الجلسة قيد التشغيل، قد يلزم إعادة الضبط، ما قد يتسبب في حدوث خلل مرئي.

الأذونات

سيحتاج تطبيقك إلى إذن 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-beta02"
  // 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-beta02"
    // 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. للحصول على التفاصيل الكاملة، يُرجى الاطّلاع على حزمة Interop.

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

• يمكنك استخدام Camera2CameraControl، التي تتيح لك ضبط السمات على CaptureRequest الأساسية، مثل وضع التركيز التلقائي.

• يمكنك تمديد كاميرا CameraX UseCase باستخدام Camera2Interop.Extender. يتيح لك هذا الإعداد ضبط الخصائص في CaptureRequest، تمامًا كما هو الحال مع Camera2CameraControl. توفّر لك أيضًا بعض عناصر التحكّم الإضافية، مثل ضبط حالة استخدام البث لتحسين الكاميرا حسب سيناريو الاستخدام. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام حالات استخدام البث لتحقيق أداء أفضل.

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

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