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 qu'il utilise le même ID sur Matter que 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. Cloud-to-cloud appareils ne peuvent être dédupliqués que lorsqu'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 dans le Home Graph, le cloud du partenaire doit envoyer trois nouveaux champs de chaîne pour chaque appareil dans la SYNC réponse à 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, du cluster d'informations de base.
2. matterOriginalVendorId : attribut VendorId, au format chaîne hexadécimale, du cluster d'informations de base.
3. matterOriginalProductId : attribut ProductId, au format chaîne hexadécimale, du cluster d'informations de base.
4. roomHint : pièce dans laquelle se trouve cet appareil.

Pour en savoir plus sur les intents tels que SYNC , consultez le guide d'introduction au cloud à cloud.

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

{
  "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 de le cloud d'un partenaire est converti en un 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 sont 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 appareil entièrement nouveau pour toutes les intégrations.

Association automatique de structure

Il n'est pas garanti que les appareils Cloud-to-cloud soient automatiquement associés à une structure spécifique. Lorsque l'association automatique de structure n'est pas possible, les appareils Cloud-to-cloud concernés s'affichent dans une section dédiée de l' GHAécran principal, 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 automatiquement placés dans une structure lorsque l'utilisateur en possède plusieurs structures (maisons) dans le 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 qui n'a pas pu être associé automatiquement à une structure, la déduplication peut avoir lieu lors de la prochaine SYNC, à condition que les réponses SYNC soient conformes aux exigences indiquées dans Conditions requises pour SYNC.