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

Lors de la conversion d'un appareil qui utilise actuellement (Cloud-to-cloud) en Matter, vous devez vous assurer qu'il utilise sur Matter le même ID que celui qu'il utilise lorsqu'il est connecté à l'aide d'API autres que Matter. Cela garantit que l'appareil n'apparaît 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 particulière (maison) dans le Google Home app (GHA).

Conditions requises pour SYNC

Pour éviter l'apparition de doublons 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 l'appareil.

Vous trouverez de la documentation sur les intents tels que SYNC dans l'introduction Cloud-to-Cloud.

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

Réponse SYNC 
{
  "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 précédemment 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 être modifié que lors du rétablissement de la configuration d'usine, de sorte que l'appareil apparaît 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 associés automatiquement à une structure particulière. Si l'association automatique de la structure n'est pas possible, les appareils Cloud-to-cloud pertinents s'affichent dans une section dédiée de l'écran principal de GHA, dans une section intitulée Associés à votre compte, en dehors des pièces. Ces appareils ne seront pas dédupliqués. Les appareils ne sont pas automatiquement placés dans une structure lorsque l'utilisateur a plusieurs structures (accueil) dans le GHA. Les appareils peuvent ne pas être structurés pour d'autres raisons.

Si un utilisateur déplace manuellement un appareil Cloud-to-cloud dont l'association automatique de structure a échoué dans une structure, la déduplication peut avoir lieu lors du SYNC suivant, à condition que les réponses SYNC soient conformes aux exigences SYNC.