अलग-अलग तरह के प्लैटफ़ॉर्म

इस पेज पर, Media3 की मदद से वीडियो चलाने के लिए इस्तेमाल की जा सकने वाली अलग-अलग तरह की सुविधाओं के बारे में बताया गया है. साथ ही, यह भी बताया गया है कि अपने इस्तेमाल के उदाहरण के लिए सही सुविधा कैसे चुनी जाए. Android में Surface ऑब्जेक्ट के बारे में ज़्यादा जानने के लिए, यह ग्राफ़िक्स दस्तावेज़ पढ़ें.

PlayerView के लिए कोई प्लैटफ़ॉर्म टाइप चुनें

PlayerView एट्रिब्यूट की surface_type वैल्यू की मदद से, वीडियो चलाने के लिए इस्तेमाल किए जाने वाले डिवाइस का टाइप सेट किया जा सकता है. इन वैल्यू का इस्तेमाल किया जा सकता है:

• surface_view (SurfaceView)
• texture_view (TextureView)
• spherical_gl_surface_view (SphericalGLSurfaceView) - स्फ़ेरिकल वीडियो चलाने के लिए
• video_decoder_gl_surface_view (VideoDecoderGLSurfaceView) - एक्सटेंशन रेंडरर का इस्तेमाल करके वीडियो रेंडर करना
• none - इसका इस्तेमाल सिर्फ़ ऑडियो चलाने के लिए किया जाता है. इसका इस्तेमाल इसलिए किया जाना चाहिए, ताकि आपको कोई सरफेस न बनाना पड़े. ऐसा करने पर, आपको ज़्यादा शुल्क देना पड़ सकता है.

अगर व्यू का इस्तेमाल वीडियो को सामान्य तरीके से चलाने के लिए किया जा रहा है, तो surface_view या texture_view का इस्तेमाल किया जाना चाहिए. वीडियो चलाने के लिए, SurfaceView के कई फ़ायदे हैं. ये फ़ायदे, TextureView के मुकाबले ज़्यादा हैं:

• कई डिवाइसों पर बैटरी की खपत काफ़ी कम होती है.
• फ़्रेम टाइमिंग ज़्यादा सटीक होती है. इससे वीडियो ज़्यादा आसानी से चलता है.
• जिन डिवाइसों पर एचडीआर वीडियो आउटपुट की सुविधा काम करती है उन पर बेहतर क्वालिटी में वीडियो आउटपुट की सुविधा.
• DRM से सुरक्षित कॉन्टेंट चलाने के दौरान, सुरक्षित आउटपुट की सुविधा काम करती है.
• Android TV डिवाइसों पर, डिसप्ले के पूरे रिज़ॉल्यूशन में वीडियो कॉन्टेंट रेंडर करने की सुविधा. ये डिवाइस, यूज़र इंटरफ़ेस (यूआई) लेयर को अपस्केल करते हैं.

इसलिए, जहां तक हो सके वहां TextureView की जगह SurfaceView का इस्तेमाल करना चाहिए. TextureView का इस्तेमाल सिर्फ़ तब किया जाना चाहिए, जब SurfaceView आपकी ज़रूरतों को पूरा न करता हो. इसका एक उदाहरण यह है कि Android 7.0 (एपीआई लेवल 24) से पहले, वीडियो की सतह पर स्मूथ ऐनिमेशन या स्क्रोलिंग की ज़रूरत होती है. इसके बारे में यहां बताया गया है. इस मामले में, TextureView का इस्तेमाल सिर्फ़ तब करें, जब SDK_INT 24 (Android 7.0) से कम हो. इसके अलावा, SurfaceView का इस्तेमाल करें.

ध्यान दें: Android 7.0 (एपीआई लेवल 24) से पहले, SurfaceView रेंडरिंग को व्यू ऐनिमेशन के साथ ठीक से सिंक नहीं किया गया था. पहले की रिलीज़ में, गलत तरीके से सिंक करने की वजह से, अनचाहे असर दिख सकते थे. ऐसा तब होता था, जब किसी SurfaceView को स्क्रोल करने वाले कंटेनर में रखा जाता था या जब उसे ऐनिमेट किया जाता था. अनचाहे इफ़ेक्ट में ये शामिल हैं: व्यू का कॉन्टेंट, दिखने की जगह से थोड़ा पीछे दिख रहा है और ऐनिमेशन के दौरान व्यू काला हो जाता है. Android 7.0 से पहले के वर्शन पर, वीडियो को आसानी से ऐनिमेट करने या स्क्रोल करने के लिए, SurfaceView के बजाय TextureView का इस्तेमाल करें.

ध्यान दें: SurfaceView के सर्फ़ेस का लाइफ़साइकल, व्यू के दिखने से जुड़ा होता है. वहीं, TextureView के सर्फ़ेस का लाइफ़साइकल, विंडो अटैच और डिटैच होने से जुड़ा होता है. इसलिए, SurfaceView का इस्तेमाल करने वाले स्क्रोलिंग यूज़र इंटरफ़ेस (यूआई) में, कॉन्टेंट का प्लेबैक शुरू होने में ज़्यादा समय लग सकता है. ऐसा इसलिए होता है, क्योंकि आउटपुट सरफेस कुछ समय बाद उपलब्ध होता है. Android 14 और इसके बाद के वर्शन में, PlayerView इस व्यवहार से बचने के लिए SurfaceView.setSurfaceLifecycle(SURFACE_LIFECYCLE_FOLLOWS_ATTACHMENT) का इस्तेमाल करता है. अगर आपका ऐप्लिकेशन सीधे तौर पर SurfaceView का इस्तेमाल करता है (PlayerView के बिना), तो आपको इस मोड को चालू करना पड़ सकता है. Android 14 से पहले, व्यू को रीसाइकल करते समय, उन्हें स्क्रीन से बाहर ले जाकर ट्रांसलेट किया जा सकता था. इससे, व्यू के डिस्ट्रॉय होने की समस्या को ठीक किया जा सकता था.

ध्यान दें: कुछ Android TV डिवाइसों में, यूज़र इंटरफ़ेस (यूआई) लेयर को डिसप्ले के फ़ुल रिज़ॉल्यूशन से कम रिज़ॉल्यूशन पर चलाया जाता है. इसके बाद, इसे अपस्केल करके उपयोगकर्ता को दिखाया जाता है. उदाहरण के लिए, 4K डिसप्ले वाले Android TV पर यूज़र इंटरफ़ेस (यूआई) लेयर को 1080 पिक्सल पर चलाया जा सकता है. ऐसे डिवाइसों पर, कॉन्टेंट को डिसप्ले के पूरे रिज़ॉल्यूशन पर रेंडर करने के लिए, SurfaceView का इस्तेमाल किया जाना चाहिए. Util.getCurrentDisplayModeSize का इस्तेमाल करके, डिसप्ले के पूरे रिज़ॉल्यूशन (डिसप्ले के मौजूदा मोड में) के बारे में क्वेरी की जा सकती है. Android के Display.getSize एपीआई का इस्तेमाल करके, यूज़र इंटरफ़ेस (यूआई) लेयर के रिज़ॉल्यूशन के बारे में क्वेरी की जा सकती है.

ध्यान दें: अगर AndroidView में PlayerView का इस्तेमाल किया जा रहा है, तो हम कंपैटिबिलिटी की गारंटी नहीं दे सकते, क्योंकि PlayerView को Compose को ध्यान में रखकर नहीं बनाया गया था. SDK_INT == 34 से जुड़ी एक आम समस्या यह है कि स्ट्रेच किया गया/काटा गया/लीक हुआ ऐसा Surface होता है जो पैरंट कंटेनर (AspectRatioFrameLayout) से सही तरीके से मेल नहीं खाता. PlayerView.setEnableComposeSurfaceSyncWorkaround को कॉल करके, कंपोज़ फ़ंक्शन के लिए वर्कअराउंड में ऑप्ट इन किया जा सकता है. हालांकि, ध्यान दें कि इससे एक्सएमएल पर आधारित शेयर किए गए ट्रांज़िशन में समस्याएं आती हैं.

Compose में कोई सर्फ़ेस टाइप चुनना

Compose में, इंटरऑप सलूशन AndroidView कंपोज़ेबल का इस्तेमाल करके SurfaceView और TextureView को रैप करता है. इसके लिए, दो कंपोज़ेबल AndroidExternalSurface और AndroidEmbeddedExternalSurface का इस्तेमाल किया जाता है.

Media3 ui-compose मॉड्यूल, PlayerSurface कंपोज़ेबल उपलब्ध कराता है. यह Player को लाइफ़साइकल के हिसाब से Surface से लिंक करता है. इस मामले में, ये प्लैटफ़ॉर्म टाइप हैं:

• SURFACE_TYPE_SURFACE_VIEW (AndroidExternalSurface को असरदार तरीके से)
• SURFACE_TYPE_TEXTURE_VIEW (असरदार तरीके से AndroidEmbeddedExternalSurface)

कोई टाइप none नहीं है, क्योंकि यह आपकी Compose UI ट्री में PlayerSurface को शामिल न करने से मेल खाएगा.