ड्राइवर की सुरक्षा और सुविधा को बेहतर बनाने के लिए, अपने मीडिया ऐप्लिकेशन में आवाज़ से कंट्रोल करने की सुविधा को इंटिग्रेट करें. इससे ड्राइवर का ध्यान कम भटकेगा. जब Android Auto या Android Automotive OS (AAOS) को आवाज़ से किए गए किसी काम का पता चलता है और वह उसे समझ लेता है, तो वे onPlayFromSearch कॉलबैक के ज़रिए, उस काम को आपके ऐप्लिकेशन तक पहुंचाते हैं.
कॉलबैक मिलने पर, आपका ऐप्लिकेशन क्वेरी स्ट्रिंग से मेल खाने वाला कॉन्टेंट ढूंढता है. इसके बाद, उसे चलाना शुरू कर देता है. आपके ऐप्लिकेशन में, क्वेरी की अलग-अलग कैटगरी के हिसाब से जवाब देने की सुविधा होनी चाहिए. जैसे, शैली, कलाकार, एल्बम, गाने का नाम, रेडियो स्टेशन या प्लेलिस्ट. इसके अलावा, आपके ऐप्लिकेशन को खाली क्वेरी स्ट्रिंग को हैंडल करना होगा. इससे संगीत के लिए सामान्य अनुरोध का पता चलता है.
अगर आपका ऐप्लिकेशन कोई मीडिया आइटम चला रहा है, तो उपयोगकर्ता "[गाने का टाइटल] चलाओ" कहकर, आपके ऐप्लिकेशन को कोई दूसरा गाना चलाने के लिए कह सकता है. इसके लिए, उसे कार के डिसप्ले को देखने या उसे छूने की ज़रूरत नहीं होगी. उपयोगकर्ता, स्टीयरिंग व्हील पर मौजूद बटन पर क्लिक करके या "Ok Google" बोलकर क्वेरी शुरू कर सकते हैं.
जब Android Auto या AAOS, आवाज़ से की गई किसी कार्रवाई का पता लगाता है और उसे समझता है, तो Android Auto या AAOS, onPlayFromSearch के ज़रिए उस कार्रवाई को ऐप्लिकेशन तक पहुंचाता है. इस कॉलबैक को पाने के बाद, ऐप्लिकेशन query स्ट्रिंग से मेल खाने वाला कॉन्टेंट ढूंढता है. इसके बाद, वह कॉन्टेंट चलाना शुरू कर देता है.
उपयोगकर्ता अपनी क्वेरी में अलग-अलग कैटगरी के शब्दों का इस्तेमाल कर सकते हैं. जैसे, शैली, कलाकार, एल्बम, गाने का नाम, रेडियो स्टेशन या प्लेलिस्ट वगैरह. खोज की सुविधा के लिए सहायता उपलब्ध कराते समय, उन सभी कैटगरी को ध्यान में रखें जो आपके ऐप्लिकेशन के लिए काम की हैं. अगर Android Auto या AAOS को पता चलता है कि कोई क्वेरी किसी खास कैटगरी में फ़िट होती है, तो extras पैरामीटर में अतिरिक्त जानकारी जोड़ दी जाती है. ये एक्स्ट्रा आइटम भेजे जा सकते हैं:
खाली query स्ट्रिंग के लिए खाता. अगर उपयोगकर्ता खोज के लिए शब्द नहीं डालता है, तो इसे Android Auto या AAOS से भेजा जा सकता है उदाहरण के लिए, अगर उपयोगकर्ता कहता है कि
"संगीत चलाओ." ऐसे में, आपका ऐप्लिकेशन हाल ही में सुना गया या कोई नया ट्रैक चला सकता है.
अगर आपका ऐप्लिकेशन खोज के नतीजे तुरंत नहीं दिखा सकता, तो onPlayFromSearch में ब्लॉक न करें.
इसके बजाय, प्लेबैक की स्थिति को STATE_CONNECTING पर सेट करें और एसिंक थ्रेड पर खोज करें.
प्लेबैक शुरू होने पर, मीडिया सेशन की कतार में मिलता-जुलता कॉन्टेंट जोड़ें. उदाहरण के लिए, अगर उपयोगकर्ता किसी एल्बम को चलाने का अनुरोध करता है, तो आपका ऐप्लिकेशन उस एल्बम के ट्रैक की सूची को कतार में जोड़ सकता है.
"चलाओ" क्वेरी के अलावा, Android Auto और AAOS, आवाज़ से की गई क्वेरी को भी पहचानते हैं. जैसे, "संगीत रोको" और "अगला गाना". ये क्वेरी, मीडिया सेशन के सही कॉलबैक से मैच होती हैं. जैसे, onPause और onSkipToNext.
आवाज़ से कंट्रोल की जा सकने वाली मीडिया चलाने की सुविधाओं को लागू करने के बारे में ज़्यादा जानने के लिए, Google Assistant और मीडिया ऐप्लिकेशन देखें.