Otomatisasi perangkat multipart di iOS

Otomatisasi dapat mereferensikan perangkat multipart dengan cara yang sama seperti otomatisasi yang tidak menggunakan perangkat multipart.

Pertama, dapatkan komponen seperti biasa. Lihat Perangkat multipart untuk mengetahui cara menggunakan perangkat multipart.

Kemudian, untuk setiap bagian yang ingin Anda gunakan dalam otomatisasi, buat AutomationPartPath, yang memungkinkan Anda mereferensikan bagian tersebut dalam pemicu, kondisi, dan tindakan otomatisasi.

//  Obtain a reference to the device:
let multipartDevices = try await self.home.devices(enableMultipartDevices: true).list()

let light = multipartDevices.first(where: {
  $0.parts.contains(OnOffLightDeviceType.self) && $0.structureID == structure.id
})

let lightDeviceType = await light.parts.get(OnOffLightDeviceType.self)

let lightPartPath = light.automationPart(lightDeviceType)

Hal lain yang perlu diperhatikan adalah tindakan otomatisasi biasanya menggunakan perangkat dan jenis perangkat sebagai parameter. Namun, tindakan otomatisasi yang mereferensikan perangkat bagian komponen - sekali lagi, menggunakan AutomationPartPath - hanya memerlukan AutomationPartPath, karena AutomationPartPath sudah berisi referensi ke jenis perangkat selain referensi perangkat komponen.

Misalnya, di Automation API, jenis perangkat Refrigerator dapat diperlakukan sebagai perangkat multipart. Terdiri dari RefrigeratorDevice root yang dapat berisi beberapa kabinet subbagian, seperti freezer atau kabinet standar berjenis TemperatureControlledCabinetDevice.

Untuk membuat otomatisasi kulkas, Anda terutama berinteraksi dengan dua karakteristik Matter standar:

  • RefrigeratorAlarm: Mengekspos alarm status pintu melalui atribut doorOpen pada kolom state.
  • RefrigeratorAndTemperatureControlledCabinetMode: Memungkinkan mode baca dan perintah. Misalnya, menjalankan perintah seperti changeToMode untuk beralih ke mode seperti LowEnergy, RapidCool, atau LowNoise.

Contoh otomatisasi ini dipicu saat pintu kulkas dibuka. Jika pintu dibiarkan terbuka selama lebih dari dua menit, otomatisasi akan menyiarkan notifikasi suara di speaker pintar, mengedipkan lampu dapur, dan mengirim notifikasi push. Perhatikan bahwa otomatisasi ini hanya memengaruhi kompartemen kulkas perangkat, dan mengabaikan kompartemen freezer (jika ada):

import GoogleHomeSDK
import GoogleHomeTypes

typealias RefrigeratorAlarmTrait = Matter.RefrigeratorAlarmTrait
typealias OnOffTrait = Matter.OnOffTrait

// Fetch devices using the multipart device model.
let multipartDevices = try await self.home.devices(enableMultipartDevices: true).list()

// Obtain a reference to the refrigerator device.
guard let refrigeratorDevice = multipartDevices.first {
    $0.types.contains(TemperatureControlledCabinetDeviceType.self) &&
    $0.traits.contains(Matter.RefrigeratorAndTemperatureControlledCabinetModeTrait.self) &&
    $0.traits.contains(Matter.RefrigeratorAlarmTrait.self)
  }

let refrigeratorDeviceType = await refrigeratorDevice.parts.get(RefrigeratorDeviceType.self).first

// Get all temperature-controlled cabinet parts of the refrigerator
let cabinets = refrigeratorDeviceType.parts(type: TemperatureControlledCabinetDeviceType.self)

// Find the cabinet part with the 'refrigerator' semantic tag
let refrigeratorCabinet = cabinets.first {
  $0.metadata.tags.contains(SemanticTag.Refrigerator.refrigerator)
}
var cabinetPartPath = refrigeratorDevice.automationPart(refrigeratorCabinet)

let structure = home.structures().list().first

let speaker = multipartDevices.first(where: {
        $0.types.contains(SpeakerDeviceType.self) && $0.structureID == structure.id
      })

let refrigeratorDoorAlert = automation(
  name: "Refrigerator Door Open Alert",
  description: "Warn when the refrigerator door has been open for over 2 min."
) {
  // 1. Starter: Monitor the refrigerator door alarm trait
  let alarmStarter = starter(
    cabinetPartPath,
    RefrigeratorAlarmTrait.self
  )

  alarmStarter

  // 2. Condition: Ensure the 'doorOpen' alarm remains active for 120 seconds
  condition(for: .seconds(120)) {
    alarmStarter.state.doorOpen.equals(true)
  }

  // 3. Actions: Execute parallel reactions
  parallel {
    // Broadcast warning to household speakers
    action(speaker, SpeakerDeviceType.self) {
      Google.AssistantBroadcastTrait.broadcast(msg: "The refrigerator door has been left open!")
    }

    // Push a notification alerts to home members' mobile devices
    action(structure) {
      Google.NotificationTrait.sendNotifications(
        title: "Fridge Alert",
        body: "The refrigerator door has been open for over 2 min.",
        optInMemberEmailsArray: ["222larabrown@gmail.com"]
      )
    }
  }
}

Contoh berikut mengalihkan lemari es ke mode Energi Rendah saat mendeteksi tidak ada orang di rumah.

import GoogleHomeSDK
import GoogleHomeTypes

typealias AreaPresenceStateTrait = Google.AreaPresenceStateTrait
typealias RefrigeratorAndTemperatureControlledCabinetModeTrait = Matter.RefrigeratorAndTemperatureControlledCabinetModeTrait

let structure = home.structures().list().first()

// Fetch devices using the multipart device model.
let devices = try await self.home.devices(enableMultipartDevices: true).list()

// Obtain a reference to the refrigerator device.
guard let refrigeratorDevice = multipartDevices.first {
    $0.types.contains(TemperatureControlledCabinetDeviceType.self) &&
    $0.traits.contains(Matter.RefrigeratorAndTemperatureControlledCabinetModeTrait.self) &&
    $0.traits.contains(Matter.RefrigeratorAlarmTrait.self)
  }

let refrigeratorDeviceType = await refrigeratorDevice.parts.get(RefrigeratorDeviceType.self)

// Get all temperature-controlled cabinet parts of the refrigerator
let cabinets = refrigeratorDeviceType.parts(type: TemperatureControlledCabinetDeviceType.self)

// Find the cabinet part with the 'refrigerator' semantic tag
let refrigeratorCabinet = cabinets.first {
  $0.metadata.tags.contains(SemanticTag.Refrigerator.refrigerator)
}

let cabinetPartPath = refrigeratorDevice.automationPart(refrigeratorCabinet)

let refrigeratorEcoMode = automation(
  name: "Refrigerator Eco Mode",
  description: "Automatically changes refrigerator to low energy mode when house is vacant."
) {
  // 1. Starter: Monitor household presence changes
  let presenceStarter = starter(structure, AreaPresenceStateTrait.self)

  presenceStarter

  // 2. Condition: Verify presence state transitions to vacant
  condition {
    presenceStarter.presenceState.equals(.presenceStateVacant)
  }
  // 3. Action: Set refrigerator cabinet Mode to 'Low Energy' (commonly option index 1)
  action(cabinetPartPath) {
    RefrigeratorAndTemperatureControlledCabinetModeTrait.changeToMode(newMode: 1)
  }
}
Sebelumnya
Membuat otomatisasi
Berikutnya
Contoh otomatisasi