Déduplication d'appareils d'un cloud à un autre et Matter

Lorsque vous convertissez un appareil qui utilise actuellement (Cloud-to-cloud) en Matter, vous devez vous assurer que l'appareil utilise le même ID sur Matter que celui qu'il utilise lorsqu'il est connecté à l'aide des API non-Matter. Cela permet de s'assurer que l'appareil ne s'affiche qu'une seule fois dans le Google Home Graph de l'utilisateur. Les appareils Cloud-to-cloud ne peuvent être dédupliqués que s'ils sont associés à une structure (maison) spécifique dans Google Home app (GHA).

Conditions requises pour SYNC

Pour éviter que des doublons n'apparaissent sur Home Graph, le cloud du partenaire doit envoyer trois nouveaux champs de chaîne pour chaque appareil dans la réponse SYNC à Google. Ces champs doivent correspondre aux attributs définis dans le cluster d'informations de base pour l'appareil Matter. De plus, les réponses SYNC doivent contenir roomHint :

  1. matterUniqueId : attribut UniqueId au format chaîne.
  2. matterOriginalVendorId : attribut VendorId, au format de chaîne hexadécimale.
  3. matterOriginalProductId : attribut ProductId, au format de chaîne hexadécimale.
  4. roomHint : pièce où se trouve cet appareil.

La documentation sur les intents tels que SYNC est disponible dans la présentation de Cloud-to-Cloud.

L'exemple de réponse SYNC ci-dessous montre l'utilisation des trois nouveaux champs ainsi que roomHint :

SYNC Réponse 
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "agentUserId": "1836.15267389",
    "devices": [
      {
        "id": "456",
        "type": "action.devices.types.LIGHT",
        "traits": [
          "action.devices.traits.OnOff",
          "action.devices.traits.Brightness",
          "action.devices.traits.ColorSetting",
        ],
        "willReportState": true,
        "roomHint": "office",
        "deviceInfo": { ... },
        "matterUniqueId": "00112233aabbccddeeff",
        "matterOriginalVendorId": "0xfff1",
        "matterOriginalProductId": "0x1234",
        "otherDeviceIds": [
          {
            "deviceId": "local-device-id",
          }
        ]
      }
    ]
  }
}

Lorsqu'un appareil qui fonctionnait auparavant sur le réseau domestique d'un utilisateur à l'aide du cloud d'un partenaire est converti en appareil Matter, le cloud du partenaire doit immédiatement envoyer un REQUEST SYNC à Google pour mettre à jour ces champs le plus rapidement possible afin d'éviter une déduplication tardive.

Ces chaînes ne doivent jamais changer une fois qu'elles ont été fournies pour un appareil donné. L'ID unique ne doit changer qu'en cas de rétablissement de la configuration d'usine, ce qui fait apparaître l'appareil comme un tout nouvel appareil pour toutes les intégrations.

Association automatique de la structure

Il n'est pas garanti que les appareils Cloud-to-cloud soient automatiquement associés à une structure particulière. Dans les cas où l'association automatique de la structure n'est pas possible, les appareils Cloud-to-cloud concernés s'affichent dans une section dédiée de l'écran principal de GHA, sous une section intitulée Associé à vous, en dehors de toute pièce. Ces appareils ne seront pas dédupliqués. Les appareils ne seront pas placés automatiquement dans une structure lorsque l'utilisateur possède plusieurs structures (maisons) dans GHA. Il est possible que les appareils ne soient pas structurés pour d'autres raisons.

Si un utilisateur déplace manuellement un appareil Cloud-to-cloud pour lequel l'association automatique à une structure a échoué, la déduplication peut avoir lieu lors de la prochaine SYNC, à condition que les réponses SYNC respectent les exigences indiquées dans les exigences de synchronisation.