iOS-এ Home API ব্যবহার করে মোবাইল অ্যাপ তৈরি করা

১. ভূমিকা

f154e30306882c74.png

Home API কী?

Google Home API ডেভেলপারদের জন্য লাইব্রেরির একটি সেট প্রদান করে যাতে তারা Google Home ইকোসিস্টেম ব্যবহার করতে পারেন। Home API-এর সাহায্যে, ডেভেলপাররা এমন অ্যাপ তৈরি করতে পারেন যা নির্বিঘ্নে স্মার্ট হোম ডিভাইস কমিশন ও নিয়ন্ত্রণ করে।

3e11583c779a2cec.png

এই ভিডিওতে আপনি যে মোবাইল অ্যাপ তৈরি করবেন তার একটি সংক্ষিপ্ত ওয়াকথ্রু প্রদান করে, তাই কোডল্যাব করার সময় ভিডিওটি অনুসরণ করুন।

Home API-এর কম্পোনেন্ট

Home API-তে এগুলি থাকে:

  • Device ও Structure API: ব্যবহারকারীর হোমের সাথে ইন্টার‍্যাক্ট করে। ডিভাইস, রুম ও স্ট্রাকচার (যেমন, থার্মোস্ট্যাটের বর্তমান তাপমাত্রা দেখা) এবং ডিভাইস কন্ট্রোল (যেমন, থার্মোস্ট্যাটের নির্দিষ্ট করা তাপমাত্রা পরিবর্তন করা) সংক্রান্ত তথ্য পড়ার জন্য অ্যাপ এইসব API ব্যবহার করতে পারে।
  • কমিশনিং API: ন্যূনতম প্রচেষ্টায় ফ্যাব্রিকের মধ্যে নতুন Matter ডিভাইস কমিশন (সেট-আপ) করুন।
  • Automation API: ব্যবহারকারীর হোমে চলা অটোমেশন তৈরি, মুছে ফেলা এবং কোয়েরি করা।

পূর্বশর্ত

  • Xcode-এর লেটেস্ট স্টেবল ভার্সন।
  • Google অ্যাকাউন্ট, যার হোমে অন্তত একটি স্ট্রাকচার আছে।
  • টেস্ট অ্যাকাউন্টের মাধ্যমে সেট-আপ করা iOS 16.4+ ভার্সনে চলে এমন iOS ডিভাইস।
  • প্রভিশনিং প্রোফাইল তৈরি করার জন্য Apple Developer Program-এ নথিভুক্ত Apple ID।
  • Google হাব যা Home API-এর সাথে কাজ করে।

আপনি কী শিখবেন

  • পেশাদার পদ্ধতি সহ Home API ব্যবহার করে কীভাবে iOS অ্যাপ তৈরি করতে হয়।
  • স্মার্ট হোমকে উপস্থাপন ও নিয়ন্ত্রণ করতে কীভাবে ডিভাইস ও স্ট্রাকচার API ব্যবহার করতে হয়।
  • Google Home ইকোসিস্টেমে ডিভাইস যোগ করতে কীভাবে কমিশনিং API ব্যবহার করবেন।
  • বেসিক অটোমেশন তৈরি করতে কীভাবে Automation API ব্যবহার করবেন।

২. আপনার হোম সেট-আপ করুন

ডিভাইস রেডি করুন

Google Home Playground বিভিন্ন ধরনের আগে থেকে তৈরি এমুলেট করা স্মার্ট হোম ডিভাইস অফার করে এবং Home API-এর সম্পূর্ণ সম্ভাবনা এক্সপ্লোর করার জন্য সাজেস্ট করা হয়, বিশেষ করে আপনার বাড়িতে সীমিত সংখ্যক ডিভাইস থাকলে।

Google Home অ্যাপে Google Home Playground-এ সাইন-ইন করতে এবং অ্যাকাউন্ট লিঙ্ক করার প্রসেস সম্পূর্ণ করতে নির্দেশাবলী অনুসরণ করুন। এটি সম্পূর্ণ করার পরে, আপনি Google Home অ্যাপের "ডিভাইস" ট্যাবে ডিভাইসগুলি দেখতে পাবেন।

c892afce113abe8f.png

৩. সেট-আপ করা হচ্ছে

স্যাম্পেল অ্যাপের কোড পান

GitHub থেকে সোর্স কোড ক্লোন করে শুরু করুন:

git clone https://github.com/google-home/google-home-api-sample-app-ios.git

এই কোডল্যাবের জন্য স্যাম্পেল ডিরেক্টরিতে দুটি ব্রাঞ্চ আছে, start এবং finished।

  • start: এই প্রোজেক্টের স্টার্টার কোড যেখানে আপনি কোডল্যাব সম্পূর্ণ করার জন্য পরিবর্তন করবেন।
  • finished: এই কোডল্যাবের জন্য সম্পূর্ণ কোড, আপনার কাজ চেক করার জন্য ব্যবহার করা হয়।

'শুরু' কোড এক্সপ্লোর করুন

আপনার ক্লোন করা রিপোজিটরির start ব্রাঞ্চে পরিবর্তন করে এই কোডল্যাব শুরু করুন:

git checkout start

এই ব্রাঞ্চে প্রোজেক্টের স্টার্টার কোড আছে। সম্পূর্ণ কার্যকারিতা প্রয়োগ করার জন্য আপনি কোডল্যাব জুড়ে এই কোড পরিবর্তন করবেন। কোডল্যাব স্যাম্পেল অ্যাপ Home API iOS SDK-এর সাথে ইন্টার‍্যাক্ট করার জন্য Swift-এ তৈরি একটি প্রাথমিক স্ট্রাকচার প্রদান করে। start প্রোজেক্টের মূল উপাদানগুলি এখানে দেওয়া হল:

  • Main Entry (GoogleHomeAPISampleIOSApp): GoogleHomeAPISampleIOS/Main/GoogleHomeAPISampleIOS.swift-এ অবস্থিত, এটি হল প্রধান অ্যাপ এন্ট্রি পয়েন্ট। এটি SDK কনফিগার ও ইনিশিয়ালাইজ করে এবং প্রাথমিক ইউজার ইন্টারফেস সেট-আপ করে।
  • 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: UI-তে কন্ট্রোল করা যায় এমন ডিভাইস দেখানোর জন্য একটি মূল ক্লাস।
    • নির্দিষ্ট সাবক্লাস (LightControl.swift, FanControl.swift, OnOffPlugInUnitControl.swift এবং আরও অনেক কিছু): বিভিন্ন ধরনের ডিভাইসের বৈশিষ্ট্যের উপর ভিত্তি করে UI লজিক, ডিভাইস কন্ট্রোল এবং স্টেট ম্যাপিং প্রয়োগ করুন।
    • DeviceControlFactory.swift: প্রদত্ত HomeDevice-এর জন্য উপযুক্ত DeviceControl সাবক্লাস তৈরি করার জন্য দায়বদ্ধ।
  • Commissioning (Commissioning/):
    • CommissioningManager.swift: Matter ডিভাইস কমিশন করার ফ্লো ম্যানেজ করার লজিক থাকে।
  • Utilities & UX (Utils/, UX/, Storage/): UI এলিমেন্ট (রঙ, ডাইমেনশন), সমস্যা সমাধান, ডেটা স্টোরেজ (SelectedStructureStorage.swift) ও অন্যান্য ইউটিলিটির জন্য হেল্পার কোড থাকে।

এই কোডল্যাব জুড়ে, আপনি TODO-এর মতো কমেন্ট বা কমেন্ট হিসেবে চিহ্নিত করা কোড ব্লক এবং start প্রোজেক্টের মধ্যে সতর্কতা দেখতে পাবেন। প্রয়োজনীয় কার্যকারিতা প্রয়োগ করার জন্য আপনাকে যেসব বিভাগে কোড যোগ করতে বা আনকমেন্ট করতে হবে, এগুলি সেই বিভাগগুলিকে চিহ্নিত করে।

Apple ডেপ্লয়মেন্ট কনফিগারেশন ফাইল তৈরি করুন

App Attest কনফিগার করতে, Apple ডেপ্লয়মেন্ট কনফিগারেশন ফাইল তৈরি করার নির্দেশাবলী অনুসরণ করুন। মনে রাখবেন যে সেট-আপ করার পরে, অ্যাপটি শুধুমাত্র একটি আসল ডিভাইসে ডিপ্লয় করা যেতে পারে, সিমুলেটরে নয়।

যাচাইকরণ সেট-আপ করা

OAuth ক্লায়েন্ট আইডি পেতে এবং Home API চালু করতে, প্রথমে Google Cloud-এ সাইন-ইন করুন এবং হয় একটি নতুন প্রোজেক্ট তৈরি করুন অথবা আগে থেকে আছে এমন একটি প্রোজেক্ট বেছে নিন। তারপর, OAuth ক্লায়েন্ট আইডি তৈরি করতে ও Home API চালু করতে এবং অনুমোদিত তালিকায় আপনার অ্যাকাউন্ট যোগ করতে, উল্লেখ করা ধাপগুলি অনুসরণ করুন।

SDK সেট-আপ করুন

Home API iOS SDK পান এবং SDK সেট-আপ করুন লিঙ্কে দেওয়া সেট-আপ সংক্রান্ত নির্দেশাবলী দেখে এটি কনফিগার করুন। HOME_API_TODO_ADD_APP_GROUP-এর জায়গায় আপনার নিজের অ্যাপ গ্রুপ ব্যবহার করতে ভুলবেন না।

প্রোজেক্ট তৈরি ও রান করুন

start ব্রাঞ্চের সাথে প্রোজেক্ট তৈরি ও রান করার পরে, একটি TODO ডায়ালগ ও "সাইন-ইন করতে হবে" লেখা সহ একটি স্ক্রিন দেখা যাবে। Home API ইন্টার‍্যাকশন নিম্নলিখিত বিভাগে প্রয়োগ করা হবে।

bd56b7080037e38a.png 9c0f08a3f4197a77.png

মনে রাখবেন: ডায়ালগে দেখানো টেক্সটের জন্য প্রোজেক্ট সার্চ করে যে কোডটি পরিবর্তন করতে হবে সেটি খুঁজে নিন। যেমন, "TODO: initialize Home" সার্চ করুন।

৪. শুরু করা

হোম শুরু করুন

iOS-এর জন্য Home API-এর যেকোনও একটি ব্যবহার করার আগে, আপনার অ্যাপে Home শুরু করতে হবে। Home হল SDK-এর টপ-লেভেল এন্ট্রি এবং ব্যবহারকারীর স্ট্রাকচারে সব এন্টিটিতে অ্যাক্সেস প্রদান করে। কোনও নির্দিষ্ট ধরনের সব এন্টিটির জন্য অনুরোধ করার সময়, API একটি 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 API ব্যবহার করার অনুমতি

আপনি অ্যাপটি চালালে সম্মতি সংক্রান্ত স্ক্রিনটি দেখতে পাবেন। Google Home স্ট্রাকচার বেছে নিন এবং আপনার Google Cloud প্রোজেক্টের অনুমতি তালিকায় থাকা অ্যাকাউন্টটি বেছে নিন।

47310f458c0094d9.png 4a571dbd9979a88c.png e29c75891a3a67af.png

৫. ডিভাইস ও স্ট্রাকচার

রুম ও ডিভাইস সম্পর্কে তথ্য পাওয়া

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 হিসেবে ডিভাইসগুলিকে ইন্টার‍্যাক্ট করতে দেয়।

4c677c4c294e67ca.png

মনে রাখবেন: আপনার ডিভাইস 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()-এর সাথে নতুন রুম তৈরি করতে, উপরে বাঁদিকের কোণে গিয়ে "+" আইকন > রুম যোগ করুন বিকল্প বেছে নিন। আপনার নতুন রুমের নাম লিখুন এবং "রুম তৈরি করুন" বিকল্পে ক্লিক করুন। কয়েক সেকেন্ড পরে নতুন রুম দেখা যাবে।

b122ae6642b7da1c.png a45f785e1d51938e.png 7753b56cbdcff8d6.png

ডিভাইস অন্য রুমে সরান

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()-এর সাহায্যে ডিভাইসটি অন্য জায়গায় সরাতে, এটি বেশিক্ষণ প্রেস করে "অন্য রুমে সরান" বিকল্প বেছে নিন এবং নতুন রুমটি বেছে নিন।

f9627592af44163d.png fd126fabb454f2bf.png 813e1e23e50cd9f6.png

খালি রুম মুছে দেওয়া

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()-এর সাহায্যে খালি রুম মুছতে, রুমের নামের ডানদিকে ট্র্যাশ আইকনে ক্লিক করুন এবং অ্যাকশন কনফার্ম করুন। মনে রাখবেন, শুধুমাত্র খালি রুমই মুছে ফেলা যাবে।

4f129262ad67f564.png

মনে রাখবেন: খালি রুম তৈরি করতে ডিভাইসটি পিছনে সরান।

৬. কমিশনিং

মনে রাখবেন: এই বিভাগের জন্য একটি Google হাব এবং একটি Matter ডিভাইস প্রয়োজন। আপনার স্ট্রাকচারে Google হাব অনলাইন এবং অ্যাক্সেসযোগ্য কিনা তা নিশ্চিত করুন। আপনার কাছে Matter ডিভাইস না থাকলে, পরিবর্তে Matter ভার্চুয়াল ডিভাইস অ্যাপ ব্যবহার করে দেখুন।

Matter ডিভাইস যোগ করা

কমিশনিং API আপনার অ্যাপকে ব্যবহারকারীর হোম ও 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 ব্যবহার করে। রুম ও ডিভাইসের নাম বেছে নেওয়ার পরে, "ডিভাইস" স্ক্রিনে ডিভাইসটি দেখানো হয়।

adf6cbb531787aaf.png f002bd6320bc480d.png

৭. অটোমেশন

হোমে দেখানো সব অটোমেশন দেখুন

নিচের নেভিগেশন বারে অটোমেশন বিকল্পে ট্যাপ করুন। এটি structure.listAutomations()-এর সাথে আপনার স্ট্রাকচারের সব অটোমেশন তালিকাভুক্ত করবে।

cc6d50f72f812c24.png

মনে রাখবেন: আপনার কোনও হোম অটোমেশন সেট-আপ করা না থাকলে, আপনি "শুরু করতে অটোমেশন যোগ করুন" মেসেজটি দেখতে পাবেন।

অটোমেশন তৈরি করুন

এখন আপনি ডিভাইস ও স্ট্রাকচার API এবং নতুন ডিভাইস যোগ করার ব্যাপারে জেনে গেছেন, তাই এবার Automation API ব্যবহার করে নতুন অটোমেশন তৈরি করার সময় এসে গেছে।

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()-এর মাধ্যমে অটোমেশন তৈরি করুন।

21c1f8ea2a29134b.png 4bd36f6ed9c5f6e9.png

মনে রাখবেন: আপনার বাড়িতে থাকা ডিভাইসের উপর নির্ভর করে অটোমেশন উপলভ্য হয়। আপনি যদি কোনও উপলভ্য অটোমেশন দেখতে না পান, তাহলে আপনার লাইট ডিভাইসের নাম পরিবর্তন করে "light2" করে দেখুন।

"ডিভাইস" ট্যাবে ফিরে যান এবং "light2" নামের আলোটি চালু করুন। পাঁচ সেকেন্ড পরে এটি অটোমেটিক বন্ধ হয়ে যাবে।

অটোমেশনের কম্পোনেন্টগুলি হল:

  • স্টার্টার: এটি এমন একটি ইভেন্ট যা অটোমেশন শুরু করে। এই উদাহরণে, OnOffTrait-এ কোনও পরিবর্তন হলে অটোমেশন শুরু হবে।
  • শর্ত: স্টার্টার ডিভাইস নির্দিষ্ট প্রয়োজনীয়তা পূরণ করে কিনা তা এটি চেক করে। এই ক্ষেত্রে, আলো চালু থাকলে অটোমেশন এক্সিকিউট করা হবে।
  • অ্যাকশন: এটি হল সেই অটোমেশন যা আপনি করতে চান, তবে শুধুমাত্র স্টার্টার প্রয়োজনীয়তা পূরণ করলে। শর্ত পূরণ হলে, লাইট বন্ধ হয়ে যাবে।

আরও উদাহরণের জন্য, অটোমেশনের উদাহরণ পৃষ্ঠা দেখুন।

অটোমেশন মুছে দেওয়া

আপনি আগে থেকে থাকা অটোমেশনে বাঁদিকে সোয়াইপ করে আপনার স্ট্রাকচার থেকে এটি সরানোর জন্য ট্র্যাশ আইকনে ট্যাপ করলে, structure.deleteAutomation() পদ্ধতিটি চালু হয়।

dc678cd9e16f89a5.png

৮. অভিনন্দন

অভিনন্দন! আপনি iOS-এর জন্য Home API ব্যবহার করে একটি বেসিক স্মার্ট হোম অ্যাপ তৈরি করেছেন।

আপনি কী কী করেছেন:

  • ইনিশিয়ালাইজেশন: Home.connect() ব্যবহার করে আপনার অ্যাপ Google Home ইকোসিস্টেমের সাথে কানেক্ট করা হয়েছে।
  • অনুমতি: হোম ডেটা অ্যাক্সেস করার জন্য ব্যবহারকারীর যাচাইকরণ ও অনুমোদন ম্যানেজ করা।
  • ডিভাইস ও স্ট্রাকচার: home.rooms() ও home.devices() ব্যবহার করে রুম ও ডিভাইস ফেচ করে দেখানো হয়েছে।
  • ডিভাইস কন্ট্রোল: ডিভাইসের সাথে ইন্টার‍্যাকশন প্রয়োগ করা হয়েছে, যেমন OnOffPluginUnitDeviceType-এর বৈশিষ্ট্যে কমান্ড কল করে তার স্ট্যাটাস টগল করা।
  • স্ট্রাকচার ম্যানেজমেন্ট: নতুন রুম তৈরি করা (structure.createRoom()), এক রুম থেকে অন্য রুমে ডিভাইস সরানো (structure.move()) এবং খালি রুম মুছে ফেলার (structure.deleteRoom()) মতো কার্যকারিতা যোগ করা হয়েছে।
  • কমিশনিং: নতুন Matter ডিভাইস (MatterAddDeviceRequest) যোগ করার জন্য SDK-এর কমিশনিং ফ্লো ইন্টিগ্রেট করা হয়েছে।
  • অটোমেশন: কোনও স্ট্রাকচারের মধ্যে কীভাবে অটোমেশন তালিকাভুক্ত, তৈরি (structure.createAutomation()) এবং মুছে (structure.deleteAutomation()) ফেলতে হয় তা এক্সপ্লোর করা হয়েছে।

iOS-এ সমৃদ্ধ স্মার্ট হোম কন্ট্রোল অভিজ্ঞতা তৈরি করতে Home API-এর সুবিধা কীভাবে নিতে হয় সে সম্পর্কে এখন আপনার একটি প্রাথমিক ধারণা রয়েছে।

পরবর্তী ধাপ:

  • স্যাম্পেল অ্যাপে (লাইট, ফ্যান, ব্লাইন্ড ইত্যাদি) দেওয়া অন্যান্য ধরনের ডিভাইস কন্ট্রোল করার সুবিধা এক্সপ্লোর করুন।
  • বিভিন্ন ডিভাইসের জন্য উপলভ্য বিভিন্ন বৈশিষ্ট্য এবং কমান্ড সম্পর্কে আরও জানুন।
  • বিভিন্ন স্টার্টার, শর্ত ও অ্যাকশন ব্যবহার করে আরও জটিল অটোমেশন তৈরি করার পরীক্ষা করুন।
  • আরও উন্নত ফিচার ও বিবরণের জন্য Home API ডকুমেন্টেশন দেখুন।

দারুণ!