多设备Local Fulfilment下Google Home Action设备识别异常咨询

核心结论：绝对不允许多台设备使用相同的deviceId #

deviceId是Google Home云端设备的唯一标识符，Google Home会以此区分不同设备。如果多台设备共用同一个deviceId，云端会将它们识别为同一台设备，导致App只显示一个条目，操作时会随机匹配到物理设备，出现你遇到的混乱情况。

正确实现方式 #

1. 云端SYNC响应修改 #

为每台物理设备分配唯一的云端deviceId，并在otherDeviceIds中填入对应设备的本地唯一标识（比如设备的MAC地址、出厂UUID等，需和mDNS检测到的设备标识一致）：

// 第一台设备
response.payload.devices.push({
    id: "elgato-device-1", // 唯一云端ID
    name: {
      name: "Elgato Light 1", // 可区分的设备名称
    },
    "otherDeviceIds": [{
      "deviceId": "local-elgato-abc123" // 对应第一台设备的本地唯一标识
    }],
    // 补充设备类型、traits等必填属性
    type: "action.devices.types.LIGHT",
    traits: ["action.devices.traits.OnOff"],
    // 可选：添加customData存储本地标识，方便本地逻辑关联
    customData: {
        localDeviceId: "local-elgato-abc123"
    }
});

// 第二台设备
response.payload.devices.push({
    id: "elgato-device-2", // 另一唯一云端ID
    name: {
      name: "Elgato Light 2",
    },
    "otherDeviceIds": [{
      "deviceId": "local-elgato-def456" // 对应第二台设备的本地唯一标识
    }],
    type: "action.devices.types.LIGHT",
    traits: ["action.devices.traits.OnOff"],
    customData: {
        localDeviceId: "local-elgato-def456"
    }
});

2. 本地onIdentify逻辑修改 #

不能硬编码verificationId，需要根据当前请求关联的云端设备，返回对应物理设备的本地唯一标识（需和云端otherDeviceIds中的值完全匹配）：

// 假设localDevices是通过mDNS检测到的本地设备数组，结构示例：
// const localDevices = [
//   { cloudId: "elgato-device-1", localId: "local-elgato-abc123", ip: "192.168.1.101" },
//   { cloudId: "elgato-device-2", localId: "local-elgato-def456", ip: "192.168.1.102" }
// ]

.onIdentify((request) => {
    const cloudDevice = request.inputs[0].payload.device;
    // 根据云端设备ID或customData匹配本地设备
    const matchedLocalDevice = localDevices.find(dev => 
        dev.cloudId === cloudDevice.id || dev.localId === cloudDevice.customData?.localDeviceId
    );

    return Promise.resolve({
        intent: smarthome.Intents.IDENTIFY,
        requestId: request.requestId,
        payload: {
            device: {
                id: cloudDevice.id,
                verificationId: matchedLocalDevice?.localId || ""
            },
        },
    });
})

关键注意事项 #

• 本地设备的唯一标识必须稳定不变，优先使用MAC地址、设备出厂UUID，避免用动态IP地址，防止设备重启后IP变化导致识别失败。
• 云端deviceId必须全局唯一，即使是同型号设备也不能重复。
• 修改后重新执行SYNC操作，Google Home App会显示两台独立设备，操作时会精准对应到各自的物理设备。

内容的提问来源于stack exchange，提问作者user4240580