Home API की नॉलेज बेस और Gemini की मदद से, Android Home API ऐप्लिकेशन डेवलप करना

1. शुरू करने से पहले

आपको क्या बनाना है

इस कोडलैब में, Home API के नॉलेज बेस और Android Studio में Gemini का इस्तेमाल करके, मौजूदा Android Home API के सैंपल ऐप्लिकेशन को बेहतर बनाने का तरीका बताया गया है. इससे यूआई अपने-आप बन जाएगा और एपीआई इंटिग्रेट हो जाएगा. आपको एक डीबग इंटरफ़ेस जोड़ना होगा. इससे उपयोगकर्ता, डीबग करने और डेवलपमेंट के लिए लॉग डंप कर पाएंगे और अपने होम की खास जानकारी देख पाएंगे.

पावर डुओ: Home API की नॉलेज बेस + Android Studio में Gemini

यह वर्कफ़्लो, दो मुख्य कॉम्पोनेंट पर निर्भर करता है:

  • Home API के बारे में जानकारी देने वाला लेख: यह एक चुनी गई दस्तावेज़ फ़ाइल (google-home-api-knowledge-base.txt) होती है. इसमें Gemini को Google Home डिवाइसों के साथ इंटरैक्ट करने के लिए ज़रूरी तकनीकी पाबंदियों, मॉडल, और तरीकों के बारे में जानकारी मिलती है.
  • यहां देखें: https://developers.home.google.com/apis/android/knowledge-base
  • Android Studio में Gemini: एआई की मदद से काम करने वाला एक सहयोगी, जो सीधे आपके IDE में मौजूद होता है. यह आपके कोड, संसाधनों, और टर्मिनल के बारे में जानकारी रखता है.

आपको क्या सीखने को मिलेगा

  • Android Studio में Gemini को कॉन्टेक्स्ट के तौर पर, Home API के बारे में जानकारी देने वाला लेख कैसे उपलब्ध कराएं.
  • Home API के मौजूदा सैंपल ऐप्लिकेशन में नई सुविधा जोड़ने के लिए, Android Studio में Gemini की मदद से वाइब-कोड कैसे जनरेट करें.

2. ज़रूरी शर्तें और सेटअप

जारी रखने से पहले, पक्का करें कि आपने ये काम पूरे कर लिए हों:

  • Home API का Android सैंपल ऐप्लिकेशन बनाएं और उसे चलाएं: हमारे कोडलैब पर आधारित सैंपल ऐप्लिकेशन बनाने और उसे चलाने के लिए, https://developers.home.google.com/apis/android/sample-app/build#build_the_app पर दिए गए निर्देशों का पालन करें.
  • एनवायरमेंट सेटअप करना
  • Android Studio डाउनलोड करें: डेवलपर की आधिकारिक साइट से, सबसे नया स्टेबल वर्शन (Koala या इसके बाद का वर्शन) इंस्टॉल करें.
  • Gemini चालू करें: Gemini टूल विंडो खोलें. यह आम तौर पर दाईं ओर मौजूद स्ट्रिप पर होती है. एआई असिस्टेंट को चालू करने के लिए, अपने Google खाते से साइन इन करें और शर्तें स्वीकार करें. निर्देशों के लिए, https://developer.android.com/studio/gemini/get-started पर जाएं.
  • नॉलेज बेस फ़ाइल: पक्का करें कि आपने google-home-api-knowledge-base.txt फ़ाइल को अपने प्रोजेक्ट डायरेक्ट्री में सेव किया हो.
  • ध्यान दें: अगर आपने GitHub के आधिकारिक सैंपल ऐप्लिकेशन से सैंपल ऐप्लिकेशन को क्लोन किया है, तो यह फ़ाइल tools/ फ़ोल्डर में पहले से शामिल होती है.

3. AGENTS.md फ़ाइल बनाना

हर चैट में निर्देशों को दोहराने के बजाय, Gemini के लिए एक ऐसा "दिमाग" बनाएँ जो हमेशा काम करे.

अपने प्रोजेक्ट के रूट में, AGENTS.md नाम की एक नई फ़ाइल बनाएं और इसमें यह कॉन्टेक्स्ट चिपकाएं:

**Role:** You are an expert Android Home API Developer.

**Context:** This project uses the Google Home APIs.

**Source of Truth:** Always reference tools/google-home-api-knowledge-base.txt for Home API patterns, data models (Structures, Automations), and debugging methods.

**Guidelines:** Prioritize Material 3 Compose components and ensure all code is compatible with the latest Home API SDK.

"कॉन्टेक्स्ट" में जाकर, AGENTS.md Files के बगल में मौजूद बॉक्स पर सही का निशान लगाएं.

2047b69244c9da6e.png

आइए, पुष्टि करते हैं कि सेटअप पूरा हो गया है या नहीं. Gemini को यह प्रॉम्प्ट दें:

Can you see the Agents.md file? Do you know what file you need to check first before developing with Google Home API?

आपको नीचे दिए गए नतीजों की तरह ही नतीजे दिखेंगे. इसमें बताया गया है कि यह AGENTS.md को पढ़ रहा है और नॉलेज बेस फ़ाइल का इस्तेमाल करेगा!

830ef529169d47b.png

4. नया डीबग टैब बनाना

Gemini + नॉलेज बेस का इस्तेमाल करके, HomeAppView.kt में बदलाव करें और नया नेविगेशन डेस्टिनेशन जोड़ें.

शुरू करने से पहले, आपका मौजूदा Home APIs का सैंपल ऐप्लिकेशन ऐसा दिखना चाहिए:

981f74eb250a2552.png

Gemini को निर्देश दें कि वह नए डीबग टैब को दिखाने के लिए, पहिए के आइकॉन का इस्तेमाल करे.

Can you help to add a wheel icon as the third tab in the HomeAppView .

Android Studio में Gemini के साथ प्रॉम्प्ट और जवाब का संभावित डायलॉग यहां देखें

c9cf695cb6549fa3.png

अब हमें सबसे नीचे एक नया "डीबग करें" टैब दिखता है:

ac1e16cc6bcae224.png

5. "डंप स्ट्रक्चर" और "डंप ऑटोमेशन" के लिए दो नए बटन बनाएं

Gemini को प्रॉम्प्ट दें:

Create two selectable buttons on the Debug page called "Dump Structure" and "Dump Automations".

अब डीबग पेज पर दो नए बटन जोड़ दिए गए हैं

451ad164998d527c.png

6. "डंप स्ट्रक्चर" सुविधा लागू करना

Gemini को प्रॉम्प्ट दें:

Implement the first button "Dump Structure" to call dumpStructure(structure: Structure) in Debugger.kt with current selected structure.

"डंप स्ट्रक्चर" बटन पर क्लिक करने पर, स्ट्रक्चर के लॉग LogCat में डंप हो जाएंगे

af7295a2ad999798.png

7. "डंप ऑटोमेशन" सुविधा लागू करना

Gemini को प्रॉम्प्ट दें:

Now Implement the "Dump Automation" functionality to call dumpAutomationsInStructure(structure: Structure) in Debugger.kt with current selected structure.

"डंप ऑटोमेशन" बटन पर क्लिक करने पर, ऑटोमेशन के लॉग LogCat में डंप हो जाएंगे

d5ea7f17e29d9220.png

8. "घर के बारे में खास जानकारी" बटन लागू करें. इससे मौजूदा कमरों और डिवाइसों की सूची दिखेगी

Gemini को प्रॉम्प्ट दें:

In Debug tab, add a button "Summarize Home" to find the current room and devices with Home API and show them on a dialog.

डीबग पेज पर नया "होम पेज की खास जानकारी" बटन

a4cf16a09f535f8b.png

इस पर क्लिक करने से, आपको कमरों और डिवाइसों की मौजूदा खास जानकारी दिखेगी

cd2dcccc60947445.png

9. बदलावों की समीक्षा करना

Gemini, बदलावों (या आखिरी गिट कमिट) की समीक्षा करने, संभावित समस्याओं का पता लगाने, और उन्हें ठीक करने में भी मदद कर सकता है.

Gemini को प्रॉम्प्ट दें:

Review the uncommitted changes and find potential issues.

816ea8380bffc14f.png

10. बधाई हो!

बधाई हो! आपने Home API के नॉलेज बेस और Gemini का इस्तेमाल करके, Android Home API के सैंपल ऐप्लिकेशन को बढ़ा दिया है. इससे यूज़र इंटरफ़ेस (यूआई) अपने-आप बन जाएगा और एपीआई इंटिग्रेट हो जाएगा! अब आपको पता चल गया है कि एआई की मदद से ऐप्लिकेशन डेवलपमेंट की सुविधा का इस्तेमाल करके, सैंपल ऐप्लिकेशन को कैसे बढ़ाया जा सकता है. यहां कुछ और चीज़ें दी गई हैं जिन्हें आज़माया जा सकता है: