पिक्चर में पिक्चर (पीआईपी) Jetpack लाइब्रेरी, Android ऐप्लिकेशन डेवलपर के लिए पीआईपी की सुविधा लागू करने का एक आसान और मज़बूत समाधान उपलब्ध कराती है. यह खास तौर पर मीडिया चलाने, वीडियो कम्यूनिकेशन, और नेविगेशन ऐप्लिकेशन के लिए है. यह लाइब्रेरी, यूनिफ़ाइड एपीआई उपलब्ध कराती है. इससे बॉयलरप्लेट कोड और ऐप्लिकेशन में होने वाली सामान्य गड़बड़ियों को ठीक करने में मदद मिलती है. साथ ही, इससे पीआईपी सुविधा का इस्तेमाल करने वाले लोगों को बेहतर अनुभव मिलता है.
PiP Jetpack लाइब्रेरी, मौजूदा PiP API को बेहतर बनाती है. साथ ही, Android इकोसिस्टम में आने वाली कई मुख्य चुनौतियों और गड़बड़ियों को ठीक करती है:
- ओएस फ़्रैगमेंटेशन: यह लाइब्रेरी, अलग-अलग Android वर्शन पर PiP API कॉल में होने वाले अंतर को अपने-आप मैनेज करती है. जैसे, Android 12 से पहले
enterPictureInPictureModeऔर बाद मेंisAutoEnterEnabledका इस्तेमाल करना. इसलिए, डेवलपर को वर्शन के अंतर को मैनेज करने की ज़रूरत नहीं होती. - PiP के गलत पैरामीटर: यह PiP के पैरामीटर को सही तरीके से सेट करने के लिए, एक जैसा समाधान उपलब्ध कराता है. उदाहरण के लिए, मीडिया चलाने के दौरान बेहतर और अच्छी क्वालिटी वाले ऐनिमेशन बनाने के लिए
setSourceRectHint. - पीआईपी मोड की स्थिति के लिए एक ही तरह के कॉलबैक: यह
onPictureInPictureModeChangedऔरonPictureInPictureUiStateChangedको एक ही तरह के कॉलबैक इंटरफ़ेस (PictureInPictureDelegate.OnPictureInPictureEventListener) में शामिल करता है, ताकि स्थिति और यूज़र इंटरफ़ेस (यूआई) को आसानी से मैनेज किया जा सके. - बॉयलरप्लेट कोड कम करना: यह लाइब्रेरी, बार-बार इस्तेमाल होने वाले बॉयलरप्लेट कोड को कम करती है. इसके लिए, यह सामान्य इस्तेमाल के मामलों के लिए,
RemoteActionsके पहले से तय किए गए सेट उपलब्ध कराती है. जैसे, वीडियो चलाने के कंट्रोल और वीडियो कॉल की कार्रवाइयां. - आने वाले समय में भी काम करने वाली सुविधाएँ: PiP की अन्य सुविधाएँ, Jetpack लाइब्रेरी के ज़रिए उपलब्ध कराई जाती हैं. इससे, इन्हें अपनाने वाले लोगों को कम से कम या बिना किसी मेहनत के अतिरिक्त सुविधाएँ ऐक्सेस करने की अनुमति मिलती है.
Jetpack का इस्तेमाल करना
Jetpack लाइब्रेरी का इस्तेमाल करने के लिए, कस्टम PiP लागू करने के मौजूदा तरीके को Jetpack लाइब्रेरी के एपीआई से बदलें. ऐप्लिकेशन में मौजूदा समय में लागू किए गए तरीके के आधार पर, इसे लागू करने में आने वाली मुश्किलों और लागत में अंतर होगा.
यहां दिए गए सेक्शन में, PiP के इस्तेमाल के कुछ सामान्य उदाहरणों के बारे में बताया गया है. साथ ही, इसे लागू करने के ज़रूरी चरणों के बारे में भी बताया गया है:
नेविगेशन
ऐप्लिकेशन, लाइब्रेरी को नेविगेशन के चालू या बंद होने की स्थिति के बारे में बताता है. साथ ही, यह पहलू का अनुपात सेट करता है. बाकी काम Jetpack लाइब्रेरी करती है.
मुख्य अंतर:
- ऐप्लिकेशन के लिए, ऑटो-एंटर और लेगसी-एंटर के बीच अंतर करने की ज़रूरत नहीं है.
- कॉलबैक इंटरफ़ेस को एक साथ इस्तेमाल किया जा सकता है.
- पुराने सिस्टम के साथ काम करने की सुविधा के लिए, नया
PictureInPictureParamsबिल्डर.
वीडियो कॉल
ऐप, लाइब्रेरी को कॉल के चालू या बंद होने की स्थिति के बारे में बताता है. साथ ही, आसपेक्ट रेशियो सेट करता है.
मुख्य अंतर:
- ऐप्लिकेशन के लिए, ऑटो-एंटर और लेगसी-एंटर के बीच अंतर करने की ज़रूरत नहीं है.
- कॉलबैक इंटरफ़ेस को एक साथ इस्तेमाल किया जा सकता है.
- पुराने सिस्टम के साथ काम करने की सुविधा के लिए, नया
PictureInPictureParamsबिल्डर. - वीडियो कॉल के लिए स्टैंडर्ड ऐक्शन आइकॉन.
वीडियो प्लेबैक
Jetpack लाइब्रेरी, प्लेयर डेलिगेट उपलब्ध कराती है. इन्हें इंटिग्रेट करके, पीआईपी मोड को चालू या बंद किया जा सकता है. साथ ही, सोर्स रेक्टैंगल हिंट को सटीक तरीके से सेट किया जा सकता है.
आपके पास RemoteAction ऑब्जेक्ट के पहले से तय किए गए सेट में ऑप्ट-इन करने का विकल्प भी होता है. ये ऑब्जेक्ट, वीडियो कॉल के दौरान इस्तेमाल किए जाने वाले ऑब्जेक्ट की तरह होते हैं.
मुख्य सुविधाएं:
- यह पुराने वर्शन के साथ काम करता है. इसके लिए, ओएस वर्शन की जांच करने की ज़रूरत नहीं होती.
- प्लेबैक के स्टेटस को सिंक करने और अपने-आप एंट्री होने की सुविधा को कंट्रोल करने के लिए.
SourceRectHintका इस्तेमाल करके, लगातार ज्यामिति को ट्रैक किया जा रहा है.