1. परिचय

Home APIs क्या हैं?
Google Home APIs, डेवलपर को लाइब्रेरी का एक सेट उपलब्ध कराते हैं. इससे डेवलपर, Google Home के नेटवर्क का इस्तेमाल कर पाते हैं. Home APIs की मदद से, डेवलपर ऐसे ऐप्लिकेशन बना सकते हैं जो स्मार्ट होम डिवाइसों को आसानी से चालू और कंट्रोल कर सकें.

इस वीडियो में, आपको बनाए जाने वाले मोबाइल ऐप्लिकेशन के बारे में कम शब्दों में जानकारी दी गई है. इसलिए, कोडलैब करते समय वीडियो को फ़ॉलो करें.
Home APIs के कॉम्पोनेंट
Home APIs में ये शामिल हैं:
- डिवाइस और स्ट्रक्चर के लिए एपीआई: उपयोगकर्ता के होम से इंटरैक्ट करें. इन एपीआई का इस्तेमाल करके, ऐप्लिकेशन डिवाइसों, कमरों, और स्ट्रक्चर की जानकारी पढ़ सकते हैं. जैसे, थर्मोस्टैट का मौजूदा तापमान देखना. साथ ही, डिवाइसों को कंट्रोल कर सकते हैं. जैसे, थर्मोस्टैट का सेट किया गया तापमान बदलना.
- कमीशनिंग एपीआई: Matter डिवाइसों को फ़ैब्रिक में आसानी से सेट अप करें.
- ऑटोमेशन एपीआई: उपयोगकर्ता के होम में चल रहे ऑटोमेशन बनाएं, मिटाएं, और उनसे जुड़ी क्वेरी करें.
ज़रूरी शर्तें
- Xcode का सबसे नया स्टेबल वर्शन.
- एक Google खाता, जिसमें होम में कम से कम एक स्ट्रक्चर हो.
- iOS 16.4 या इसके बाद के वर्शन वाला iOS डिवाइस, जिसे टेस्ट खाते से सेट अप किया गया हो.
- प्रोविज़निंग प्रोफ़ाइल जनरेट करने के लिए, Apple Developer Program में रजिस्टर किया गया Apple ID.
- Home API के साथ काम करने वाला Google हब.
आपको क्या सीखने को मिलेगा
- Home APIs का इस्तेमाल करके, iOS ऐप्लिकेशन बनाने का तरीका और इसके सबसे सही तरीके.
- स्मार्ट होम को दिखाने और उसे कंट्रोल करने के लिए, Device और Structure API इस्तेमाल करने का तरीका.
- Google Home नेटवर्क में डिवाइसों को जोड़ने के लिए, Commissioning API का इस्तेमाल करने का तरीका.
- ऑटोमेशन एपीआई का इस्तेमाल करके, बुनियादी ऑटोमेशन बनाने का तरीका.
2. अपना होम सेट अप करना
डिवाइसों को तैयार करना
Google Home Playground में, पहले से तैयार किए गए कई स्मार्ट होम डिवाइसों के वर्चुअल वर्शन उपलब्ध होते हैं. हमारा सुझाव है कि Home APIs की सभी सुविधाओं को एक्सप्लोर करने के लिए, इसका इस्तेमाल करें. खास तौर पर, तब जब आपके घर में सीमित संख्या में डिवाइस हों.
Google Home Playground में साइन इन करने के लिए, दिए गए निर्देशों का पालन करें. इसके बाद, Google Home ऐप्लिकेशन में जाकर, खाता लिंक करने की प्रोसेस पूरी करें. ऐसा करने के बाद, आपको Google Home ऐप्लिकेशन में "डिवाइस" टैब में डिवाइस दिखेंगे.

3. सेट अप करना
सैंपल के तौर पर मिले ऐप्लिकेशन का कोड पाना
सबसे पहले, GitHub से सोर्स कोड को क्लोन करें:
git clone https://github.com/google-home/google-home-api-sample-app-ios.git
सैंपल डायरेक्ट्री में इस कोडलैब के लिए, दो ब्रांच start और finished मौजूद हैं.
start: इस प्रोजेक्ट का स्टार्टर कोड, जिसमें कोडलैब को पूरा करने के लिए बदलाव किए जाएंगे.finished: इस कोडलैब के लिए पूरा कोड, जिसका इस्तेमाल आपके काम की जांच करने के लिए किया जाता है.
‘start' कोड को एक्सप्लोर करना
इस कोडलैब को शुरू करने के लिए, क्लोन की गई रिपॉज़िटरी की start ब्रांच पर स्विच करें:
git checkout start
इस ब्रांच में, प्रोजेक्ट के लिए स्टार्टर कोड मौजूद है. इस कोडलैब के दौरान, आपको इस कोड में बदलाव करना होगा, ताकि पूरी सुविधा को लागू किया जा सके. कोडलैब के सैंपल ऐप्लिकेशन में, Swift में बनाया गया एक बुनियादी स्ट्रक्चर होता है. इसका इस्तेमाल, Home APIs iOS SDK के साथ इंटरैक्ट करने के लिए किया जाता है. start प्रोजेक्ट के मुख्य कॉम्पोनेंट यहां दिए गए हैं:
Main Entry (GoogleHomeAPISampleIOSApp): यहGoogleHomeAPISampleIOS/Main/GoogleHomeAPISampleIOS.swiftमें मौजूद होता है. यह ऐप्लिकेशन का मुख्य एंट्री पॉइंट है. यह एसडीके को कॉन्फ़िगर और शुरू करता है. साथ ही, प्राइमरी यूज़र इंटरफ़ेस को सेट अप करता है.Core Views (View/):MainView.swift: लॉन्च के बाद रूट व्यू, जिसमें मुख्यNavigationViewशामिल है. यह चालू Google Home स्ट्रक्चर को चुनने और उससे जुड़ेStructureViewको दिखाने का काम करता है.StructureView.swift: यह फ़िलहाल चुने गए स्ट्रक्चर का कॉन्टेंट दिखाता है. इसमें टैब का इस्तेमाल करके, डिवाइसों के ग्रिड और ऑटोमेशन की सूची के बीच स्विच किया जा सकता है. इसमें कमरे या डिवाइस जोड़ने के लिए मेन्यू भी होते हैं.DeviceView.swift: यहStructureViewग्रिड में मौजूद किसी एक डिवाइस के लिए, इंटरैक्टिव टाइल को दिखाता है.AutomationsView.swift: इससे स्ट्रक्चर के लिए, मौजूदा ऑटोमेशन की सूची दिखती है. साथ ही, ऑटोमेशन बनाने या उसकी जानकारी देखने के लिए नेविगेशन की सुविधा मिलती है.
ViewModels (ViewModel/): ये क्लास, व्यू के लिए स्टेटस और लॉजिक को मैनेज करती हैं.AccountViewModel.swift: यहHomeऑब्जेक्ट से कनेक्शन को हैंडल करता है और पुष्टि की स्थिति को मैनेज करता है.MainViewModel.swift: यह उपलब्धStructureऑब्जेक्ट की सूची को मैनेज करता है और चुने गए स्ट्रक्चर को ट्रैक करता है.StructureViewModel.swift: यह चुनी गई इमारत में मौजूद कमरों औरDeviceControlऑब्जेक्ट को मैनेज करता है.AutomationList.swift,AutomationViewModel.swiftवगैरह: ऑटोमेशन को फ़ेच करने, दिखाने, बनाने, और मैनेज करने की सुविधा.
Device Controls (ViewModel/Device/):DeviceControl.swift: यूज़र इंटरफ़ेस (यूआई) में कंट्रोल किए जा सकने वाले डिवाइसों को दिखाने के लिए एक बेसिक क्लास.- खास सबक्लास (
LightControl.swift,FanControl.swift,OnOffPlugInUnitControl.swiftवगैरह): अलग-अलग तरह के डिवाइसों के लिए, उनकी विशेषताओं के आधार पर यूज़र इंटरफ़ेस (यूआई) लॉजिक, डिवाइस कंट्रोल, और स्टेट मैपिंग लागू करें. DeviceControlFactory.swift: यह किसीHomeDeviceके लिए, सहीDeviceControlसबक्लास बनाने के लिए ज़िम्मेदार है.
Commissioning (Commissioning/):CommissioningManager.swift: इसमें Matter डिवाइस को चालू करने के फ़्लो को मैनेज करने का लॉजिक होता है.
Utilities & UX (Utils/, UX/, Storage/): इसमें यूज़र इंटरफ़ेस (यूआई) एलिमेंट (रंग, डाइमेंशन), गड़बड़ी ठीक करने, डेटा स्टोरेज (SelectedStructureStorage.swift), और अन्य सुविधाओं के लिए हेल्पर कोड शामिल है.
इस कोडलैब में, आपको start प्रोजेक्ट में TODO जैसी टिप्पणियां या टिप्पणी के तौर पर मार्क किए गए कोड ब्लॉक और सूचनाएं मिलेंगी. इनसे उन सेक्शन का पता चलता है जहां आपको ज़रूरी फ़ंक्शन लागू करने के लिए, कोड जोड़ना होगा या उसे अनकमेंट करना होगा. इसके लिए, दिए गए निर्देशों का पालन करें.
Apple डिवाइसों के लिए डिप्लॉयमेंट कॉन्फ़िगरेशन फ़ाइलें बनाना
App Attest को कॉन्फ़िगर करने के लिए, Apple की डिप्लॉयमेंट कॉन्फ़िगरेशन फ़ाइलें बनाने के निर्देशों का पालन करें. ध्यान दें कि सेटअप के बाद, ऐप्लिकेशन को सिर्फ़ असली डिवाइस पर डिप्लॉय किया जा सकता है, सिम्युलेटर में नहीं.
पुष्टि करने की सुविधा सेट अप करना
OAuth क्लाइंट आईडी पाने और Home APIs चालू करने के लिए, पहले Google Cloud में साइन इन करें. इसके बाद, कोई नया प्रोजेक्ट बनाएं या कोई मौजूदा प्रोजेक्ट चुनें. इसके बाद, OAuth क्लाइंट आईडी जनरेट करने और Home APIs को चालू करने के लिए दिया गया तरीका अपनाएं. साथ ही, अपने खाते को अनुमति वाली सूची में जोड़ें.
एसडीके टूल सेट अप करना
Home APIs iOS SDK को डाउनलोड करें और उसे कॉन्फ़िगर करें. इसके लिए, एसडीके सेट अप करें में दिए गए सेटअप के निर्देश देखें. HOME_API_TODO_ADD_APP_GROUP को अपने ऐप्लिकेशन ग्रुप से बदलना न भूलें.
प्रोजेक्ट बनाना और उसे चलाना
start ब्रांच के साथ प्रोजेक्ट बनाने और चलाने के बाद, आपको TODO डायलॉग बॉक्स और "साइन इन करना ज़रूरी है" मैसेज वाली स्क्रीन दिखेगी. Home APIs के साथ इंटरैक्शन को इन सेक्शन में लागू किया जाएगा.

ध्यान दें: जिस कोड में बदलाव करना है उसे ढूंढने के लिए, प्रोजेक्ट में डायलॉग बॉक्स में दिखने वाला टेक्स्ट खोजें. उदाहरण के लिए, "TODO: initialize Home" खोजें.
4. डेटा लेयर में इवेंट बनाने की प्रोसेस
होम पेज को शुरू करना
iOS के लिए किसी भी Home API का इस्तेमाल करने से पहले, आपको अपने ऐप्लिकेशन में Home को शुरू करना होगा. Home, एसडीके टूल का टॉप-लेवल एंट्री पॉइंट है. इससे उपयोगकर्ता के स्ट्रक्चर में मौजूद सभी इकाइयों को ऐक्सेस किया जा सकता है. किसी खास तरह की सभी इकाइयों का अनुरोध करने पर, एपीआई एक Query ऑब्जेक्ट दिखाता है. इससे आपको यह चुनने की सुविधा मिलती है कि नतीजे कैसे दिखाए जाएं. GoogleHomeAPISampleIOS/Accounts/AccountViewModel.swift में, connect() में मौजूद टिप्पणी और सूचना को हटाएं, ताकि होम पेज को शुरू किया जा सके.
/// TODO: initialize Home
/// Remove comments to initialize Home and handling permission.
private func connect() {
Task {
do {
self.home = try await Home.connect()
} catch {
Logger().error("Auth error: \(error).")
}
}
}
Home APIs इस्तेमाल करने की अनुमति
ऐप्लिकेशन चलाने पर, ऐसी स्क्रीन जहां OAuth के लिए सहमति दी जाती है, दिखेगी. Google Home होम स्ट्रक्चर चुनें. इसके बाद, वह खाता चुनें जो आपके Google Cloud क्लाउड प्रोजेक्ट की अनुमति वाली सूची में शामिल है.

5. डिवाइस और स्ट्रक्चर
कमरों और डिवाइसों की जानकारी पाना
GoogleHomeAPISampleIOS/ViewModel/StructureViewModel.swift में, getRoomsAndDevices() में मौजूद टिप्पणी और सूचना को हटाएं, ताकि चुने गए स्ट्रक्चर में मौजूद कमरों और डिवाइसों को क्रमशः home.rooms() और home.devices() के साथ पाया जा सके.
/// TODO: get rooms and devices
/// Remove comments to get the rooms and devices from home entry
private func getRoomsAndDevices(){
self.home.rooms().batched()
.combineLatest(self.home.devices().batched())
.receive(on: DispatchQueue.main)
.catch { error in
Logger().error("Failed to load rooms and devices: \(error)")
return Just((Set<Room>(), Set<HomeDevice>()))
}
.map { [weak self] rooms, devices in
guard let self = self else { return [] }
self.hasLoaded = true
return self.process(rooms: rooms, devices: devices)
}
/// receive from .map and .assign() to publisher entries
.assign(to: &self.$entries)
}
process() फ़ंक्शन, सबसे पहले यह पक्का करता है कि डिवाइस एक ही कमरे में हों. इसके बाद, DeviceControl और DeviceControlFactory का इस्तेमाल करके, डिवाइसों को HomeDevices के तौर पर इंटरैक्ट करने की अनुमति देता है.

ध्यान दें: अगर आपका डिवाइस DeviceControlFactory में मौजूद नहीं है, तो वह "काम नहीं करता" के तौर पर दिखेगा. इस बारे में ज़्यादा जानने के लिए कि किन डिवाइसों पर यह सुविधा काम करती है, iOS पर काम करने वाले डिवाइस टाइप पेज पर जाएं.
किसी डिवाइस के साथ इंटरैक्ट करना
डिवाइसों पर टैप या स्लाइड करने पर, प्लग outlet1 शुरुआत में बंद रहता है. इसके साथ इंटरैक्शन चालू करने के लिए, GoogleHomeAPISampleIOS/ViewModel/Device/OnOffPlugInUnitControl.swift ढूंढें. इसके बाद, primaryAction() फ़ंक्शन में मौजूद टिप्पणी और सूचना को हटाएं.
/// TODO: primary action of OnOffPlug
/// Toggles the plug; usually provided as the `action` callback on a Button.
public override func primaryAction() {
self.updateTileInfo(isBusy: true)
Task { @MainActor [weak self] in
guard
let self = self,
let onOffPluginUnitDeviceType = self.onOffPluginUnitDeviceType,
let onOffTrait = onOffPluginUnitDeviceType.matterTraits.onOffTrait
else { return }
do {
try await onOffTrait.toggle()
} catch {
Logger().error("Failed to to toggle OnOffPluginUnit on/off trait: \(error)")
self.updateTileInfo(isBusy: false)
}
}
}
primaryAction() फ़ंक्शन, OnOffPlugInUnitControl क्लास में मौजूद होता है. यह स्मार्ट प्लग या OnOffPluginUnitDeviceType से दिखाए गए किसी भी डिवाइस की पावर स्टेट को टॉगल करता है.
डिवाइस कंट्रोल के अन्य उदाहरण GoogleHomeAPISampleIOS/ViewModel/Device में उपलब्ध हैं.
एक नया रूम बनाना
Structure API की मदद से, रूम बनाए और मिटाए जा सकते हैं. साथ ही, डिवाइसों को एक रूम से दूसरे रूम में ट्रांसफ़र किया जा सकता है.
GoogleHomeAPISampleIOS/ViewModel/StructureViewModel.swift में, टिप्पणी हटाएं और addRoom() में सूचना दें.
/// TODO: add room
/// Add a new room in a given structure.
func addRoom(name: String, structure: Structure) {
Task {
do {
// The view will be updated with the values from the devices publisher.
_ = try await structure.createRoom(name: name)
} catch {
Logger().error("Failed to create room: \(error)")
}
}
}
structure.createRoom() में नया रूम बनाने के लिए, सबसे ऊपर बाईं ओर जाएं. इसके बाद, "+" आइकॉन > रूम जोड़ें को चुनें. रूम का नया नाम डालें और "रूम बनाएं" पर क्लिक करें. कुछ सेकंड बाद, नया रूम दिखने लगेगा.

डिवाइस को किसी दूसरे रूम में मूव करना
GoogleHomeAPISampleIOS/ViewModel/StructureViewModel.swift में, टिप्पणी हटाएं और moveDevice() में सूचना दें.
/// TODO: move device
/// Move a device into a different room.
func moveDevice(device deviceID: String, to roomID: String, structure: Structure) {
Task {
do {
_ = try await structure.move(device: deviceID, to: roomID)
} catch {
Logger().error("Failed to move to room: \(error)")
}
}
}
structure.move() की मदद से डिवाइस को दूसरी जगह सेट करने के लिए, उसे दबाकर रखें. इसके बाद, "किसी दूसरे कमरे में ले जाएं" को चुनें और नया कमरा चुनें.

किसी खाली रूम को मिटाना
GoogleHomeAPISampleIOS/ViewModel/StructureViewModel.swift में, टिप्पणी हटाएं और removeRoom() में सूचना दें.
/// TODO: delete room
/// Delete an empty room in a given structure.
func removeRoom(id: String, structure: Structure) {
Task {
do {
// The view will be updated with the values from the devices publisher.
_ = try await structure.deleteRoom(id: id)
} catch {
Logger().error("Failed to remove room: \(error)")
}
}
}
structure.deleteRoom() की मदद से, किसी खाली रूम को मिटाने के लिए, रूम के नाम की दाईं ओर मौजूद ट्रैश आइकॉन पर क्लिक करें. इसके बाद, कार्रवाई की पुष्टि करें. ध्यान दें कि सिर्फ़ खाली रूम मिटाए जा सकते हैं.

ध्यान दें: खाली रूम बनाने के लिए, डिवाइस को वापस ले जाएं.
6. कमीशनिंग
ध्यान दें: इस सेक्शन में बताई गई प्रोसेस के लिए, आपके पास Google हब और Matter डिवाइस होना चाहिए. पक्का करें कि आपके स्ट्रक्चर में मौजूद Google हब ऑनलाइन हो और उस तक पहुंचा जा सके. अगर आपके पास Matter डिवाइस नहीं है, तो Matter वर्चुअल डिवाइस ऐप्लिकेशन का इस्तेमाल करें.
Matter डिवाइस जोड़ना
कमीशनिंग एपीआई की मदद से, आपका ऐप्लिकेशन उपयोगकर्ता के होम और Google खाते में नए Matter डिवाइस जोड़ सकता है. इससे, सीधे आपके ऐप्लिकेशन में आसान सेटअप का अनुभव मिलता है.
GoogleHomeAPISampleIOS/Commissioning/CommissioningManager.swift में, टिप्पणी हटाएं और addMatterDevice() में सूचना दें.
/// TODO: add Matter Device
/// Starts the Matter device commissioning flow to add the device to the user's home.
/// - Parameters:
/// - structure: The structure to add the device to.
/// - add3PFabricFirst: Whether to add the device to a third party fabric first.
public func addMatterDevice(to structure: Structure, add3PFabricFirst: Bool) {
self.isCommissioning = true
/// pass if it's 1p or 3p commissioning
let userDefaults = UserDefaults(
suiteName: CommissioningManager.appGroup)
userDefaults?.set(
add3PFabricFirst, forKey: CommissioningUserDefaultsKeys.shouldPerform3PFabricCommissioning)
Task {
do {
try await structure.prepareForMatterCommissioning()
} catch {
Logger().error("Failed to prepare for Matter Commissioning: \(error).")
self.isCommissioning = false
return
}
// Prepare the Matter request by providing the ecosystem name and home to be added to.
let topology = MatterAddDeviceRequest.Topology(
ecosystemName: "Google Home",
homes: [MatterAddDeviceRequest.Home(displayName: structure.name)]
)
let request = MatterAddDeviceRequest(topology: topology)
do {
Logger().info("Starting MatterAddDeviceRequest.")
try await request.perform()
Logger().info("Completed MatterAddDeviceRequest.")
let commissionedDeviceIDs = try structure.completeMatterCommissioning()
Logger().info("Commissioned device IDs: \(commissionedDeviceIDs).")
} catch let error {
structure.cancelMatterCommissioning()
Logger().error("Failed to complete MatterAddDeviceRequest: \(error).")
}
self.isCommissioning = false
}
}
structure.prepareForMatterCommissioning() की मदद से नया रूम बनाने के लिए, सबसे ऊपर बाईं ओर जाएं. इसके बाद, "+" आइकॉन > Google Fabric में डिवाइस जोड़ें को चुनें. यह आपके रूम में Matter डिवाइस को जोड़ने के लिए, MatterAddDeviceRequest का इस्तेमाल करता है. कमरे और डिवाइस का नाम चुनने के बाद, डिवाइस "डिवाइस" स्क्रीन पर दिखता है.

7. ऑटोमेशन
स्ट्रक्चर में मौजूद सभी ऑटोमेशन देखना
सबसे नीचे मौजूद नेविगेशन बार में, ऑटोमेशन पर टैप करें. इससे आपके स्ट्रक्चर में मौजूद सभी ऑटोमेशन की सूची दिखेगी. साथ ही, structure.listAutomations() भी दिखेगा.

ध्यान दें: अगर आपने कोई होम ऑटोमेशन सेट अप नहीं किया है, तो आपको "शुरू करने के लिए कोई ऑटोमेशन जोड़ें" मैसेज दिखेगा.
कोई ऑटोमेशन बनाना
अब आपको डिवाइस और स्ट्रक्चर एपीआई के बारे में जानकारी मिल गई है. साथ ही, आपको नया डिवाइस जोड़ने का तरीका भी पता चल गया है. इसलिए, अब ऑटोमेशन एपीआई का इस्तेमाल करके नया ऑटोमेशन बनाएं.
GoogleHomeAPISampleIOS/ViewModel/Automation/AutomationsRepository.swift में, lightAutomation() में मौजूद टिप्पणी, सूचना, और खाली ऑटोमेशन को हटाएं.
/// TODO: create automation
/// - Parameter devices: devices in current selected structure
/// - Returns: the automation object to be created
/// This automation will turn off the light after 5 seconds.
public func lightAutomation(devices: Set<HomeDevice>) async throws -> any DraftAutomation {
let light = devices.first { $0.name == "light2" }
guard let light else {
Logger().error("Unable to find light device with name light2")
throw HomeError.notFound("No devices support OnOffLightDeviceType")
}
return automation(
name: "Turn off light after 5 seconds",
description:
"""
Turns off light2 after it has been on for 5 seconds.
"""
) {
let onOffStarter = starter(light, OnOffLightDeviceType.self, OnOffTrait.self)
onOffStarter
condition {
onOffStarter.onOff.equals(true)
}
delay(for: Duration.seconds(5))
action(light, OnOffLightDeviceType.self) {
OnOffTrait.off()
}
}
}
लाइट चालू होने के पांच सेकंड बाद उसे बंद करने वाला ऑटोमेशन बनाने के लिए, ऑटोमेशन व्यू पर जाएं और "+ जोड़ें" बटन पर क्लिक करें. इसके बाद, "पांच सेकंड के बाद लाइट बंद करें" को चुनें. आपको ऑटोमेशन की जानकारी दिखेगी. इसमें starter, condition, और action शामिल हैं. structure.createAutomation() की मदद से ऑटोमेशन बनाने के लिए, "सेव करें" पर क्लिक करें.

ध्यान दें: उपलब्ध ऑटोमेशन, आपके होम में मौजूद डिवाइसों पर निर्भर करते हैं. अगर आपको कोई ऑटोमेशन उपलब्ध नहीं दिखता है, तो लाइट डिवाइस का नाम बदलकर "light2" करें.
"डिवाइस" टैब पर वापस जाएं और "light2" नाम की लाइट चालू करें. यह पांच सेकंड के बाद अपने-आप बंद हो जाएगा.
ऑटोमेशन के कॉम्पोनेंट:
- स्टार्टर: यह एक ऐसा इवेंट है जो ऑटोमेशन को शुरू करता है. इस उदाहरण में,
OnOffTraitमें बदलाव होने पर ऑटोमेशन शुरू हो जाएगा. - शर्त: इससे यह पता चलता है कि स्टार्टर डिवाइस, ज़रूरी शर्तें पूरी करता है या नहीं. इस मामले में, अगर लाइट चालू है, तो ऑटोमेशन ट्रिगर हो जाएगा.
- कार्रवाई: यह वह ऑटोमेशन है जिसे आपको चालू करना है. हालांकि, यह सिर्फ़ तब चालू होगा, जब स्टार्टर ज़रूरी शर्तें पूरी करेगा. शर्तें पूरी होने पर, लाइट बंद हो जाएगी.
ज़्यादा उदाहरणों के लिए, ऑटोमेशन के उदाहरण पेज पर जाएं.
कोई ऑटोमेशन मिटाना
structure.deleteAutomation() मेथड को तब कॉल किया जाता है, जब किसी मौजूदा ऑटोमेशन पर बाईं ओर स्वाइप किया जाता है और उसे अपने होम से हटाने के लिए, ट्रैश आइकॉन पर टैप किया जाता है.

8. बधाई हो
बधाई हो! आपने iOS के लिए Home APIs का इस्तेमाल करके, एक बुनियादी स्मार्ट होम ऐप्लिकेशन बना लिया है.
आपने क्या हासिल किया है:
- शुरुआत करना:
Home.connect()का इस्तेमाल करके, अपने ऐप्लिकेशन को Google Home के नेटवर्क से कनेक्ट करें. - अनुमतियां: होम डेटा को ऐक्सेस करने के लिए, उपयोगकर्ता की पुष्टि और अनुमति को मैनेज किया.
- डिवाइस और स्ट्रक्चर:
home.rooms()औरhome.devices()का इस्तेमाल करके, रूम और डिवाइसों की जानकारी फ़ेच की गई और दिखाई गई. - डिवाइस कंट्रोल: डिवाइस के साथ इंटरैक्शन की सुविधा लागू की गई है. जैसे,
OnOffPluginUnitDeviceTypeकी विशेषताओं पर निर्देश देकर, उसकी स्थिति को टॉगल करना. - स्ट्रक्चर मैनेजमेंट: नए रूम बनाने (
structure.createRoom()), डिवाइसों को एक रूम से दूसरे रूम में ट्रांसफ़र करने (structure.move()), और खाली रूम मिटाने (structure.deleteRoom()) की सुविधा जोड़ी गई है. - कमीशनिंग: Matter के नए डिवाइसों (
MatterAddDeviceRequest) को जोड़ने के लिए, SDK टूल के कमीशनिंग फ़्लो को इंटिग्रेट किया गया. - ऑटोमेशन: किसी स्ट्रक्चर में ऑटोमेशन की सूची बनाने, उन्हें बनाने (
structure.createAutomation()), और मिटाने (structure.deleteAutomation()) का तरीका बताया गया है.
अब आपको इस बारे में बुनियादी जानकारी मिल गई है कि iOS पर स्मार्ट होम कंट्रोल की बेहतरीन सुविधाएं बनाने के लिए, Home APIs का फ़ायदा कैसे लिया जा सकता है.
अगले चरण:
- सैंपल के तौर पर मिले ऐप्लिकेशन में दिए गए अन्य तरह के डिवाइसों (लाइट, पंखे, ब्लाइंड वगैरह) को कंट्रोल करने के बारे में जानें.
- अलग-अलग डिवाइसों के लिए उपलब्ध अलग-अलग विशेषताओं और निर्देशों के बारे में ज़्यादा जानें.
- अलग-अलग स्टार्टर, शर्तों, और कार्रवाइयों का इस्तेमाल करके, ज़्यादा जटिल ऑटोमेशन बनाने की कोशिश करें.
- ज़्यादा ऐडवांस सुविधाओं और जानकारी के लिए, Home APIs से जुड़ा दस्तावेज़ देखें.
बहुत खूब!