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 अंतराल)
• स्थिर लंबे समय तक चलने वाला वीडियो (वर्तमान में ~7 सेकंड के बाद डिस्कनेक्ट होता है)
• हेड यूनिट की सेवा खोज से रिज़ॉल्यूशन वार्ता
• कनेक्शन गुणवत्ता के आधार पर अनुकूली बिटरेट

टच इनपुट

• इनपुट चैनल खोलना और बाइंडिंग अनुरोध
• टच इवेंट पार्सिंग (एकल और मल्टी-टच)
• कुंजी इवेंट पार्सिंग (बटन, मीडिया कुंजियाँ)
• निर्देशांक मैपिंग (हेड यूनिट → फ़ोन रिज़ॉल्यूशन)
• 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 = ऑडियो, वीडियो नहीं)। हल: `av_channel` के अंदर `stream_type` फ़ील्ड को पार्स करके `VIDEO(3)` को `AUDIO(1)` से अलग करें।
- **वीडियो स्थिरता** — हेड यूनिट के USB बफ़र ओवरफ्लो के कारण लंबे समय तक स्ट्रीमिंग के बाद कनेक्शन टूट जाता है। नीचे परीक्षण परिणाम देखें।
- **हेड यूनिट पर डुप्लीकेट डिवाइस सूची** — हेड यूनिट का स्मार्टफ़ोन पृष्ठ हमारे ऐप को दो अलग-अलग प्रविष्टियों (एक 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-फ्रेम अंतराल 1 सेकंड: