इस पेज पर, Media3 की मदद से वीडियो चलाने के लिए इस्तेमाल किए जा सकने वाले अलग-अलग तरह के सरफ़ेस के बारे में बताया गया है. साथ ही, अपने इस्तेमाल के उदाहरण के लिए सही टाइप चुनने का तरीका भी बताया गया है. Android में Surface ऑब्जेक्ट के बारे में ज़्यादा जानने के लिए, यह ग्राफ़िक्स दस्तावेज़ पढ़ें.
प्लैटफ़ॉर्म सेट करना
Player के वीडियो आउटपुट को किसी Surface से कनेक्ट करने के लिए, चार एंट्री पॉइंट होते हैं:
void setVideoSurface(@Nullable Surface surface)void setVideoSurfaceHolder(@Nullable SurfaceHolder surfaceHolder)void setVideoSurfaceView(@Nullable SurfaceView surfaceView)void setVideoTextureView(@Nullable TextureView textureView)
इसे मिटाने के अलग-अलग तरीके भी हैं:
void clearVideoSurface()void clearVideoSurface(@Nullable Surface surface)void clearVideoSurfaceHolder(@Nullable SurfaceHolder surfaceHolder)void clearVideoSurfaceView(@Nullable SurfaceView surfaceView)void clearVideoTextureView(@Nullable TextureView textureView)
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 का इस्तेमाल किया जाना चाहिए. वीडियो चलाने के लिए, TextureView के मुकाबले SurfaceView के कई फ़ायदे हैं:
- कई डिवाइसों पर बैटरी की खपत काफ़ी कम होती है.
- ज़्यादा सटीक फ़्रेम टाइमिंग, जिससे वीडियो बेहतर तरीके से चलता है.
- ज़रूरी शर्तें पूरी करने वाले डिवाइसों पर, अच्छी क्वालिटी वाले एचडीआर वीडियो आउटपुट की सुविधा.
- डीआरएम से सुरक्षित कॉन्टेंट चलाते समय, सुरक्षित आउटपुट के लिए सहायता.
- Android TV डिवाइसों पर, वीडियो वाला कॉन्टेंट डिसप्ले के फ़ुल रिज़ॉल्यूशन पर रेंडर करने की सुविधा. ये डिवाइस, यूज़र इंटरफ़ेस (यूआई) लेयर को अपस्केल करते हैं.
इसलिए, जहां भी हो सके TextureView के बजाय SurfaceView को प्राथमिकता दी जानी चाहिए.
TextureView का इस्तेमाल सिर्फ़ तब किया जाना चाहिए, जब SurfaceView आपकी ज़रूरतों को पूरा न करे. इसका एक उदाहरण यह है कि Android 7.0 (एपीआई लेवल 24) से पहले के वर्शन में, वीडियो की सतह पर स्मूद ऐनिमेशन या स्क्रोलिंग की ज़रूरत होती है. इसके बारे में यहां दी गई जानकारी में बताया गया है. इस मामले में, TextureView का इस्तेमाल सिर्फ़ तब करें, जब SDK_INT 24 (Android 7.0) से कम हो. इसके अलावा, अन्य मामलों में SurfaceView का इस्तेमाल करें.
Compose में किसी प्लैटफ़ॉर्म का टाइप चुनना
Compose में, इंटरऑपरेबिलिटी के लिए AndroidView कंपोज़ेबल का इस्तेमाल किया जाता है. इससे SurfaceView और TextureView को रैप किया जाता है. इसके लिए, androidx.compose.foundation से AndroidExternalSurface और AndroidEmbeddedExternalSurface, ये दो कंपोज़ेबल इस्तेमाल किए जाते हैं. हालांकि, ये प्रॉक्सी क्लास एक एपीआई उपलब्ध कराती हैं, जो मौजूदा व्यू के ऐक्सेस को सीमित करता है. Player को इन व्यू की ज़रूरत होती है, ताकि वह सतह की पूरी लाइफ़साइकल (बनाना और साइज़ अपडेट करना) को मैनेज कर सके.
media3-ui-compose मॉड्यूल में, आपको ContentFrame और PlayerSurface कंपोज़ेबल मिल सकते हैं. ये Player को Surface से लिंक करते हैं. ऐसा लाइफ़साइकल के हिसाब से किया जाता है. इस मामले में, ये प्लैटफ़ॉर्म शामिल हैं:
androidx.media3.ui.compose.SURFACE_TYPE_SURFACE_VIEWandroidx.media3.ui.compose.SURFACE_TYPE_TEXTURE_VIEW
none टाइप का कोई कंपोज़िशन नहीं होता, क्योंकि इसका मतलब यह होगा कि कंपोज़ेबल को Compose के यूज़र इंटरफ़ेस (यूआई) ट्री में शामिल नहीं किया गया है.
Compose में वीडियो के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात), डाइनैमिक विंडो साइज़िंग, और कॉन्टेंट स्केलिंग को मैनेज करने का तरीका जानने के लिए, अलग-अलग डिवाइस के साइज़ के हिसाब से मीडिया कॉन्टेंट को स्केल करना लेख पढ़ें.