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 sur l'Google Home Graph de l'utilisateur. Les appareils Cloud-to-cloud ne peuvent être dédupliqués que lorsqu'ils sont associés à une structure (maison) particulière dans Google Home app (GHA).

Configuration requise pour SYNC

Pour éviter que des doublons n'apparaissent sur le 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 de 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 de chaîne hexadécimale, du cluster d'informations de base.
  3. matterOriginalProductId : attribut ProductId, au format de chaîne hexadécimale, du cluster d'informations de base.
  4. roomHint : pièce dans laquelle se trouve l'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 de 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 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'identifiant unique ne doit changer que lors d'un 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 structures

Il n'est pas garanti que les appareils Cloud-to-cloud soient automatiquement associés à une structure particulière. Dans les situations où l'association automatique de structures 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és à votre compte, 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 dispose de plusieurs structures (maisons) dans l'GHA. Il est possible que les appareils ne puissent pas être structurés pour d'autres raisons.

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