Open Android Auto

Android Auto फ़ोन-साइड ऐप का एक ओपन-सोर्स कार्यान्वयन। यह ऐप आपके फ़ोन पर चलता है और USB के माध्यम से कार के हेड यूनिट पर प्रोजेक्ट करता है, जो Google के स्वामित्व वाले com.google.android.projection.gearhead APK का स्थान लेता है।

⚠️ कार्य प्रगति पर है

यह प्रोजेक्ट प्रारंभिक विकास चरण में है। प्रोटोकॉल हैंडशेक और वीडियो प्रोजेक्शन एक वास्तविक हेड यूनिट के साथ काम कर रहे हैं। फ़ोन स्क्रीन सफलतापूर्वक कार के हेड यूनिट पर कुछ सेकंड के लिए प्रदर्शित होती है, फिर डिस्कनेक्ट हो जाती है (वीडियो स्थिरता में सुधार किया जा रहा है)।

विशेषताएँ

प्रोटोकॉल और कनेक्शन

• USB AOA एक्सेसरी मोड का पता लगाना और कनेक्शन
• TLS 1.2 म्यूचुअल ऑथेंटिकेशन (फ़ोन सर्वर के रूप में)
• संस्करण वार्ता (प्रोटोकॉल v1.7)
• सेवा खोज (अनुरोध/प्रतिक्रिया)
• लक्ष्य चैनलों पर चैनल खोलना (वीडियो, ऑडियो, इनपुट, सेंसर)
• पिंग/पोंग कीपअलाइव (द्विदिशात्मक)
• ऑडियो फ़ोकस अनुरोध/प्रतिक्रिया प्रबंधन
• नेविगेशन फ़ोकस अनुरोध/प्रतिक्रिया प्रबंधन
• वॉइस सेशन अनुरोध प्रबंधन
• सुगम शटडाउन प्रबंधन
• प्राथमिकता राइट क्यू (वीडियो पर नियंत्रण संदेश)
• ऑडियो भेजने से पहले ऑडियो फ़ोकस अनुदान की प्रतीक्षा करें (प्रति HUIG 500ms टाइमआउट)
• ब्लूटूथ पेयरिंग एक्सचेंज (BluetoothPairingRequest/Response)
• AOAP पुनः-प्रारंभ के बिना कई USB पुनःकनेक्शन संभालें

वीडियो प्रोजेक्शन

• MediaCodec के माध्यम से H.264 एन्कोडिंग (800x480 @ 30fps, Baseline प्रोफ़ाइल)
• MediaProjection स्क्रीन कैप्चर (उपयोगकर्ता अनुमति संवाद के साथ)
• वीडियो चैनल सेटअप (SETUP → CONFIG → FOCUS → START प्रवाह)
• माइक्रोसेकंड में शून्य-आधारित टाइमस्टैम्प
• कीफ़्रेम में SPS/PPS जोड़ना (Annex B प्रारूप)
• प्रवाह नियंत्रण (max_unacked ट्रैकिंग, बैकप्रेशर)
• फ़्रेम पेसिंग (सुसंगत 33ms अंतराल)
• स्थिर दीर्घकालिक वीडियो (30+ मिनट की पुष्टि)
• हेड यूनिट की सेवा खोज से रिज़ॉल्यूशन वार्ता
• कनेक्शन गुणवत्ता के आधार पर अनुकूली बिटरेट

टच इनपुट

• इनपुट चैनल खोलना और बाइंडिंग अनुरोध
• टच इवेंट पार्सिंग (सिंगल और मल्टी-टच)
• की इवेंट पार्सिंग (बटन, मीडिया कुंजियाँ)
• निर्देशांक मैपिंग (हेड यूनिट → फ़ोन रिज़ॉल्यूशन)
• MotionEvent निर्माण के साथ TouchInjector
• VirtualDisplay में टच इवेंट इंजेक्ट करें
• Android सिस्टम में की इवेंट इंजेक्शन

ऑडियो

• ऑडियो चैनल खोलना और सेटअप
• ऑडियो भेजने से पहले ऑडियो फ़ोकस अनुदान की प्रतीक्षा करें (प्रति HUIG 500ms टाइमआउट)
• प्रारंभिक कनेक्ट पर AUDIO_FOCUS RELEASE भेजें, फिर चलाते समय GAIN भेजें
• फ़ोन ऑडियो कैप्चर (MediaProjection AudioPlaybackCapture)
• हेड यूनिट पर PCM/AAC एन्कोडिंग और स्ट्रीमिंग
• हेड यूनिट से माइक्रोफ़ोन इनपुट (वॉइस कमांड)
• कई ऑडियो चैनल (मीडिया, सिस्टम, स्पीच, गाइडेंस)
• चैनल सक्रिय रखने के लिए ऑडियो साइलेंस स्ट्रीमिंग

सेंसर

• सेंसर चैनल खोलना
• सेंसर प्रारंभ अनुरोध/प्रतिक्रिया प्रबंधन
• नाइट मोड डेटा पार्सिंग और भेजना
• ड्राइविंग स्थिति डेटा पार्सिंग और भेजना
• GPS स्थान अग्रेषण
• कम्पास हेडिंग
• कार की गति
• RPM
• ओडोमीटर (कुल + ट्रिप माइलेज)
• ईंधन स्तर और रेंज
• पार्किंग ब्रेक स्थिति
• गियर स्थिति (P/R/N/D/1-10)
• OBD-II डायग्नोस्टिक्स
• पर्यावरण (तापमान, दबाव, वर्षा)
• HVAC (लक्ष्य/वर्तमान तापमान)
• डेड रेकनिंग
• यात्री की उपस्थिति
• दरवाज़े की स्थिति (हुड, बूट, अलग-अलग दरवाज़े)
• लाइट स्थिति (हेडलाइट, संकेतक, हैज़र्ड)
• टायर दबाव
• एक्सेलेरोमीटर (3-अक्ष)
• जायरोस्कोप (3-अक्ष)
• GPS उपग्रह डेटा
• हेड यूनिट सेंसर अनुरोधों का सक्रिय रूप से उत्तर दें

वीडियो (अतिरिक्त)

• हेड यूनिट की सेवा खोज से रिज़ॉल्यूशन वार्ता
• कनेक्शन गुणवत्ता के आधार पर अनुकूली बिटरेट
• 720p, 1080p, 1440p, 4K रिज़ॉल्यूशन के लिए समर्थन
• पोर्ट्रेट मोड रिज़ॉल्यूशन (720x1280, 1080x1920, आदि)
• UI कॉन्फ़िग अपडेट (थीम, इनसेट)

अन्य

• ब्लूटूथ पेयरिंग समन्वय (A2DP, HFP)
• इंस्ट्रूमेंट क्लस्टर तक नेविगेशन टर्न-बाय-टर्न
• नेविगेशन स्थिति (मैन्यूवर, लेन, दूरियाँ, वर्तमान स्थिति)
• मीडिया स्थिति (अभी चल रही जानकारी)
• मीडिया प्लेबैक मेटाडेटा (ट्रैक, कलाकार, एल्बम)
• मीडिया ब्राउज़र (हेड यूनिट से फ़ोन की मीडिया लाइब्रेरी ब्राउज़ करें)
• फ़ोन स्थिति (कॉल स्थिति सूचनाएँ)
• सामान्य सूचनाएँ (सब्सक्राइब/अनसब्सक्राइब सिस्टम)
• विक्रेता एक्सटेंशन
• वायरलेस Android Auto (WiFi + ब्लूटूथ हैंडऑफ़)
• चैनल बंद होने की सूचना
• कार कनेक्टेड डिवाइसेस अनुरोध/प्रतिक्रिया
• उपयोगकर्ता स्विच अनुरोध/प्रतिक्रिया
• बैटरी स्थिति सूचना
• कॉल उपलब्धता स्थिति
• सेवा डिस्कवरी अपडेट (गतिशील चैनल परिवर्तन)
• इनपुट फ़ीडबैक (हेड यूनिट को हैप्टिक/विज़ुअल फ़ीडबैक)
• माइक्रोफ़ोन अनुरोध/प्रतिक्रिया (हेड यूनिट से वॉइस इनपुट)
• ऑडियो अंडरफ़्लो सूचना
• रेडियो सेवा (AM/FM/HD/DAB ट्यूनिंग, प्रीसेट, RDS)

⚠️ अस्वीकरण

अपने जोखिम पर उपयोग करें। यह सॉफ़्टवेयर "जैसा है" प्रदान किया गया है, बिना किसी प्रकार की वारंटी के।

• यह सॉफ़्टवेयर आपकी कार की हेड यूनिट के साथ अप्रत्याशित व्यवहार कर सकता है
• यह सॉफ़्टवेयर आपके फ़ोन या हेड यूनिट को नुकसान पहुँचा सकता है — लेखक कोई दायित्व स्वीकार नहीं करते
• गाड़ी चलाते समय इस एप्लिकेशन का उपयोग न करें
• वाहन चलाते समय इस एप्लिकेशन के साथ इंटरैक्ट न करें
• यह एप्लिकेशन केवल विकास और परीक्षण उद्देश्यों के लिए है
• किसी भी फ़ोन एप्लिकेशन के साथ इंटरैक्ट करने से पहले हमेशा अपना वाहन किनारे रोकें
• इस सॉफ़्टवेयर के उपयोग से होने वाली किसी भी दुर्घटना, चोट या क्षति के लिए लेखक ज़िम्मेदार नहीं हैं

आर्किटेक्चर

USB Plug-in → MainActivity → ProjectionService
                                    ↓
                    UsbAoaTransport (USB AOA accessory mode)
                                    ↓
                    MessageFramer (16KB frame fragmentation)
                                    ↓
                    InBandTls (TLSv1.2 via SSLEngine)
                                    ↓
                    ProtocolEngine (AAP state machine)
                                    ↓
                    ┌───────────┼───────────┐
                 Video      Input       Audio
                (H.264)   (touch/keys)  (PCM)

ज्ञात बग्स

• चैनल असाइनमेंट क्रम मान लेता है — हम SERVICE_DISCOVERY_RESPONSE में पहले av_channel को वीडियो और दूसरे को ऑडियो के रूप में असाइन करते हैं। यह कार हेड यूनिट के साथ काम करता है (चैनल 1 = वीडियो) लेकिन openauto के साथ विफल हो जाता है (चैनल 4 = ऑडियो, वीडियो नहीं)। समाधान: VIDEO(3) को AUDIO(1) से अलग करने के लिए av_channel के अंदर stream_type फ़ील्ड को पार्स करें।
• वीडियो स्थिरता — खुला। AUTH_COMPLETE फिक्स (2026-05-30) ने निष्क्रिय डिस्कनेक्ट को हल किया, लेकिन वीडियो स्ट्रीमिंग अभी भी HU को सभी संचार अचानक बंद करने और फिर एक परिवर्तनीय 9-240s के बाद भौतिक रूप से USB पावर (VBUS) गिराने का कारण बनती है। डिस्कनेक्ट असंगत है (5 KB/s विफल होता है, 170 KB/s अधिक समय तक चलता है), इसलिए यह बैंडविड्थ या फ़्लो कंट्रोल नहीं है। पूर्ण साक्ष्य, बहिष्कृत कारण और खुली परिकल्पनाएँ docs/connection-stability.md में (पूर्व में bugfix.md)।
• हेड यूनिट पर डुप्लिकेट डिवाइस लिस्टिंग — हेड यूनिट का स्मार्टफ़ोन पेज हमारे ऐप को दो अलग-अलग प्रविष्टियों के रूप में दिखाता है (एक Android Auto के लिए, एक Bluetooth के लिए) बजाय दोनों क्षमताओं वाली एकल प्रविष्टि के। यह Android 12+ द्वारा वास्तविक Bluetooth MAC पते तक पहुँच को अवरुद्ध करने के कारण होता है (02:00:00:00:00:00 लौटाता है)। वर्कअराउंड: adb shell "echo $(adb shell settings get secure bluetooth_address) > /sdcard/Android/data/org.openandroidauto/files/bt_address.txt" के माध्यम से वास्तविक पता एक कॉन्फ़िग फ़ाइल में लिखें। उपयोगकर्ता को अपना BT MAC मैन्युअल रूप से दर्ज करने देने के लिए एक UI सेटिंग्स स्क्रीन की आवश्यकता है।
• वॉइस असिस्टेंट बटन संभाला नहीं गया — जब ड्राइवर हेड यूनिट पर वॉइस/असिस्टेंट बटन दबाता है, तो हमें VOICE_SESSION_REQUEST प्राप्त होता है और हम वॉइस असिस्टेंट (Dicio या सिस्टम डिफ़ॉल्ट) लॉन्च करने का प्रयास करते हैं। हालाँकि, लॉन्च किया गया असिस्टेंट अभी तक हेड यूनिट के माइक्रोफ़ोन से ऑडियो प्राप्त नहीं करता है।

वीडियो स्थिरता परीक्षण परिणाम

800x480 पर टेस्ट पैटर्न (कलर बार), I-frame अंतराल 1 सेकंड: