بنية CameraX

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

بنية CameraX

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

• ‫معاينة: تقبل سطح عرض لعرض معاينة، مثل PreviewView.
• تحليل الصور: يوفّر وحدات تخزين مؤقتة يمكن لوحدة المعالجة المركزية الوصول إليها لتحليل الصور، مثل تعلُّم الآلة.
• التقاط الصورة: لالتقاط صورة وحفظها
• تسجيل الفيديو: يمكنك تسجيل الفيديو والصوت باستخدام 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

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

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

في الحالات المتقدّمة، يمكنك إنشاء 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;
}

ملاحظة: في حال إنشاء مجموعة غير متوافقة من حالات الاستخدام، سيظهر خطأ في بيئة التشغيل الرمي لأول مرة 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.5.0-alpha03"
  // 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-alpha03"
    // 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 الأساسية. يمكنك أيضًا اختيار كتابة خصائص Camera2 الأساسية في أحد المسارين التاليين:

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

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

ملاحظة: تم وضع علامة "تجريبي" على إعدادات Camera2 الأساسية في CameraX لأنّ Google تتوقّع من المطوّرين فهم كيفية استخدامها. القيم التي set على أي قيم تعينها 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