टेंप्लेट वाला मीडिया ऐप्लिकेशन बनाना

टेंप्लेट वाले मीडिया ऐप्लिकेशन, बीटा वर्शन में उपलब्ध हैं
फ़िलहाल, Google Play Store पर इंटरनल टेस्टिंग और क्लोज़्ड टेस्टिंग ट्रैक के लिए, टेंप्लेट वाले मीडिया ऐप्लिकेशन पब्लिश किए जा सकते हैं. ओपन ट्रैक और प्रोडक्शन ट्रैक पर पब्लिश करने की अनुमति बाद में दी जाएगी.

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

इस गाइड में यह माना गया है कि आपके पास पहले से ही ऐसा मीडिया ऐप्लिकेशन है जो फ़ोन पर ऑडियो चलाता है. साथ ही, यह भी माना गया है कि आपका मीडिया ऐप्लिकेशन, Android मीडिया ऐप्लिकेशन आर्किटेक्चर के मुताबिक है. Car App Library की मदद से, ऐप्लिकेशन में मौजूद अनुभव को टेंप्लेट से बदला जा सकता है. इसके लिए, कार के लिए मीडिया ऐप्लिकेशन बनाएं MediaBrowser डेटा स्ट्रक्चर का इस्तेमाल करके बनाए गए टेंप्लेट की ज़रूरत नहीं होती. आपको अब भी प्लेबैक कंट्रोल के लिए MediaSession और MediaBrowserService या MediaLibraryService देना होगा. इसका इस्तेमाल, सुझावों और अन्य स्मार्ट अनुभवों के लिए किया जाता है.

पार्क-टू-ड्राइव की सुविधा अब बीटा वर्शन में उपलब्ध है
टेंप्लेट वाले मीडिया ऐप्लिकेशन में अब Android Automotive OS पर, गाड़ी पार्क होने पर इस्तेमाल होने वाले ऐप्लिकेशन की सुविधा जोड़ी जा सकती है. इससे आपका ऐप्लिकेशन, कार पार्क होने पर अडैप्टिव नेटिव गतिविधियां जोड़ सकता है. साथ ही, कार चलने पर टेंप्लेट वाले मीडिया प्लेबैक अनुभव पर आसानी से स्विच कर सकता है.

अपने ऐप्लिकेशन के मेनिफ़ेस्ट को कॉन्फ़िगर करना

कार के लिए Android ऐप्लिकेशन की लाइब्रेरी का इस्तेमाल करना लेख में बताए गए चरणों के अलावा, टेंप्लेट वाले मीडिया ऐप्लिकेशन के लिए ये ज़रूरी शर्तें पूरी करनी होंगी:

अपनी मेनिफ़ेस्ट फ़ाइल में, कैटगरी के लिए सहायता का एलान करना

आपके ऐप्लिकेशन को CarAppService के इंटेंट फ़िल्टर में, androidx.car.app.category.MEDIA कार ऐप्लिकेशन की कैटगरी का एलान करना होगा.

<application>
    ...
   <service
       ...
        android:name=".MyCarAppService"
        android:exported="true">
      <intent-filter>
        <action android:name="androidx.car.app.CarAppService" />
        <category android:name="androidx.car.app.category.MEDIA"/>
      </intent-filter>
    </service>
    ...
<application>

MediaPlaybackTemplate का ऐक्सेस पाने के लिए, आपके ऐप्लिकेशन को अपनी मेनिफ़ेस्ट फ़ाइल में androidx.car.app.MEDIA_TEMPLATES अनुमति का एलान भी करना होगा:

<manifest ...>
  ...
  <uses-permission android:name="androidx.car.app.MEDIA_TEMPLATES"/>
  ...
</manifest>

कार ऐप्लिकेशन के लिए कम से कम एपीआई लेवल सेट करना

MediaPlaybackTemplate का इस्तेमाल करने वाले मीडिया ऐप्लिकेशन, सिर्फ़ CAL API 8 और इसके बाद के वर्शन पर काम करते हैं. पक्का करें कि Car App API level कम से कम 8 पर सेट हो.

<application ...>
  ...
  <meta-data
    android:name="androidx.car.app.minCarApiLevel"
    android:value="8"/>
  ...
</application>

एट्रिब्यूशन आइकॉन उपलब्ध कराना

कार ऐप्लिकेशन की लाइब्रेरी का इस्तेमाल करके बनाए गए मीडिया ऐप्लिकेशन के लिए, एट्रिब्यूशन आइकॉन ज़रूर जोड़ें.

Android Auto के साथ काम करने की जानकारी देना

पक्का करें कि आपके ऐप्लिकेशन के मेनिफ़ेस्ट में यह शामिल हो:

<application>
  ...
  <meta-data android:name="com.google.android.gms.car.application"
      android:resource="@xml/automotive_app_desc"/>
  ...
</application>

इसके बाद, अपने एक्सएमएल रिसॉर्स में automotive_app_desc.xml में टेंप्लेट डिक्लेरेशन जोड़ें. यह कुछ ऐसा दिखना चाहिए:

<automotiveApp xmlns:android="http://schemas.android.com/apk/res/android">
 <uses name="media"/>
 <uses name="template"/>
</automotiveApp>

Android Automotive OS के साथ काम करने की जानकारी देना

Android Automotive OS पर, कार में इस्तेमाल किए जाने वाले ऐप्लिकेशन की लाइब्रेरी की सुविधा वाले मीडिया ऐप्लिकेशन को दो अलग-अलग तरीकों से उपलब्ध कराया जा सकता है: एक APK के तौर पर या दो अलग-अलग APK के तौर पर. अगर आपने एक ही APK उपलब्ध कराया है, तो वह उन गाड़ियों के साथ काम करेगा जिनमें Car App Library होस्ट के साथ Android Automotive OS चालू है. अगर ऐसा नहीं है, तो वह MediaBrowserService या MediaLibraryService ऐप्लिकेशन पर वापस चला जाएगा. भले ही, Android के पुराने वर्शन (Android 10 से Android 13 तक) इस्तेमाल किए जा रहे हों. अगर आपको दो अलग-अलग APK उपलब्ध कराने हैं, तो Car App Library के नए वर्शन में नई सुविधाएं जोड़ी जा सकती हैं. इससे आपके ऐप्लिकेशन के MediaBrowserService या MediaLibraryService वर्शन पर कोई असर नहीं पड़ेगा.

एक APK डिस्ट्रिब्यूट करना

कार के लिए ऐप्लिकेशन लाइब्रेरी और आपके ऐप्लिकेशन के MediaBrowserService या MediaLibraryService वर्शन के लिए एक APK उपलब्ध कराते समय, android.software.car.templates_host.media को android:required="false" पर सेट करना ज़रूरी है.

<uses-feature android:name="android.software.car.templates_host.media" android:required="false"/>

इसके बाद, AAOS के लिए कार ऐप्लिकेशन लाइब्रेरी के दिशा-निर्देशों का पालन करें और लॉन्च की जा सकने वाली CarAppActivity (या ट्रैंपोलीन गतिविधि) को शामिल करें. आपको मेनिफ़ेस्ट में, गतिविधि को android:enabled="false" पर सेट करना होगा. इसके बाद, MediaBrowserService डिक्लेरेशन में एक मेटाडेटा टैग जोड़ें. इससे पता चलेगा कि CarAppActivity कॉम्पोनेंट को इसकी जगह इस्तेमाल किया जा सकता है. उदाहरण के तौर पर दिया गया यह मेनिफ़ेस्ट देखें:

<service android:name=".media.MyMediaService"
    android:exported="true"
    android:label="@string/app_name">
    <intent-filter>
        <action android:name="androidx.media3.session.MediaLibraryService"/>
    </intent-filter>

    <!-- Link to Car App Library Activity -->
    <meta-data
        android:name="androidx.car.app.media.CalMediaActivityComponent"
        android:value="com.example.mediaapp.LaunchableTrampoline"/>
</service>

<activity
    android:name=".LaunchableTrampoline"
    android:exported="true"
    android:theme="@android:style/Theme.DeviceDefault.NoActionBar"
    android:launchMode="singleTask"
    android:label="@string/app_name_cal"
    android:enabled="false"> <!-- Set to false -->

    <meta-data android:name="distractionOptimized" android:value="true" />

    <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <action android:name="androidx.car.app.media.action.SHOW_MEDIA_PLAYBACK"/>
        <category android:name="android.intent.category.LAUNCHER"/>
    </intent-filter>
</activity>

Google Play पर डिस्ट्रिब्यूशन

Car App Library और MediaBrowserService या MediaLibraryService वाले आपके APK को, ज़्यादा वर्शन कोड और Android 14 (34) को टारगेट करने वाले minSdk के साथ चालू किया जाना चाहिए.

दो APK के साथ डिस्ट्रिब्यूट करना

दो अलग-अलग APK उपलब्ध कराने के लिए, एक में Car App Library और दूसरे में MediaBrowserService या MediaLibraryService का इस्तेमाल करें. इसके लिए, यह तरीका अपनाएं. इससे यह पक्का किया जा सकेगा कि कार की सही सुविधाओं को टारगेट किया गया है.

अपने ऐप्लिकेशन के Car App Library वर्शन के लिए अलग APK बनाते समय, आपको android.software.car.templates_host.media को android:required=true पर सेट करना होगा. इससे यह पक्का होता है कि ऐप्लिकेशन को सिर्फ़ Android Automotive OS के उन बिल्ड पर उपलब्ध कराया जाए जो कार के लिए ऐप्लिकेशन लाइब्रेरी के होस्ट के साथ काम करने के लिए सर्टिफ़ाइड हैं.

<uses-feature android:name="android.software.car.templates_host.media" android:required="true"/>

android.software.car.templates_host.media का इस्तेमाल करने और इसे android:required=true पर सेट करने के अलावा, कार के लिए ऐप्लिकेशन लाइब्रेरी की लॉन्च की जा सकने वाली गतिविधि के लिए, Android Automotive OS को चालू करने के लिए यह तरीका अपनाएं.

Play Distribution

कार ऐप्लिकेशन की लाइब्रेरी का इस्तेमाल करने वाले APK को Automotive OS के लिए खास तौर पर बनाए गए ट्रैक में डिस्ट्रिब्यूट किया जाना चाहिए.

बोलकर फ़ोन का इस्तेमाल करने की सुविधा

अपने ऐप्लिकेशन में बोलकर इस्तेमाल करने की सुविधा चालू करें, ताकि उपयोगकर्ता बोलकर सामान्य कार्रवाइयां कर सकें. लागू करने के बारे में ज़्यादा जानकारी पाने के लिए, मीडिया के लिए बोलकर फ़ोन का इस्तेमाल करने की सुविधा देखें. अगर आपको टेंप्लेट वाले मीडिया ऐप्लिकेशन में बोलकर दिया गया कोई निर्देश मिलता है, तो आपको खोज के नतीजों के साथ अपने MediaBrowserService या MediaLibraryService को अपडेट करने की ज़रूरत नहीं है. इसके बजाय, अपने मीडिया प्लेबैक टेंप्लेट में कोई कार्रवाई जोड़ें. इससे उपयोगकर्ता, उस प्ले या सर्च क्वेरी के आधार पर ज़्यादा कॉन्टेंट ढूंढ पाएगा. VC-1 क्वालिटी के दिशा-निर्देशों का पालन करने के लिए, बोले गए निर्देशों की सुविधा उपलब्ध कराना ज़रूरी है.

प्लेबैक टेंप्लेट बनाना

MediaPlaybackTemplate, Car App Library के मीडिया ऐप्लिकेशन में मीडिया प्लेबैक की जानकारी दिखाता है. इस टेंप्लेट की मदद से, टाइटल और पसंद के मुताबिक कार्रवाइयों के साथ हेडर सेट किया जा सकता है. वहीं, मीडिया की जानकारी और प्लेबैक कंट्रोल, आपके ऐप्लिकेशन के MediaSession की स्थिति के आधार पर होस्ट से पॉप्युलेट होते हैं.

म्यूज़िक प्लेयर में, समर फ़ील्डिंग का गाना, साउंड्स ऑफ़ स्प्रिंग दिख रहा है. साथ ही, गिटार बजाती हुई एक महिला का स्क्वेयर पोर्ट्रेट दिख रहा है.

पहली इमेज: MediaPlaybackTemplate, जिसमें सबसे ऊपर मौजूद हेडर ऐक्शन की मदद से सूची को खोला जा सकता है.

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

val playbackTemplate = MediaPlaybackTemplate.Builder()
      .setHeader(
        Header.Builder()
          .setStartHeaderAction(Action.BACK)
          .addEndHeaderAction(
                Action.Builder()
                  .setTitle(model.context.getString(R.string.queue_button_title))
                  .setIcon(
                    CarIcon.Builder(
                        IconCompat.createWithResource(
                          model.context,
                          R.drawable.gs_queue_music_vd_theme_24,
                        ))
                      .build())
                  .setOnClickListener(showQueueScreen())
                  .build())
          .setTitle(model.context.getString(R.string.media_playback_view_title))
          .build())
      .build()

MediaPlaybackTemplate का इस्तेमाल करते समय, CarAppService में MediaPlaybackManager का इस्तेमाल करके, MediaSession टोकन रजिस्टर करें. ऐसा न करने पर, होस्ट को MediaPlaybackTemplate भेजने पर गड़बड़ी का मैसेज दिखता है.

import androidx.car.app.media.MediaPlaybackManager
…

override fun onCreateSession(sessionInfo: SessionInfo): Session {
    return object : Session() {
        …

        init {
          lifecycle.addObserver(
            LifecycleEventObserver { _, event ->
              if (event == ON_CREATE) {
                val token = ... // MediaSessionCompat.Token
                (carContext.getCarService(CarContext.MEDIA_PLAYBACK_SERVICE) as MediaPlaybackManager)
                  .registerMediaPlaybackToken(token)
              }
              ...
            }
          )
        }
    }
}

.registerMediaPlaybackToken, Android Auto को मीडिया प्लेबैक की जानकारी और कंट्रोल दिखाने के लिए ज़रूरी है. यह होस्ट के लिए भी ज़रूरी है, ताकि वह मीडिया के हिसाब से सूचनाएं बना सके.

Media3 लाइब्रेरी का इस्तेमाल करने वाले ऐप्लिकेशन के लिए, स्टैंडर्ड MediaSessionCompat.Token के बजाय PlatformToken का इस्तेमाल किया जाता है. इसके लिए, आपको अपने MediaLibrarySession.Callback में कस्टम SessionCommand लागू करना होगा. इससे सेशन के मौजूदा प्लैटफ़ॉर्म का टोकन मिलता है: session.platformToken. अपने CarAppService में, सेशन को यह कस्टम कमांड भेजें. प्लैटफ़ॉर्म टोकन मिलने के बाद, उसे MediaSessionCompat.Token.fromToken(platformToken) का इस्तेमाल करके बदलें. इसके बाद, इस कंपैट टोकन को .registerMediaPlaybackToken() में कार ऐप्लिकेशन की लाइब्रेरी को पास करें.

टेंप्लेट का इस्तेमाल करके मीडिया व्यवस्थित करना

गाने या एल्बम जैसे मीडिया को ब्राउज़ करने के लिए व्यवस्थित करना हो, तो हमारा सुझाव है कि आप SectionedItemTemplate का इस्तेमाल करें. इसकी मदद से, GridSection और RowSection को एक साथ इस्तेमाल करके, ऐसे लेआउट बनाए जा सकते हैं जिनमें इमेज और टेक्स्ट आइटम की सूचियां शामिल हों.

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

दूसरी इमेज: एक SectionedItemTemplate, जिसमें RowSection के बाद GridSection शामिल है

TabTemplate में SectionedItemTemplate का इस्तेमाल करना

अपने ऐप्लिकेशन में मीडिया को कैटगरी में बांटने का एक आसान तरीका है, TabTemplate में SectionedItemTemplate का इस्तेमाल करना.

val template =
      SectionedItemTemplate.Builder()...build();
val tabTemplate =
      TabTemplate.Builder(tabCallback)
          .setTabContents(TabContents.Builder(template).build)
          .setHeaderAction(Action.APP_ICON)
          …
          .build();

कार ऐप्लिकेशन की लाइब्रेरी 1.9 के कॉम्पोनेंट और सुविधाएं

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

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

तीसरी इमेज: एक SectionedItemTemplate, जिसमें Chips, Condensed Items, एक Interactive Header, Grid Items, और एक Minimized Control Panel शामिल है

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

चौथी इमेज: मीडिया ब्राउज़ करने वाली दो स्क्रीन, जिनमें Expanded Header, Spotlight Sections, और Progress Bars शामिल हैं

इन टेंप्लेट का इस्तेमाल करके, अपने मीडिया ऐप्लिकेशन के यूज़र इंटरफ़ेस को डिज़ाइन करने के तरीके के बारे में ज़्यादा जानने के लिए, मीडिया ऐप्लिकेशन देखें.

मीडिया ब्राउज़ करते समय, यह ज़रूरी है कि उपयोगकर्ता कम से कम रुकावट के साथ, MediaPlaybackTemplate पर तुरंत नेविगेट कर सके. MFT-1 क्वालिटी की ज़रूरी शर्त को पूरा करने के लिए, आपके ऐप्लिकेशन में मीडिया ब्राउज़ करने वाली सभी स्क्रीन से MediaPlaybackTemplate को ऐक्सेस करने का तरीका होना चाहिए.

अगर SectionedItemTemplate का इस्तेमाल किया जा रहा है, तो ऐसा करने के लिए एक ऐक्शन बटन जोड़ें. यह बटन, आपको मीडिया प्लेबैक स्क्रीन पर ले जाएगा. कार ऐप्लिकेशन की लाइब्रेरी Action.MEDIA_PLAYBACK की स्टैंडर्ड कार्रवाई का इस्तेमाल करें. मीडिया ऐप्लिकेशन, इस कार्रवाई को छोटे किए गए कंट्रोल पैनल के तौर पर दिखाएगा. अगर कार में इस्तेमाल किए जाने वाले ऐप्लिकेशन की लाइब्रेरी के एपीआई 1.9 या इसके बाद के वर्शन का इस्तेमाल किया जा रहा है, तो MFT-1 क्वालिटी की ज़रूरी शर्त को पूरा करने के लिए, यह ज़रूरी है. अन्य टेंप्लेट के लिए, हेडर ऐक्शन का इस्तेमाल करके भी ऐसा किया जा सकता है.

सिस्टम मीडिया प्लेबैक इंटेंट मैनेज करना

जब किसी ऐप्लिकेशन को मीडिया कार्ड जैसे मीडिया चलाने वाले सिस्टम से लॉन्च किया जाता है, तो उपयोगकर्ता को MediaPlaybackTemplate पर रीडायरेक्ट करना ज़रूरी होता है. हम चाहते हैं कि मीडिया ऐप्लिकेशन इस Intent Action को हैंडल करें, ताकि उपयोगकर्ताओं को बेहतर अनुभव मिल सके.

androidx.car.app.media.action.SHOW_MEDIA_PLAYBACK कार्रवाई को अपनी कार के ऐप्लिकेशन की लाइब्रेरी के कॉम्पोनेंट (CarAppActivity या ट्रैंपोलीन Activity) के इंटेंट-फ़िल्टर में जोड़ें.

पक्का करें कि आपकी गतिविधि में singleTask या singleTop का launchMode इस्तेमाल किया गया हो, ताकि onNewIntent() को शुरू किया जा सके.

<activity
    android:name=".LaunchableTrampoline"
    android:exported="true"
    android:theme="@android:style/Theme.DeviceDefault.NoActionBar"
    android:launchMode="singleTask"
    android:label="@string/app_name_cal"
    android:enabled="false">

    <meta-data android:name="distractionOptimized" android:value="true" />

    <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <action android:name="androidx.car.app.media.action.SHOW_MEDIA_PLAYBACK"/>
        <category android:name="android.intent.category.LAUNCHER"/>
    </intent-filter>
</activity>

अपनी Session क्लास में, आने वाले इंटेंट को पार्स करने के लिए onNewIntent() को बदलें. अगर इनकमिंग इंटेंट ऐक्शन SHOW_MEDIA_PLAYBACK से मैच करता है, तो उपयोगकर्ता को Now Playing स्क्रीन पर ले जाएं.

@Override
public void onNewIntent(@NonNull Intent intent) {
    super.onNewIntent(intent);
    if (SHOW_MEDIA_PLAYBACK.equals(intent.getAction())) {
        ScreenManager screenManager = getCarContext().getCarService(ScreenManager.class);
        // Avoid redundant navigation if already on the playing screen
        if (screenManager.getTop() instanceof MyMediaPlayScreen) {
            return;
        }
        screenManager.push(MyMediaPlayScreen.createScreenFromPlaying(
                getCarContext(), mMediaSessionController));
    }
}

अगर ट्रैम्पोलीन गतिविधि का इस्तेमाल किया जा रहा है, तो onCreate() में इंटेंट ऐक्शन देखें. finish() को कॉल करने से पहले, इस कार्रवाई को CarAppActivity बनाने के इंटेंट को पास करें.

public class LaunchableTrampoline extends AppCompatActivity {
    private static final String SHOW_MEDIA_PLAYBACK = "androidx.car.app.media.action.SHOW_MEDIA_PLAYBACK";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        Intent receivedIntent = getIntent();
        String action;

        if (SHOW_MEDIA_PLAYBACK.equals(receivedIntent.getAction())) {
            action = SHOW_MEDIA_PLAYBACK;
        } else {
            action = Intent.ACTION_MAIN;
        }

        Intent intent = new Intent(action);
        intent.setClassName(getPackageName(), "androidx.car.app.activity.CarAppActivity");
        startActivity(intent);
        finish();
    }
}