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 autres que Matter. Cela garantit que l'appareil ne s'affiche qu'une seule fois dans 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) spécifique dans Google Home app (GHA).

Configuration requise pour SYNC

Pour éviter que des doublons ne s'affichent 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 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 dans laquelle se trouve cet appareil.

Vous trouverez de la documentation sur les intents tels que SYNC dans le Introduction Cloud à 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 sont fournies pour un appareil donné. L'ID 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. Lorsque 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 la section intitulée Associé à vous, en dehors de toute pièce. Ces appareils ne seront pas dédupliqués. Les appareils ne sont pas automatiquement placés dans une structure lorsque l'utilisateur dispose de plusieurs structures (maisons) dans GHA. Les appareils peuvent ne pas être structurés pour d'autres raisons.

Si un utilisateur déplace manuellement un appareil Cloud-to-cloud pour lequel l'association automatique de structure a échoué vers une structure, 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 SYNC.