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

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

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

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

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

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

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

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

मुक्तियाँ

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

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

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

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