मेनिफ़ेस्ट फ़ाइलें कॉन्फ़िगर करना

Android Auto और Android Automotive OS (AAOS) के साथ इंटिग्रेट करने के लिए, अपने ऐप्लिकेशन की मेनिफ़ेस्ट फ़ाइलें कॉन्फ़िगर करें. इन प्लैटफ़ॉर्म को मीडिया ब्राउज़र सेवा ढूंढने और उससे कनेक्ट करने की अनुमति देने के लिए, मेनिफ़ेस्ट फ़ाइल में अपनी मीडिया ब्राउज़र सेवा के बारे में बताएं. ज़रूरी ऐप्लिकेशन आइकॉन तय करें. इनमें एट्रिब्यूशन आइकॉन के लिए लॉन्चर आइकॉन भी शामिल है. इसका इस्तेमाल सिस्टम यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट, जैसे कि मीडिया कंट्रोल कर सकते हैं.

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

मीडिया ब्राउज़र सेवा के बारे में जानकारी देना

Android Auto और AAOS, मीडिया आइटम ब्राउज़ करने के लिए, मीडिया ब्राउज़र सेवा के ज़रिए आपके ऐप्लिकेशन से कनेक्ट होते हैं. अपनी मेनिफ़ेस्ट फ़ाइल में जाकर, मीडिया ब्राउज़र सेवा के बारे में बताएं. इससे Android Auto और AAOS को सेवा के बारे में पता चलेगा और वे आपके ऐप्लिकेशन से कनेक्ट हो पाएंगे.

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

<application>
    ...
    <service android:name=".MyMediaBrowserService"
             android:exported="true">
        <intent-filter>
            <action android:name="android.media.browse.MediaBrowserService"/>
        </intent-filter>
    </service>
    ...
</application>

ऐप्लिकेशन के आइकॉन तय करना

सिस्टम यूज़र इंटरफ़ेस (यूआई) में अपने ऐप्लिकेशन को दिखाने के लिए, ऐप्लिकेशन के ऐसे आइकॉन तय करें जिनका इस्तेमाल Android Auto और AAOS को करना चाहिए. ये दो आइकॉन ज़रूरी हैं:

लॉन्चर आइकॉन तय करना

लॉन्चर आइकॉन, सिस्टम यूज़र इंटरफ़ेस (यूआई) में आपके ऐप्लिकेशन को दिखाता है. जैसे, लॉन्चर और आइकॉन की ट्रे में.

डिफ़ॉल्ट रूप से, आपके ऐप्लिकेशन के <application> एलिमेंट के android:icon एट्रिब्यूट का इस्तेमाल लॉन्चर आइकॉन के तौर पर किया जाता है:

<application
    ...
    android:icon="@mipmap/ic_launcher"
>

किसी दूसरे आइकॉन का इस्तेमाल करने के लिए, मीडिया ब्राउज़र सेवा के <service> एलिमेंट का android:icon एट्रिब्यूट सेट करें:

<application>
    ...
    <service
        ...
        android:icon="@mipmap/ic_car_launcher"/>
</application>

एट्रिब्यूशन आइकॉन तय करना

एट्रिब्यूशन आइकॉन का इस्तेमाल उन जगहों पर किया जाता है जहां मीडिया कॉन्टेंट को प्राथमिकता दी जाती है. जैसे, मीडिया कार्ड पर. सूचनाओं के लिए इस्तेमाल किए गए छोटे आइकॉन का फिर से इस्तेमाल करें. यह आइकॉन मोनोक्रोम होना चाहिए.

मीडिया कार्ड पर एट्रिब्यूशन आइकॉन

पहली इमेज. मीडिया कार्ड पर एट्रिब्यूशन आइकॉन.

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

<application>
    ...
    <meta-data
        android:name="androidx.car.app.TintableAttributionIcon"
        android:resource="@drawable/ic_status_icon" />
    ...
</application>

अपने ऐप्लिकेशन का लेबल तय करना

डिफ़ॉल्ट रूप से, आपकी कार की स्क्रीन पर ऐप्लिकेशन का डिसप्ले नेम दिखाने के लिए, आपके ऐप्लिकेशन के <application> एलिमेंट के android:label एट्रिब्यूट की वैल्यू का इस्तेमाल किया जाता है.

अगर आपको किसी दूसरे डिसप्ले नेम का इस्तेमाल करना है या आपके ऐप्लिकेशन में कई मीडिया ब्राउज़र सेवाएं हैं, तो मीडिया ब्राउज़र सेवा के <service> एलिमेंट का android:label एट्रिब्यूट सेट करें.

अपने ऐप्लिकेशन के ऐक्सेंट का रंग तय करना

आपके ऐप्लिकेशन के ऐक्सेंट कलर का इस्तेमाल Android Auto और AAOS, कॉन्टेंट चलाने के कंट्रोल और अन्य यूज़र इंटरफ़ेस (यूआई) एलिमेंट को स्टाइल करने के लिए करते हैं.

डिफ़ॉल्ट रूप से, ऐक्सेंट का रंग आपके ऐप्लिकेशन के <application> एलिमेंट के android:theme स्टाइल रिसॉर्स के colorAccent आइटम से लिया जाता है.

अगर आपको कार में मिलने वाले अनुभव के लिए, किसी दूसरे ऐक्सेंट कलर का इस्तेमाल करना है, तो स्टाइल के ऐसे संसाधन के लिए <meta-data> एलिमेंट शामिल करें जिसमें colorAccent आइटम मौजूद हो:

<application>
    ...
    <meta-data
        android:name="com.google.android.gms.car.application.theme"
        android:resource="@style/THEME_NAME"/>
    ...
</application>

प्लैटफ़ॉर्म के हिसाब से कॉन्फ़िगरेशन

इस पेज पर दी गई कॉन्फ़िगरेशन की जानकारी के अलावा, प्लैटफ़ॉर्म के हिसाब से ज़रूरी शर्तें जानने के लिए, यहां दिए गए सेक्शन देखें: