通过Sync消息更新HomeGraph设备名不生效如何解决

核心原因 #

你只在Google主动发来SYNC请求时返回新名称，不会触发设备信息自动刷新。Google不会实时轮询你的fulfillment接口拉取设备变更，必须由你方主动发起同步通知，Google才会来拉取最新设备数据，否则就算重启App也会读本地缓存的旧数据。

正确操作步骤 #

• 主动触发同步请求
  自有系统修改完设备昵称后，立即调用HomeGraph的RequestSyncDevices接口，传入对应用户的agentUserId，通知Google侧立刻拉取最新的全量设备列表。Google默认轮询周期长达数天，未主动触发的情况下就算重启App也不会获取到最新设备信息。
• 修正SYNC响应的错误点
  你当前返回的SYNC数据存在几个会导致同步失效的问题：
  1. 必须返回该用户下所有绑定的全量设备列表，不能仅返回修改了名称的单个设备，部分设备返回的请求会被判定为无效同步，直接丢弃变更内容。
  2. 不要传空的deviceInfo对象，至少补充manufacturer、model字段，空对象会被判定为无效设备数据，导致同步不生效。
  3. 确认返回的设备id字段和历史同步的id完全一致，如果id发生变化，Google会识别为新设备，原有旧设备会保留在列表中显示旧名称。
• 特殊场景说明

  如果用户曾经在Google Home App中手动修改过该设备的名称，Google侧会优先保留用户自定义的名称，优先级高于你通过SYNC返回的名称，这类场景无法通过接口同步覆盖，需要引导用户手动在App内修改，或者将设备解绑后重新绑定才会重置名称优先级。

验证方式 #

触发RequestSyncDevices后等待10-30秒，直接下拉Google Home App的设备列表页手动刷新即可，不需要重启App。

正确的name字段结构参考 #

"name": {
  "defaultNames": ["light"],
  "name": devices[j]['nickName'], // App主显示名称，传最新昵称
  "nicknames": [devices[j]['nickName']] // 语音识别匹配用别名
}

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