ADB / Android Debug Bridge
Macro Deck के साथ शामिलUSB या Wi-Fi से किसी Android फ़ोन या टैबलेट को नियंत्रित करें: उसे जगाएँ, ऐप शुरू करें, टैप करें, टाइप करें और स्क्रीनशॉट लें।
ADB / Android Debug Bridge इंटीग्रेशन का अवलोकन टैब, सेटिंग्स में ADB चालू करने की सूचना के साथ
- जुड़े हुए Android डिवाइस को जगाएँ, लॉक करें और रीबूट करें
- डिवाइस पर ऐप शुरू करें या ज़बरदस्ती बंद करें और लिंक खोलें
- की, टैप, स्वाइप और टेक्स्ट भेजें
- डिवाइस की स्क्रीन के स्क्रीनशॉट किसी फ़ोल्डर में सेव करें
- बैटरी, स्क्रीन और फ़ोरग्राउंड ऐप के लिए डिवाइस इवेंट और वेरिएबल
ADB इंटीग्रेशन Android Debug Bridge (ADB) के ज़रिए Android फ़ोन और टैबलेट नियंत्रित करता है, वही टूल जिसे Android डेवलपर इस्तेमाल करते हैं। Macro Deck adb प्रोग्राम ढूँढता है, ADB सर्वर चलाता है और USB से जुड़े या Wi-Fi पर कनेक्ट किए गए डिवाइसों पर नज़र रखता है। यह आपके लिए आधिकारिक Android platform-tools डाउनलोड भी कर सकता है।
हर क्रिया उस डिवाइस पर काम करती है जिसे आप क्रिया में चुनते हैं, या डिवाइस खाली छोड़ने पर डिफ़ॉल्ट डिवाइस पर। डिफ़ॉल्ट डिवाइस वह है जिसे आपने सेटिंग्स > ADB में डिफ़ॉल्ट के रूप में सेट करें से चुना है, या कोई न चुनने पर इकलौता जुड़ा हुआ डिवाइस।
आप क्या कर सकते हैं
- स्क्रीन और पावर: डिवाइस जगाएँ, स्क्रीन बंद करें (Android इसी तरह डिवाइस लॉक करता है) या उसे Android, recovery या bootloader में रीबूट करें।
- ऐप और लिंक: किसी ऐप को उसके पैकेज नाम से, जैसे
com.spotify.music, शुरू करें या ज़बरदस्ती बंद करें, और कोई लिंक उस ऐप से खोलें जिसे डिवाइस उसके लिए चुनता है। - इनपुट: Home, Back, Volume Up या Media Play Pause जैसी कोई की भेजें, स्क्रीन पर किसी बिंदु पर टैप करें, एक बिंदु से दूसरे तक स्वाइप करें, या फ़ोकस वाले फ़ील्ड में टेक्स्ट टाइप करें।
- स्क्रीनशॉट: स्क्रीन को अपने कंप्यूटर के किसी फ़ोल्डर में PNG फ़ाइल के रूप में कैप्चर करें, और चाहें तो फ़ाइल का पाथ किसी वेरिएबल में लिखें।
कुछ उदाहरण सेटअप:
- एक बटन, जो आपकी डेस्क पर रखे टैबलेट को जगाता है और आपका म्यूज़िक ऐप शुरू करता है।
- एक बटन, जो आपके फ़ोन को Media Play Pause भेजता है।
- डिवाइस कनेक्ट हुआ पर एक ऑटोमेशन, जो टैबलेट प्लग इन करते ही उस पर एक डैशबोर्ड पेज खोलता है।
लाइव स्थिति
इंटीग्रेशन बताता है कि कब कोई डिवाइस कनेक्ट, डिस्कनेक्ट या अधिकृत होता है, अनधिकृत हो जाता है, ऑफ़लाइन जाता है या फिर से ऑनलाइन आता है, ताकि फ़्लो और बटन उस पर प्रतिक्रिया दे सकें। वेरिएबल कनेक्टेड और अधिकृत डिवाइसों की संख्या रखते हैं, और डिफ़ॉल्ट डिवाइस के लिए उसका मॉडल, निर्माता, बैटरी स्तर, स्क्रीन चालू है या नहीं, लॉक स्क्रीन दिख रही है या नहीं और सामने कौन सा ऐप है। हर अधिकृत डिवाइस को उसके मॉडल के नाम वाले अपने वेरिएबल भी मिलते हैं। इंटीग्रेशन चालू रहने पर हर Android डिवाइस की बैटरी बैटरी विजेट में भी दिखती है।
बुनियादी क्रियाएँ (की, टैप, स्वाइप, टेक्स्ट, ऐप, लिंक, रीबूट और स्क्रीनशॉट) Macro Deck लॉक होने पर भी काम करती रहती हैं, इसलिए इनमें से किसी से जुड़ा बटन लॉक कंप्यूटर पर भी काम करता है।
आपको क्या चाहिए
- Windows, macOS या Linux पर Macro Deck 3
- एक Android डिवाइस, जिसके Developer options में USB debugging चालू हो
- डेटा ले जाने वाली USB केबल, या Wi-Fi पर कनेक्शन के लिए wireless debugging
- Android platform-tools (adb); Macro Deck इन्हें सेटिंग्स > ADB में डाउनलोड कर सकता है
- Linux पर, आपके यूज़र को USB डिवाइस तक पहुँचने की अनुमति, आम तौर पर एक udev नियम से
सेट अप करें
चरण 1: ADB इंटीग्रेशन चालू करें
साइडबार में एकीकरण पर क्लिक करें और फिर ADB / Android Debug Bridge पर। जब तक आप ऊपर दाईं ओर का स्विच चालू नहीं करते, इंटीग्रेशन बंद रहता है। चालू होने के बाद पेज पर ADB बंद है दिखता है, जब तक आप अगले चरण में ADB चालू नहीं करते।
चरण 2: Macro Deck में ADB चालू करें
सेटिंग्स > ADB खोलें और ADB चालू करें चालू करें। अगर ADB प्रोग्राम नहीं मिला दिखाता है, तो platform-tools डाउनलोड करें पर क्लिक करें। पहले से मौजूद Android SDK या आपके
PATHपर मौजूदadbअपने आप मिल जाता है, और एक्ज़ीक्यूटेबल पाथ से आप किसी दूसरे की ओर इशारा कर सकते हैं।चरण 3: डिवाइस पर USB debugging चालू करें
फ़ोन या टैबलेट पर Settings > About phone खोलें और Developer options चालू करने के लिए Build number पर सात बार टैप करें। फिर Settings > Developer options में USB debugging चालू करें। सही जगह अलग-अलग निर्माताओं में थोड़ी अलग होती है।
चरण 4: डिवाइस कनेक्ट और अधिकृत करें
डिवाइस को USB केबल से जोड़ें और उसकी स्क्रीन पर Allow USB debugging? की पुष्टि करें। Always allow from this computer पर टिक करें, ताकि वह दोबारा न पूछे। इसके बाद डिवाइस सेटिंग्स > ADB में डिवाइस के नीचे तैयार के रूप में दिखता है। इसके बजाय Wi-Fi पर जोड़ने के लिए, Wi-Fi पर कनेक्ट करें के नीचे डिवाइस का IP पता और पोर्ट डालें, जैसे
192.168.1.20:5555।चरण 5: डिफ़ॉल्ट डिवाइस चुनें
एक से ज़्यादा डिवाइस जुड़े हों, तो उस डिवाइस के पास डिफ़ॉल्ट के रूप में सेट करें पर क्लिक करें जिसे आपकी क्रियाएँ डिवाइस खाली छोड़ने पर इस्तेमाल करें। एक ही डिवाइस हो, तो वह अपने आप इस्तेमाल होता है।
चरण 6: किसी बटन पर ADB क्रिया जोड़ें
डेक पेज पर पक्का करें कि डेक अनलॉक है (ऊपर दाईं ओर के बटन पर लॉक करें लिखा है) और किसी बटन पर क्लिक करें। एडिटर खुलता है और उसमें छोटा दबाव चुना हुआ होता है। + क्रिया जोड़ें पर क्लिक करें, क्रिया जोड़ें डायलॉग में बाईं ओर ADB / Android Debug Bridge चुनें और कोई क्रिया चुनें, जैसे डिवाइस जगाएं या ऐप शुरू करें। उसके फ़ील्ड भरें, जैसे ऐप शुरू करें के लिए पैकेज, और डिफ़ॉल्ट डिवाइस इस्तेमाल करने के लिए डिवाइस खाली छोड़ें। यह श्रेणी केवल तभी दिखती है जब इंटीग्रेशन चालू हो।
चरण 7: बटन दबाएँ
सहेजें पर क्लिक करें और अपने डेक पर बटन दबाएँ। अगर कुछ नहीं होता, तो एकीकरण में कोई सूचना देखें, जैसे कोई डिवाइस कनेक्ट नहीं है या कोई डिवाइस जिसे अधिकृति चाहिए।
क्रियाएँ11
इन्हें किसी बटन पर रखें या किसी फ़्लो से चलाएँ।
- डिवाइस जगाएं
- डिवाइस की स्क्रीन जगाता है।
- स्लीप / स्क्रीन लॉक
- डिवाइस की स्क्रीन बंद करता है, जिस तरह Android डिवाइस लॉक करता है।
- ऐप शुरू करें
- किसी ऐप को उसके पैकेज नाम से शुरू करता है, या उसे सामने लाता है।
- ऐप को ज़बरदस्ती बंद करें
- किसी ऐप को उसके पैकेज नाम से ज़बरदस्ती बंद करता है।
- लिंक खोलें
- डिवाइस पर कोई URI खोलता है, ठीक वैसे ही जैसे किसी लिंक पर टैप करना।
- टेक्स्ट टाइप करें
- डिवाइस पर अभी फ़ोकस वाले फ़ील्ड में टेक्स्ट टाइप करता है।
- की भेजें
- एक Android की इवेंट भेजता है, जैसे Home, Back, Volume Up या Media Next।
- टैप
- दिए गए X और Y निर्देशांकों पर स्क्रीन पर टैप करता है।
- स्वाइप
- तय अवधि में स्क्रीन पर एक बिंदु से दूसरे तक स्वाइप करता है।
- डिवाइस रीबूट करें
- डिवाइस को Normal, Recovery या Bootloader मोड में रीबूट करता है।
- स्क्रीनशॉट लें
- डिवाइस की स्क्रीन कैप्चर करता है और उसे किसी फ़ोल्डर में PNG फ़ाइल के रूप में सेव करता है, और चाहें तो उसका पाथ किसी वेरिएबल में लिखता है।
ट्रिगर6
कोई बटन या फ़्लो इन इवेंट पर प्रतिक्रिया दे सकता है।
- डिवाइस कनेक्ट हुआ
- कोई Android डिवाइस प्लग इन हुआ, या Macro Deck ने उसे पहली बार देखा।
- डिवाइस डिस्कनेक्ट हुआ
- कोई Android डिवाइस अनप्लग हुआ, या Macro Deck उसकी जानकारी खो बैठा।
- डिवाइस अधिकृत
- डिवाइस पर अधिकृति का संकेत स्वीकार किया गया।
- डिवाइस की अधिकृति हट गई
- पहले से अधिकृत किसी डिवाइस पर अधिकृति का संकेत फिर से स्वीकार करना होगा।
- डिवाइस ऑनलाइन हो गया
- कोई अधिकृत डिवाइस फिर से पहुँच में आ गया।
- डिवाइस ऑफ़लाइन हो गया
- जो डिवाइस पहुँच में था, उस तक अब पहुँचा नहीं जा सकता।
वेरिएबल11
इन मानों को बटनों और विजेट पर दिखाएँ, या शर्तों में इस्तेमाल करें।
adb_connected_device_count- जुड़े हुए Android डिवाइसों की संख्या।
adb_authorized_device_count- ऑनलाइन और अधिकृत डिवाइसों की संख्या।
adb_device_connected- डिफ़ॉल्ट डिवाइस कनेक्ट है या नहीं।
adb_device_authorized- डिफ़ॉल्ट डिवाइस ने इस कंप्यूटर को अधिकृत किया है या नहीं।
adb_device_model- डिफ़ॉल्ट डिवाइस का मॉडल।
adb_device_manufacturer- डिफ़ॉल्ट डिवाइस का निर्माता।
adb_device_battery_level- डिफ़ॉल्ट डिवाइस का बैटरी स्तर प्रतिशत में।
adb_device_screen_on- डिफ़ॉल्ट डिवाइस की स्क्रीन चालू है या नहीं।
adb_device_locked- डिफ़ॉल्ट डिवाइस अपनी लॉक स्क्रीन दिखा रहा है या नहीं।
adb_device_foreground_app- डिफ़ॉल्ट डिवाइस पर सामने वाले ऐप का पैकेज नाम।
adb_device_<device>_connected,adb_device_<device>_authorized,adb_device_<device>_model,adb_device_<device>_battery_level- हर अधिकृत डिवाइस के लिए: कनेक्ट है या नहीं, अधिकृत है या नहीं, मॉडल और बैटरी स्तर।
<device>डिवाइस का मॉडल है, छोटे अक्षरों, अंकों और अंडरस्कोर में, और एक ही मॉडल के और डिवाइसों के लिए उसमें_2,_3आदि जोड़े जाते हैं।
अक्सर पूछे जाने वाले प्रश्न
क्या मुझे Android Studio या Android SDK चाहिए?
नहीं। Macro Deck को Android platform-tools से केवल adb प्रोग्राम चाहिए। सेटिंग्स > ADB में platform-tools डाउनलोड करें पर क्लिक करें, और Macro Deck अपने इस्तेमाल के लिए Google से आधिकारिक पैकेज डाउनलोड करता है, लगभग 15 MB। पहले से मौजूद इंस्टॉलेशन अपने आप मिल जाता है।
क्या मैं Wi-Fi पर कोई डिवाइस नियंत्रित कर सकता हूँ?
हाँ। डिवाइस पर wireless debugging चालू करें और सेटिंग्स > ADB में Wi-Fi पर कनेक्ट करें के नीचे उसका IP पता और पोर्ट डालें। Macro Deck खुद डिवाइस पेयर नहीं करता: Android 11 और उसके बाद के वर्ज़न पर पहले डिवाइस को इस कंप्यूटर के साथ पेयर करें, या adb tcpip से उसे USB के ज़रिए नेटवर्क डीबगिंग पर स्विच करें। नहीं तो डिवाइस कनेक्शन अस्वीकार कर देता है।
कोई क्रिया डिवाइस न मिलने के कारण क्यों विफल होती है?
जब आप डिवाइस खाली छोड़ते हैं, तो क्रिया डिफ़ॉल्ट डिवाइस इस्तेमाल करती है। अगर आपने कोई नहीं चुना और एक से ज़्यादा डिवाइस जुड़े हैं, तो कोई डिफ़ॉल्ट नहीं होता, इसलिए क्रिया में कोई डिवाइस चुनें या सेटिंग्स > ADB में डिफ़ॉल्ट के रूप में सेट करें पर क्लिक करें। यह भी जाँच लें कि डिवाइस तैयार दिखा रहा है, न कि अधिकृत नहीं।
क्या लॉक करने की कोई अलग क्रिया है?
नहीं। Android में लॉक करने का कोई अलग कमांड नहीं है। स्लीप / स्क्रीन लॉक स्क्रीन बंद करता है, जिससे डिवाइस उसी तरह लॉक होता है जैसे पावर बटन से।
क्या ADB इंटीग्रेशन ADB इस्तेमाल करने वाले दूसरे प्रोग्राम पर असर डालता है?
Macro Deck सामान्य ADB सर्वर इस्तेमाल करता है, इसलिए Android Studio जैसे प्रोग्राम भी उसे साझा करते हैं। सेटिंग्स > ADB में ADB सर्वर पुनः आरंभ करें उनके डिवाइसों को भी थोड़ी देर के लिए डिस्कनेक्ट कर देता है। Macro Deck बंद होने पर सर्वर चलता रहता है, जब तक आप Macro Deck बंद होने पर ADB सर्वर रोकें चालू नहीं करते।
डिवाइस "इस डिवाइस तक पहुँच की अनुमति नहीं" क्यों दिखाता है?
कंप्यूटर के पास USB पर डिवाइस से बात करने की अनुमति नहीं है। Linux पर platform-tools के udev नियम इंस्टॉल करें; Windows पर डिवाइस के लिए निर्माता का USB ड्राइवर इंस्टॉल करें।
आपका कंप्यूटर में और
सिस्टम
Macro Deck के साथ शामिलअपने डेक से अपना कंप्यूटर नियंत्रित करें: ऐप, वॉल्यूम, कमांड, सूचनाएँ, स्लीप और शटडाउन।
कीबोर्ड
Macro Deck के साथ शामिलएक बटन से अपने कंप्यूटर पर शॉर्टकट दबाएँ, टेक्स्ट टाइप करें और कुंजी अनुक्रम चलाएँ।
माउस
Macro Deck के साथ शामिलएक बटन से अपने कंप्यूटर पर क्लिक करें, पॉइंटर हिलाएँ, खींचें और स्क्रॉल करें।
Steam
Macro Deck के साथ शामिलSteam गेम शुरू और बंद करें, और अपने डेक पर दिखाएँ कि आप क्या खेल रहे हैं, अपने दोस्त और अपनी लाइब्रेरी।