एईपी दिशा-निर्देश: Media3

मीडिया चलाने, सेशन, एडिटिंग, मेटाडेटा, और फ़्रेम निकालने के लिए, Jetpack Media3 लाइब्रेरी को स्टैंडर्ड के तौर पर इंटिग्रेट करें. इससे यह पक्का किया जा सकेगा कि ऐप्लिकेशन, Android के अलग-अलग फ़ॉर्म फ़ैक्टर पर मीडिया से जुड़े मुश्किल कामों को मैनेज करने के लिए, सुझाए गए एपीआई का इस्तेमाल करें. लेगसी फ़्रेमवर्क एपीआई (जैसे, MediaPlayer, MediaMuxer, और MediaExtractor) से Jetpack Media3 लाइब्रेरी पर माइग्रेट करके, मीडिया आर्किटेक्चर को बेहतर बनाया जा सकता है. इससे एक यूनिफ़ाइड और सुविधाओं से भरपूर टूलकिट मिलती है. यह टूलकिट, मीडिया के एक जैसे अनुभव को पक्का करती है.

लागू करने की ज़रूरी शर्तें

एईपी में शामिल होने के लिए, आपके ऐप्लिकेशन को ये ज़रूरी शर्तें पूरी करनी होंगी:

आईडी दिशा-निर्देश
AEP-M3-GAA लेगसी Android फ़्रेमवर्क एपीआई का इस्तेमाल नहीं करना चाहिए. इनमें MediaPlayer, MediaExtractor, MediaMuxer, और MediaMetadataRetriever शामिल हैं.
AEP-M3-GAB अगर प्लेबैक, उपयोगकर्ता के मुख्य कामों में से एक है, तो ऐप्लिकेशन को ओएस की जानकारी और अलग-अलग डिवाइसों के साथ इंटिग्रेट करने के लिए, मीडिया सेशन को इंटिग्रेट करना होगा.
AEP-M3-GAC अगर ऐप्लिकेशन में ऑडियो कॉन्टेंट की लाइब्रेरी है, तो उसे MediaLibraryService के ज़रिए कॉन्टेंट दिखाना चाहिए. साथ ही, मीडिया को फिर से शुरू करने की सुविधा भी देनी चाहिए.

दिशा-निर्देशों के लागू होने की जानकारी

यह दिशा-निर्देश इन पर लागू होता है:

  • ऐसे ऐप्लिकेशन जो मीडिया (वीडियो या ऑडियो) चलाने या वीडियो में बदलाव करने की सुविधा देते हैं.
  • उन सभी डिवाइसों के साइज़, डाइमेंशन या कॉन्फ़िगरेशन के लिए जिन पर ऐप्लिकेशन उपलब्ध है.

मुक्तियाँ

ऐप्लिकेशन, ऐसे फ़्रेमवर्क का इस्तेमाल कर सकते हैं जो एक जैसा काम करता हो. साथ ही, जो पूरे ईकोसिस्टम में एक जैसी क्वालिटी, उपयोगकर्ताओं के लिए उपलब्ध सुविधाएं, स्थिरता, और कंपैटिबिलिटी देता हो. अगर आपके पास कोई ऐसा फ़्रेमवर्क है जिसे ध्यान में रखा जा सकता है, तो सहायता टीम से संपर्क करें. ज़रूरी शर्तें पूरी करने के लिए, वैकल्पिक तरीके से लागू किए गए समाधान को इन बेंचमार्क को पूरा करना होगा:

आईडी छूट
AEP-M3-EAA तेज़ नेटवर्क पर, उपयोगकर्ता के वीडियो चलाने के 500 मि॰से॰ के अंदर, वीडियो का पहला फ़्रेम दिखना चाहिए.
वीडियो चलाने के दौरान, 30 सेकंड की विंडो में फ़्रेम ड्रॉप नहीं होने चाहिए. साथ ही, ऑडियो में भी कोई रुकावट नहीं आनी चाहिए.
ऐप्लिकेशन को ऑडियो फ़ोकस को सही तरीके से मैनेज करना चाहिए.
ऐप्लिकेशन को हार्डवेयर मीडिया बटन के लिए रिस्पॉन्स देना होगा. भले ही, वह बैकग्राउंड में चल रहा हो.
अगर बैकग्राउंड में वीडियो चलाने की सुविधा उपलब्ध है, तो ऐप्लिकेशन को मीडिया स्टाइल वाली सूचना पोस्ट करनी होगी. साथ ही, फ़ोरग्राउंड सेवा का इस्तेमाल करना होगा.
अगर ऐप्लिकेशन में प्लेबैक फिर से शुरू करने की सुविधा काम करती है, तो उसे मीडिया फिर से शुरू करने की सुविधा लागू करनी होगी.
हेडफ़ोन के डिसकनेक्ट होने पर, ऐप्लिकेशन को सही तरीके से काम करना चाहिए. उदाहरण के लिए, स्पीकर पर स्विच करने के बजाय वीडियो को रोकना.
डिवाइस के ओरिएंटेशन बदलने पर, वीडियो बिना किसी रुकावट के चलना चाहिए.

सुविधा से जुड़े दस्तावेज़ और संसाधन

यहां दिए गए संसाधनों में, Media3 सुविधा को लागू करने के बारे में दिशा-निर्देश और तकनीकी जानकारी दी गई है. ये संसाधन सिर्फ़ आपके रेफ़रंस के लिए हैं. इनमें प्रोग्राम की अन्य ज़रूरी शर्तें शामिल नहीं हैं.