إضافة أجهزة Matter جديدة إلى منزل

تستخدِم واجهات برمجة التطبيقات Home لنظام التشغيل iOS مركزًا Matter لتفعيل جهاز على شبكة. أثناء عملية الإعداد، يرسل التطبيق أمرًا إلى حزمة تطوير البرامج (SDK)، ثم إلى الجهاز المحوِّر.

لتشغيل جهاز Matter، اتّبِع الخطوات التالية:

إرسال إشعار إلى Home APIs iOS SDK للاستعداد لتلقّي طلبات Matter باستخدام structure.prepareForMatterCommissioning() سيؤدي هذا الأمر إلى ما يلي:
- تأكَّد من منح الإذن.
- تأكَّد من أنّ الجهاز المركزي متصل بالإنترنت ويمكن الوصول إليه.
- تأكَّد من عدم وجود جلسة إعداد نشطة أخرى قيد التقدّم.
```
do {
  try await structure.prepareForMatterCommissioning()
} catch {
  // Failed to prepare for Matter Commissioning
  return
}
```

أنشئ طلبًا باستخدام MatterAddDeviceRequest() لبدء مسار الدعم في Matter من Apple.

let topology = MatterAddDeviceRequest.Topology(
  ecosystemName: "Google Home",
  homes: [MatterAddDeviceRequest.Home(displayName: structure.name)]
)

let request = MatterAddDeviceRequest(topology: topology)

نفِّذ الطلب باستخدام perform(). في حال حدوث خطأ، عليك إلغاء طلب التفويض باستخدام structure.cancelMatterCommissioning().

do {
  // Starting MatterAddDeviceRequest.
  try await request.perform()
  // Successfully completed MatterAddDeviceRequest.
  let commissionedDeviceIDs = try structure.completeMatterCommissioning()
  // Commissioned device IDs.
} catch let error {
  structure.cancelMatterCommissioning()
  // Failed to complete MatterAddDeviceRequest.
}

أنشئ App Group ID في Apple Developer Console للسماح للتطبيق بالتواصل مع إضافة MatterAddDevice عند إعداد الجهاز.

عليك أيضًا تعديل معرّف حزمة التطبيق وملفات التعريف المؤقتة لاستخدام معرّف المجموعة هذا.

عند بدء التشغيل، اضبط مثيل Home لاستخدام معرّف المجموعة.

func application(_ application: UIApplication, didFinishLaunchingWithOptions
launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
  Home.configure {
    $0.sharedAppGroup = "group.com.sample.app.commissioning"
  }

  return true
}

نفِّذ إضافة تطبيق Matter على iOS من Apple.

يعرض الرمز النموذجي مثالاً على تنفيذ فئة فرعية من واجهة برمجة التطبيقات MatterAddDeviceExtensionRequestHandler من Apple.

كحدّ أدنى، أضِف إطار عمل GoogleHomeMatterCommissionerSDK إلى هدف الإضافة وألغِ ثلاث طرق لاستدعاء واجهات برمجة التطبيقات Google Home platformHomeMatterCommissioner.

commissionDevice
rooms
configureDevice

import MatterSupport
import GoogleHomeSDK
import OSLog

final class RequestHandler: MatterAddDeviceExtensionRequestHandler {
  // The App Group ID defined by the application to share information between the extension and main app.
  private static var appGroup = "group.com.sample.app.commissioning"

  ...

  // MARK: - Home API commissioning handlers

  /// Commissions a device to the Google Home ecosystem.
  /// - Parameters:
  ///   - home: The home that the device will be added to
  ///   - onboardingPayload: The payload to be sent to the Matter Commissioning SDK to commission the device.
  ///   - commissioningID: An identifier not used by the Home API SDK.
  override func commissionDevice(in home: MatterAddDeviceRequest.Home?, onboardingPayload: String, commissioningID: UUID) async throws {
    // Commission Matter device with payload.

    var onboardingPayloadForHub = onboardingPayload
    let homeMatterCommissioner = try HomeMatterCommissioner(appGroup: RequestHandler.appGroup)
    try await homeMatterCommissioner.commissionMatterDevice(
    onboardingPayload: onboardingPayloadForHub)
  }

  /// Obtains rooms from the Home Ecosystem to present to the user during the commissioning flow.
  /// - Parameter home: The home that the device will be added to.
  /// - Returns: A list of rooms if obtained from the Google Home ecosystem or an empty list if there was an error in getting them.
  override func rooms(in home: MatterAddDeviceRequest.Home?) async -> [MatterAddDeviceRequest.Room] {
    do {
      let homeMatterCommissioner = try HomeMatterCommissioner(appGroup: RequestHandler.appGroup)
      let fetchedRooms = try homeMatterCommissioner.fetchRooms()
      // Returning fetched rooms.
      return fetchedRooms
    } catch {
      // Failed to fetch rooms with error
      return []
    }
  }

  /// Pushes the device's configurations to the Google Home Ecosystem.
  /// - Parameters:
  ///   - name: The friendly name the user chose to set on the device.
  ///   - room: The room identifier that the user chose to put the device in.
  override func configureDevice(named name: String, in room: MatterAddDeviceRequest.Room?) async {
    // Configure Device name: room
    do {
      let homeMatterCommissioner = try HomeMatterCommissioner(appGroup: RequestHandler.appGroup)
      await homeMatterCommissioner.configureMatterDevice(
        deviceName: name, roomName: room?.displayName)
    } catch {
      // Configure Device failed with error
    }
  }
}

إضافة أجهزة Matter جديدة إلى منزل تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

إضافة أجهزة Matter جديدة إلى منزل