Android Auto या Android Automotive OS पर चलने वाले वाहनों में अपना ऐप्लिकेशन उपलब्ध कराएं. एक ऐसा ऐप्लिकेशन आर्किटेक्चर इस्तेमाल करें जो दोनों मामलों में काम करे, ताकि हर उपयोगकर्ता आपके ऐप्लिकेशन का आनंद ले सके.
कार के लिए Android क्या है?
कार के लिए बनाया गया मीडिया ऐप्लिकेशन, उपयोगकर्ताओं को अपनी डिजिटल लाइफ़ को कार से आसानी से कनेक्ट करने का तरीका उपलब्ध करा सकता है. फ़ोन के लिए बनाए गए ऐप्लिकेशन को कारों के लिए उपलब्ध कराने से, उपयोगकर्ताओं को बेहतर अनुभव मिलता है. इसके लिए, आपको अपने ऐप्लिकेशन को Android Auto या Android Automotive OS के साथ इंटिग्रेट करना होगा.
कार के लिए बनाए गए Android ऐप्लिकेशन में, ड्राइवर का ध्यान भटकने से रोकने की सुविधा सबसे ज़रूरी है. बोलकर दिए जाने वाले निर्देशों और आसान विज़ुअल डिज़ाइन जैसे सबसे सही तरीकों का इस्तेमाल करके, ध्यान भटकने से बचा जा सकता है. इस तरह, आपका मीडिया ऐप्लिकेशन, ड्राइवर को समय पर जानकारी दिखा सकता है. हालांकि, ऐसा सिर्फ़ तब होता है, जब जानकारी काम की हो और सामान्य टास्क के लिए, अनुमानित पैटर्न का इस्तेमाल किया गया हो.
Android Auto
Android Auto, ड्राइवर के लिए ऑप्टिमाइज़ किया गया ऐप्लिकेशन इस्तेमाल करने का अनुभव देता है. यह सुविधा उन लोगों के लिए है जिनके पास Android Auto ऐप्लिकेशन वाला Android फ़ोन और इसके साथ काम करने वाली कार या आफ़्टर मार्केट स्टीरियो सिस्टम है. वे अपने फ़ोन को कनेक्ट करके, सीधे अपनी कार के डिसप्ले पर आपके ऐप्लिकेशन का इस्तेमाल कर सकते हैं. Android Auto को अपने फ़ोन ऐप्लिकेशन से कनेक्ट करने की सुविधा चालू की जा सकती है. इसके लिए, आपको ऐसी सेवाएं बनानी होंगी जिनका इस्तेमाल करके Android Auto, ड्राइवर को उसके हिसाब से ऑप्टिमाइज़ किया गया इंटरफ़ेस दिखा सके.
Android Automotive OS
Android Automotive OS, Android पर आधारित सूचना और मनोरंजन की सुविधा देने वाला डिवाइस है. यह गाड़ियों में पहले से मौजूद होता है. कार का सिस्टम, Android की मदद से काम करने वाला एक अलग डिवाइस होता है. इसे ड्राइविंग के लिए ऑप्टिमाइज़ किया जाता है. Android Automotive OS की मदद से, उपयोगकर्ता आपके ऐप्लिकेशन को अपने फ़ोन के बजाय सीधे कार में इंस्टॉल करते हैं.
इस सुविधा के साथ काम करने वाले ऐप्लिकेशन की कैटगरी
मीडिया ऐप्लिकेशन की मदद से, उपयोगकर्ता कार में संगीत, रेडियो, ऑडियो बुक, और अन्य ऑडियो कॉन्टेंट ब्राउज़ कर सकते हैं और चला सकते हैं. ज़्यादा जानकारी के लिए, कार के लिए ऑडियो प्लेबैक ऐप्लिकेशन बनाना और कार के लिए मीडिया ऐप्लिकेशन बनाना लेख पढ़ें.
मीडिया ऐप्लिकेशन, MediaLibraryService और MediaSession का इस्तेमाल करके बनाए जाते हैं.
Android Automotive OS पर, Views या Compose का इस्तेमाल करके, साइन-इन और सेटिंग स्क्रीन भी बनाई जा सकती हैं. इनका इस्तेमाल, कार पार्क होने के दौरान किया जा सकता है.
वीडियो ऐप्लिकेशन की मदद से, उपयोगकर्ता कार पार्क होने पर वीडियो स्ट्रीम कर सकते हैं. इन ऐप्लिकेशन का मुख्य मकसद, स्ट्रीमिंग वीडियो दिखाना है. ये ऐप्लिकेशन, व्यू या Compose का इस्तेमाल करके बनाए जाते हैं. ज़्यादा जानकारी के लिए, Android Automotive OS के लिए वीडियो चलाने वाले ऐप्लिकेशन बनाना और Android Automotive OS के लिए वीडियो ऐप्लिकेशन बनाना लेख पढ़ें.
कार के लिए ऑडियो प्लेबैक ऐप्लिकेशन बनाना
इस गाइड में यह माना गया है कि आपके पास पहले से ही एक बुनियादी मीडिया प्लेबैक ऐप्लिकेशन है. अगर आपके पास ऐसा कोई ऐप्लिकेशन नहीं है, तो शुरुआत करने के लिए, बेसिक मीडिया प्लेयर ऐप्लिकेशन बनाएं पर जाएं.
इस गाइड में आपको बताया गया है कि आपको क्या करना होगा. इसमें अन्य संसाधनों के लिंक भी शामिल हैं, जिनमें खास दिशा-निर्देश दिए गए हैं.
प्लेबैक कॉम्पोनेंट
Media3, प्लेबैक के इस्तेमाल के उदाहरणों के लिए कई अहम कॉम्पोनेंट उपलब्ध कराता है. अगर आपने Android की पिछली मीडिया लाइब्रेरी के साथ काम किया है, तो आपको इन कॉम्पोनेंट को बनाने वाली क्लास के बारे में जानकारी होगी.
इस डायग्राम में दिखाया गया है कि ये कॉम्पोनेंट, किसी सामान्य ऐप्लिकेशन में एक साथ कैसे काम करते हैं.
ज़्यादा जानकारी के लिए, प्लेबैक कॉम्पोनेंट देखें.
MediaLibraryService और MediaLibrarySession लागू करना
MediaLibraryService
एक स्टैंडर्ड एपीआई उपलब्ध कराता है, ताकि आपकी मीडिया लाइब्रेरी को ऐक्सेस किया जा सके और उसे इस्तेमाल किया जा सके.
अपने मीडिया ऐप्लिकेशन में Android Auto या Android Automotive OS की सुविधा जोड़ते समय, यह ज़रूरी है. ऐसा इसलिए, क्योंकि ये प्लैटफ़ॉर्म आपकी मीडिया लाइब्रेरी के लिए, ड्राइवर के लिए सुरक्षित यूज़र इंटरफ़ेस (यूआई) उपलब्ध कराते हैं. MediaLibraryService को लागू करने और इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, MediaLibraryService की मदद से कॉन्टेंट उपलब्ध कराना लेख पढ़ें.
प्लेबैक कंट्रोल के लिए, मीडिया सेशन का इस्तेमाल करें. MediaSession एपीआई, ऑडियो या वीडियो प्लेयर के साथ इंटरैक्ट करने का एक यूनिवर्सल तरीका उपलब्ध कराता है. Jetpack Media3 लाइब्रेरी में MediaLibrarySession शामिल है. यह MediaSession को एक्सटेंड करता है, ताकि कॉन्टेंट ब्राउज़ करने वाले एपीआई जोड़े जा सकें.
मीडिया सेशन को किसी प्लेयर से कनेक्ट करने पर, ऐप्लिकेशन को मीडिया प्लेबैक का विज्ञापन बाहरी तौर पर दिखाने की सुविधा मिलती है. साथ ही, Android Auto, Android Automotive OS या Google Assistant जैसे बाहरी सोर्स से प्लेबैक के निर्देश पाने की सुविधा मिलती है. ज़्यादा जानकारी के लिए, MediaSession का इस्तेमाल करके, मीडिया प्लेबैक को कंट्रोल करना और उसका विज्ञापन दिखाना और MediaLibrarySession का इस्तेमाल करना लेख पढ़ें.
कम से कम, आपके मीडिया सेशन में प्लेयर के इन निर्देशों के लिए सहायता का एलान होना चाहिए:
प्लेबैक कंट्रोल चालू करें गाइड में, कार में प्लेबैक कंट्रोल को पसंद के मुताबिक बनाने के तरीके बताए गए हैं.
जब Android Auto या Android Automotive OS आपके ऐप्लिकेशन से कनेक्ट होता है, तो वह कॉन्टेंट लाइब्रेरी दिखाने का अनुरोध करता है. इससे onGetLibraryRoot() कॉलबैक का तरीका ट्रिगर होता है. अपनी लाइब्रेरी का ऐक्सेस देने के लिए, रूट मीडिया आइटम को तुरंत वापस लाया जा सकता है. onGetChildren() कॉलबैक का तरीका तब कॉल किया जाता है, जब Android Auto या Android Automotive OS, आपके कॉन्टेंट की लाइब्रेरी के ज़्यादा लेवल ब्राउज़ करने की कोशिश कर रहा हो.
ये प्लैटफ़ॉर्म, आपकी कॉन्टेंट लाइब्रेरी के स्ट्रक्चर पर अतिरिक्त सीमाएं लागू करते हैं. कॉन्टेंट लाइब्रेरी को पसंद के मुताबिक दिखाने के बारे में ज़्यादा जानने के लिए, मीडिया ब्राउज़र सेवा बनाएं गाइड देखें.
Android Auto के साथ काम करने की सुविधा का एलान करना
यह बताने के लिए कि आपका फ़ोन ऐप्लिकेशन Android Auto के साथ काम करता है, मेनिफ़ेस्ट में यह एंट्री इस्तेमाल करें:
<application>
...
<meta-data android:name="com.google.android.gms.car.application"
android:resource="@xml/automotive_app_desc"/>
...
</application>
यह मेनिफ़ेस्ट एंट्री, एक ऐसी एक्सएमएल फ़ाइल के बारे में बताती है जिसमें यह जानकारी होती है कि आपका ऐप्लिकेशन, Automotive की कौनसी सुविधाएं इस्तेमाल कर सकता है. यह बताने के लिए कि आपके पास मीडिया ऐप्लिकेशन है, अपने प्रोजेक्ट की res/xml/ डायरेक्ट्री में automotive_app_desc.xml नाम की एक्सएमएल फ़ाइल जोड़ें. इस फ़ाइल में यह कॉन्टेंट शामिल होना चाहिए:
<automotiveApp>
<uses name="media"/>
</automotiveApp>
Android Automotive OS के साथ काम करने का एलान करना
आपको एक ऑटोमोटिव मॉड्यूल बनाना होगा, क्योंकि आपके ऐप्लिकेशन के सभी लॉजिक को किसी ऑटोमोटिव ऐप्लिकेशन के साथ शेयर नहीं किया जा सकता. Android Automotive OS के कुछ कॉम्पोनेंट, जैसे कि मेनिफ़ेस्ट के लिए, प्लैटफ़ॉर्म के हिसाब से ज़रूरी शर्तें होती हैं. एक ऐसा मॉड्यूल बनाएं जो इन कॉम्पोनेंट के कोड को आपके प्रोजेक्ट के अन्य कोड से अलग रख सके. जैसे, आपके मोबाइल ऐप्लिकेशन के लिए इस्तेमाल किया गया कोड.
अपने प्रोजेक्ट में ऑटोमोटिव मॉड्यूल जोड़ने के लिए, यह तरीका अपनाएं:
- Android Studio में, File > New > New Module पर क्लिक करें.
- ऑटोमोटिव मॉड्यूल को चुनें. इसके बाद, आगे बढ़ें पर क्लिक करें.
- ऐप्लिकेशन/लाइब्रेरी का नाम डालें. यह वह नाम है जो उपयोगकर्ताओं को Android Automotive OS पर आपके ऐप्लिकेशन के लिए दिखता है.
- मॉड्यूल का नाम डालें.
- पैकेज के नाम में बदलाव करें, ताकि वह आपके ऐप्लिकेशन से मैच करे.
कम से कम एसडीके के लिए, एपीआई 28: Android 9.0 (Pie) चुनें. इसके बाद, आगे बढ़ें पर क्लिक करें.
Android Automotive OS के साथ काम करने वाली सभी कारें, Android 9 (एपीआई लेवल 28) या इसके बाद के वर्शन पर काम करती हैं. इसलिए, इस वैल्यू को चुनने पर, इसके साथ काम करने वाली सभी कारों को टारगेट किया जाता है.
कोई गतिविधि नहीं को चुनें. इसके बाद, पूरा करें पर क्लिक करें.
Android Studio में अपना मॉड्यूल बनाने के बाद, अपने नए ऑटोमोटिव मॉड्यूल में AndroidManifest.xml खोलें:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.media">
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme" />
<uses-feature
android:name="android.hardware.type.automotive"
android:required="true" />
</manifest>
application एलिमेंट में, ऐप्लिकेशन की कुछ स्टैंडर्ड जानकारी के साथ-साथ uses-feature एलिमेंट भी होता है. इससे यह पता चलता है कि ऐप्लिकेशन, Android Automotive OS के साथ काम करता है.
ध्यान दें कि मेनिफ़ेस्ट में किसी भी गतिविधि के बारे में नहीं बताया गया है.
अगर आपने सेटिंग या साइन-इन से जुड़ी गतिविधियां लागू की हैं, तो उन्हें यहां जोड़ें. इन गतिविधियों को सिस्टम, साफ़ तौर पर बताए गए इंटेंट का इस्तेमाल करके ट्रिगर करता है. ये ऐसी गतिविधियां हैं जिन्हें Android Automotive OS ऐप्लिकेशन के लिए, मेनिफ़ेस्ट में एलान किया जाता है.
कोई सेटिंग या साइन-इन से जुड़ी गतिविधियां जोड़ने के बाद, अपनी मेनिफ़ेस्ट फ़ाइल को पूरा करें. इसके लिए, application एलिमेंट में android:appCategory="audio" एट्रिब्यूट सेट करें और ये uses-feature एलिमेंट जोड़ें:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.media">
<application
android:allowBackup="true"
android:appCategory="audio"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme" />
<uses-feature
android:name="android.hardware.type.automotive"
android:required="true" />
<uses-feature
android:name="android.hardware.wifi"
android:required="false" />
<uses-feature
android:name="android.hardware.screen.portrait"
android:required="false" />
<uses-feature
android:name="android.hardware.screen.landscape"
android:required="false" />
</manifest>
इन सुविधाओं को साफ़ तौर पर required="false" पर सेट करने से यह पक्का होता है कि आपका ऐप्लिकेशन, Automotive OS वाले डिवाइसों में उपलब्ध हार्डवेयर सुविधाओं के साथ काम करता है.
यह बताने के लिए कि आपका ऐप्लिकेशन Android Automotive OS के साथ काम करता है, मेनिफ़ेस्ट में यह एंट्री इस्तेमाल करें:
<application>
...
<meta-data android:name="com.android.automotive"
android:resource="@xml/automotive_app_desc"/>
...
</application>
मेनिफ़ेस्ट की यह एंट्री, एक ऐसी एक्सएमएल फ़ाइल के बारे में बताती है जिसमें उन ऑटोमोटिव सुविधाओं के बारे में जानकारी होती है जो आपके ऐप्लिकेशन के साथ काम करती हैं.
यह बताने के लिए कि आपके पास कोई मीडिया ऐप्लिकेशन है, अपने प्रोजेक्ट की res/xml/ डायरेक्ट्री में automotive_app_desc.xml नाम की एक एक्सएमएल फ़ाइल जोड़ें. इस फ़ाइल में यह कॉन्टेंट शामिल करें:
<automotiveApp>
<uses name="media"/>
</automotiveApp>
इंटेंट फ़िल्टर
Android Automotive OS, आपके मीडिया ऐप्लिकेशन में गतिविधियों को ट्रिगर करने के लिए, साफ़ तौर पर इंटेंट का इस्तेमाल करता है. मेनिफ़ेस्ट फ़ाइल में, ऐसी कोई भी गतिविधि शामिल न करें जिसमें CATEGORY_LAUNCHER या ACTION_MAIN इंटेंट फ़िल्टर हों.
नीचे दिए गए उदाहरण में बताई गई गतिविधि, आम तौर पर किसी फ़ोन या किसी अन्य मोबाइल डिवाइस को टारगेट करती है. इन गतिविधियों के बारे में उस मॉड्यूल में बताएं जो फ़ोन ऐप्लिकेशन बनाता है, न कि उस मॉड्यूल में जो Android Automotive OS ऐप्लिकेशन बनाता है.
<activity android:name=".MyActivity">
<intent-filter>
<!-- You can't use either of these intents for Android Automotive OS -->
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
<!--
In their place, you can include other intent filters for any activities
that your app needs for Android Automotive OS, such as settings or
sign-in activities.
-->
</intent-filter>
</activity>
आगे के चरण
अब आपके पास Android Auto और Android Automotive OS के लिए एक ऐप्लिकेशन है. इसलिए, हो सकता है कि आपको अपने ऐप्लिकेशन को ऑप्टिमाइज़ करने के लिए कुछ और कदम उठाने पड़ें, ताकि गाड़ी चलाते समय इसका इस्तेमाल ज़्यादा सुरक्षित तरीके से किया जा सके. उपयोगकर्ता को सुरक्षित और आसान अनुभव देने के लिए, ज़्यादा सुझाव पाने के लिए, बोलकर फ़ोन का इस्तेमाल, ध्यान भटकने से रोकने के लिए सुरक्षा के उपाय, और गड़बड़ी ठीक करना के लिए तकनीकी गाइड देखें.
Android Automotive OS के लिए, वीडियो चलाने वाले ऐप्लिकेशन बनाना
कार में इस्तेमाल होने वाले वीडियो ऐप्लिकेशन, मीडिया ऐप्लिकेशन से अलग होते हैं. इसलिए, आपको वीडियो ऐप्लिकेशन के लिए कुछ खास ज़रूरी शर्तों के बारे में पता होना चाहिए. इनके बारे में कार में पार्क होने पर इस्तेमाल होने वाले ऐप्लिकेशन बनाना और Android Automotive OS के लिए वीडियो ऐप्लिकेशन बनाना में बताया गया है. ऐसा करने के लिए, यह तरीका अपनाएं:
अपने ऐप्लिकेशन को वीडियो ऐप्लिकेशन के तौर पर मार्क करना
यह बताने के लिए कि आपका ऐप्लिकेशन वीडियो फ़ॉर्मैट के साथ काम करता है, अपने मेनिफ़ेस्ट के <application> एलिमेंट में android:appCategory="video" एट्रिब्यूट जोड़ें.
<manifest ...>
...
<application
...
android:appCategory="video">
...
</application>
</manifest>
Android Automotive OS के हार्डवेयर की सुविधा के बारे में एलान करना
यह एलान करने के लिए कि आपका ऐप्लिकेशन Android Automotive OS वाले डिवाइसों पर काम करता है, अपने मेनिफ़ेस्ट में android.hardware.type.automotive <uses-feature> एलिमेंट जोड़ें.
android:required एट्रिब्यूट को "false" या "true" पर सेट करना है या नहीं, इस बारे में जानने के लिए, AAOS हार्डवेयर की सुविधा के बारे में बताएं देखें.
<manifest ...>
...
<uses-feature android:name="android.hardware.type.automotive" ...>
...
</manifest>