تتناول هذه الصفحة بنية CameraX، بما في ذلك بنيتها وكيفية استخدام واجهة برمجة التطبيقات وكيفية العمل مع مراحل النشاط وكيفية دمج حالات الاستخدام.
بنية CameraX
يمكنك استخدام CameraX للتفاعل مع كاميرا الجهاز من خلال تصنيف مجرد يُعرف باسم حالة الاستخدام. تتوفّر حالات الاستخدام التالية:
- معاينة: تقبل سطح عرض لعرض معاينة، مثل
PreviewView
. - تحليل الصور: يوفّر وحدات تخزين مؤقتة يمكن لوحدة المعالجة المركزية الوصول إليها للتحليل، مثل تعلُّم الآلة.
- التقاط الصور: لالتقاط صورة وحفظها
- تسجيل الفيديو: يمكنك تسجيل الفيديو والصوت باستخدام
VideoCapture
.
يمكن دمج حالات الاستخدام وتفعيلها بشكل متزامن. على سبيل المثال، يمكن للتطبيق السماح للمستخدم بعرض الصورة التي تراها الكاميرا باستخدام حالة استخدام المعاينة، واستخدام حالة استخدامتحليل الصورة لتحديد ما إذا كان الأشخاص في الصورة يبتسمون، وتضمين حالة استخدام لالتقاط الصور لالتقاط صورة عند تبسمهم.
نموذج واجهة برمجة التطبيقات
للعمل مع المكتبة، عليك تحديد ما يلي:
- حالة الاستخدام المطلوبة مع خيارات الضبط
- كيفية التعامل مع بيانات الإخراج من خلال إرفاق مستمعين
- المسار المقصود، مثل حالات تفعيل الكاميرات وحالات إنشاء البيانات، من خلال ربط حالة الاستخدام بمراحل دورة حياة بنية Android
هناك طريقتان لكتابة تطبيق CameraX: باستخدام ملف برمجي من النوع
CameraController
(وهو مثالي إذا
كنت تريد أبسط طريقة لاستخدام CameraX) أو باستخدام ملف برمجي من النوع
CameraProvider
(وهو مثالي إذا
كنت بحاجة إلى مزيد من المرونة).
CameraController
يوفّر 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
، سيؤدي استخدام دورة حياة هذا الملف عند ربط
جميع حالات الاستخدام المطلوبة إلى ضمان جاهزية وظائف الكاميرا
عندما يكون الملف المدرك للدورة نشطًا، ويتم التخلص منه بأمان، ولا
يستهلك أي موارد في غير ذلك.
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
لكل وحدة في التطبيق:
رائع
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}") }
لمزيد من المعلومات عن ضبط تطبيقك بما يتوافق مع هذه المتطلبات، راجِع مقالة إعلان التبعيات.
إمكانية التشغيل التفاعلي لإطار عمل CameraX مع Camera2
تم إنشاء CameraX استنادًا إلى Camera2، وتوفّر CameraX طرقًا لقراءة ملفاتك وحتى كتابة الخصائص في عملية تنفيذ Camera2. لمعرفة التفاصيل الكاملة، يُرجى الاطّلاع على حزمة Interop.
لمزيد من المعلومات عن كيفية ضبط CameraX لخصائص Camera2، استخدِم
Camera2CameraInfo
لقراءة CameraCharacteristics
الأساسي. يمكنك أيضًا اختيار كتابة خصائص Camera2
الأساسية في أحد المسارين التاليين:
استخدِم
Camera2CameraControl
، الذي يتيح لك ضبط السمات على العنصر الأساسيCaptureRequest
، مثل وضع التركيز التلقائي.وسِّع عنصر CameraX
UseCase
باستخدامCamera2Interop.Extender
. يتيح لك ذلك ضبط السمات في CaptureRequest، تمامًا مثلCamera2CameraControl
. يوفّر لك هذا الإعداد أيضًا بعض عناصر التحكّم الإضافية، مثل ضبط حالة استخدام البث لتحسين الكاميرا وفقًا لسيناريو الاستخدام. للحصول على معلومات، يُرجى الاطّلاع على استخدام حالات استخدام Stream لتحسين الأداء.
يستخدم نموذج الرمز البرمجي التالي حالات استخدام البث لتحسين مكالمة الفيديو.
استخدِم 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، يمكنك الرجوع إلى المراجع الإضافية التالية.
الدرس التطبيقي حول الترميز
نموذج رمز