कार ऐप्लिकेशन लाइब्रेरी के साथ काम करने वाले मीडिया ऐप्लिकेशन

मीडिया ऐप्लिकेशन के डेवलपर, Car App Library (CAL) का इस्तेमाल करके अपने ऐप्लिकेशन का यूज़र इंटरफ़ेस बना सकते हैं. यह लाइब्रेरी, CarMediaApp को रेंडर करने के लिए, MediaBrowserService के ज़रिए डेटा उपलब्ध कराने के पारंपरिक तरीके का विकल्प देती है.

CAL पर आधारित टेंप्लेट वाले मीडिया ऐप्लिकेशन की मदद से डेवलपर, यूज़र इंटरफ़ेस को अपनी ब्रैंड आइडेंटिटी के हिसाब से बना सकते हैं. CAL पर आधारित ऐप्लिकेशन के उलट, MediaBrowserService और CarMediaApp का इस्तेमाल करने वाले सामान्य मीडिया ऐप्लिकेशन, डेवलपर को यूज़र इंटरफ़ेस (यूआई) की स्टाइल को पसंद के मुताबिक बनाने की अनुमति नहीं देते. इस स्टाइल को ओईएम कंट्रोल करता है.

डेवलपर, टेंप्लेट वाला मीडिया ऐप्लिकेशन बना सकते हैं. यह ऐप्लिकेशन, Android Auto और Android Automotive OS (AAOS) के साथ काम करता है.

इंटिग्रेट करें

CAL पर आधारित टेंप्लेट वाले मीडिया ऐप्लिकेशन के लिए, प्लैटफ़ॉर्म इंटिग्रेशन ज़रूरी है.

ज़रूरी शर्तें

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

  • ऐप्लिकेशन को कंट्रोल करने के अन्य तरीके, Car-apps-release-14 और इसके बाद के वर्शन में उपलब्ध हैं.

    • इससे ऐप्लिकेशन को बैकग्राउंड में ऑडियो चलाने की अनुमति मिलती है
    • MediaBrowserService का इस्तेमाल न करने वाले ऐप्लिकेशन को अब भी सिस्टम मीडिया कार्ड से कंट्रोल किया जा सकता है.
  • प्लैटफ़ॉर्म को com.android.car.background_audio_while_driving के साथ काम करने की सुविधा के बारे में बताना होगा.

प्लैटफ़ॉर्म में बदलाव

प्लैटफ़ॉर्म के CarMediaApp को ये काम करने होंगे:

  • मीडिया ऐप्लिकेशन की सीएएल गतिविधि चालू करने की अनुमति हो. कोड का उदाहरण देखें.
  • android.software.car.templates_host.media सुविधा के साथ काम करने वाले डिवाइसों पर, मीडिया सेंटर के बजाय CAL गतिविधि लॉन्च करें. कोड का उदाहरण देखें.

प्लैटफ़ॉर्म के Car Launcher में ये चीज़ें होनी चाहिए:

  • CarMediaApp के मीडिया ऐप्लिकेशन की CAL गतिविधि चालू करने के बाद, Car Launcher में सिर्फ़ एक ऐप्लिकेशन आइकॉन दिखे.
  • PACKAGE_CHANGED ब्रॉडकास्ट सुनें और ऐप्लिकेशन की सूची रीफ़्रेश करें. कोड का उदाहरण देखें.

प्लैटफ़ॉर्म के मीडिया कार्ड या विजेट में ये चीज़ें होनी चाहिए:

  • मीडिया कार्ड में, चल रहा ऑडियो दिखाएं.

बिल्ड कॉन्फ़िगरेशन

प्लैटफ़ॉर्म को android.software.car.templates_host.media के साथ काम करने की सुविधा के बारे में बताना होगा:

<permissions>
    <!-- Declare support for templated applications. -->
    <feature name="android.software.car.templates_host" />

    <!-- This feature indicates that the system supports apps that use the
    Car App Library Media category -->
    <feature name="android.software.car.templates_host.media"/>
</permissions>

टेस्ट

TestMediaCalApp का इस्तेमाल करके, CAL पर आधारित मीडिया ऐप्लिकेशन के लिए टेस्ट प्लैटफ़ॉर्म की सुविधा. TestMediaCalApp, Car App Library का इस्तेमाल करके बनाया गया एक मीडिया ऐप्लिकेशन है. इसे Templates Host, प्लैटफ़ॉर्म पर रेंडर करता है.

  1. TestMediaCalApp.apk इंस्टॉल करें.

  2. अपने लॉन्चर पर, Test Media3 CAL App नाम का ऐप्लिकेशन खोलें:

    Car Launcher पर Media3 CAL ऐप्लिकेशन की जांच करना

    पहली इमेज. Car Launcher पर Media3 CAL ऐप्लिकेशन को टेस्ट करें.

  3. ऐप्लिकेशन लॉन्च होने के बाद, लॉन्चर पर वापस जाएं और देखें कि ऐप्लिकेशन का नाम बदलकर Test Media CAL App कर दिया गया है. Test Media3 CAL App नाम वाला पिछला ऐप्लिकेशन अब नहीं दिखना चाहिए:

    Car Launcher पर Media CAL ऐप्लिकेशन को टेस्ट करना

    दूसरी इमेज. Car Launcher पर Media CAL ऐप्लिकेशन को टेस्ट करें.

  4. Test Media CAL App खोलें और प्लेलिस्ट में मौजूद किसी गाने पर टैप करके उसे चलाएं:

    ऐप्लिकेशन होस्ट की ओर से रेंडर किया गया प्लेलिस्ट व्यू

    तीसरी इमेज. ऐप्लिकेशन होस्ट की मदद से रेंडर किया गया प्लेलिस्ट व्यू.

  5. देखें कि 'अभी चल रहा है' व्यू (MediaPlaybackTemplate) खुल गया है:

    App Host की मदद से रेंडर किया गया &#39;अभी चल रहा है&#39; व्यू

    चौथी इमेज. इसमें App Host की मदद से रेंडर किया गया 'अभी चल रहा है' व्यू दिखाया गया है.

  6. देखें कि होम स्क्रीन के मीडिया विजेट में, 'अभी चल रहा है' मेटाडेटा दिखता है या नहीं:

    मीडिया कार्ड

    पांचवीं इमेज. मीडिया कार्ड.