أنواع مساحات العرض

توضّح هذه الصفحة الأنواع المختلفة من مساحات العرض التي يمكن استخدامها لتشغيل الفيديوهات باستخدام Media3، وكيفية اختيار النوع المناسب لحالة الاستخدام. لمزيد من المعلومات حول عناصر Surface في Android، يمكنك الاطّلاع على مستندات الرسومات هذه.

ضبط السطح

هناك أربع نقاط دخول لـ Player لتوصيل مخرج الفيديو ببعض Surface:

هناك أيضًا طرق مختلفة لمحو هذه البيانات:

اختيار نوع مساحة العرض لـ PlayerView

تتيح لك السمة surface_type في PlayerView ضبط نوع مساحة العرض المستخدَمة لتشغيل الفيديو. القيم المسموح بها هي:

  • surface_view (SurfaceView)
  • texture_view (TextureView)
  • ‫spherical_gl_surface_view (SphericalGLSurfaceView): لتشغيل الفيديوهات الكروية
  • video_decoder_gl_surface_view (VideoDecoderGLSurfaceView) - عرض الفيديو باستخدام أدوات عرض الإضافات
  • ‫none: مخصّص لتشغيل الصوت فقط ويجب استخدامه لتجنُّب إنشاء سطح لأنّ ذلك قد يكون مكلفًا.

إذا كان العرض مخصّصًا لتشغيل الفيديو العادي، يجب استخدام surface_view أو texture_view. يوفّر SurfaceView عددًا من المزايا مقارنةً بـ TextureView لتشغيل الفيديوهات:

  • استهلاك طاقة أقل بشكل كبير على العديد من الأجهزة
  • وقت عرض اللقطة أكثر دقة، ما يؤدي إلى تشغيل الفيديو بسلاسة أكبر
  • إتاحة إخراج فيديو بنطاق عالي الديناميكية (HDR) بجودة أعلى على الأجهزة المتوافقة
  • دعم الإخراج الآمن عند تشغيل المحتوى المحمي بنظام "إدارة الحقوق الرقمية"
  • إمكانية عرض محتوى الفيديو بدقة العرض الكاملة على أجهزة Android TV التي ترفع مستوى طبقة واجهة المستخدم

لذلك، يجب تفضيل SurfaceView على TextureView حيثما أمكن. يجب استخدام TextureView فقط إذا لم تكن SurfaceView تلبي احتياجاتك. ومن الأمثلة على ذلك الحالات التي تتطلب عرض صور متحركة سلسة أو الانتقال بسلاسة في سطح الفيديو قبل الإصدار 7.0 من نظام التشغيل Android (المستوى 24 من واجهة برمجة التطبيقات)، كما هو موضّح في الملاحظات التالية. في هذه الحالة، من الأفضل استخدام TextureView فقط عندما يكون SDK_INT أقل من 24 (الإصدار 7.0 من نظام التشغيل Android) وSurfaceView في الحالات الأخرى.

اختيار نوع مساحة عرض في Compose

في Compose، يستخدم حلّ إمكانية التشغيل التفاعلي الدالة المركّبة AndroidView لتضمين SurfaceView وTextureView. الدالتان المركّبتان اللتان تتوافقان مع ذلك هما AndroidExternalSurface وAndroidEmbeddedExternalSurface من androidx.compose.foundation. ومع ذلك، توفّر فئات الخادم الوكيل هذه واجهة برمجة تطبيقات تحدّ من الوصول إلى طرق العرض الأساسية. يحتاج Player إلى هذه العروض للتعامل مع مراحل النشاط الكاملة للسطح (الإنشاء وتعديلات الحجم).

في وحدة media3-ui-compose، يمكنك العثور على الدالتَين المركّبتَين ContentFrame وPlayerSurface اللتَين تربطان Player بـ Surface بطريقة تراعي مراحل النشاط. أنواع الأسطح في هذه الحالة هي:

  • androidx.media3.ui.compose.SURFACE_TYPE_SURFACE_VIEW
  • androidx.media3.ui.compose.SURFACE_TYPE_TEXTURE_VIEW

لا يتوفّر النوع none، لأنّ ذلك يعني عدم تضمين الدالة المركّبة في شجرة واجهة مستخدم Compose.

لمعرفة كيفية إدارة نِسب العرض إلى الارتفاع للفيديوهات وتغيير حجم النوافذ ديناميكيًا وتغيير حجم المحتوى في Compose، يُرجى الاطّلاع على تغيير حجم محتوى الوسائط على مستوى أشكال الأجهزة المختلفة.