如何实现Google Home应用中温控器状态的实时刷新？

问题核心 #

你开发的Google Home温控器应用中，设备列表能每30秒刷新数值，但单个温控器界面无法自动更新——这是因为Google Home单设备界面不会主动定时发起QUERY请求，仅依赖被动查询无法触发实时刷新，必须通过主动推送设备状态来同步最新数值。

解决方案：使用Report State API主动推送状态 #

Google Home的HomeGraph API提供了Report State接口，允许你的服务主动将设备最新状态推送给Google Home平台，从而触发客户端界面自动刷新。

1. 前置准备

• 在Google Cloud Console中启用HomeGraph API，并创建具有HomeGraph API权限的服务账号，下载JSON密钥文件。
• 确保你的服务已完成Google Home的设备关联（用户已授权）。

2. 添加状态推送逻辑

在现有代码基础上，新增主动推送状态的功能，示例代码（Node.js）：

const { google } = require('googleapis');
const homegraph = google.homegraph('v1');

// 初始化服务账号认证
const auth = new google.auth.GoogleAuth({
  keyFile: '你的服务账号密钥.json',
  scopes: ['https://www.googleapis.com/auth/homegraph'],
});

// 推送设备状态到Google Home
async function pushThermostatState(agentUserId, deviceId, latestData) {
  try {
    await homegraph.devices.reportStateAndNotification({
      auth: auth,
      requestBody: {
        agentUserId: agentUserId,
        payload: {
          devices: {
            states: {
              [deviceId]: {
                temperatureAmbientCelsius: latestData.ambientTemp,
                temperatureSetpointCelsius: latestData.setpointTemp,
                // 根据你的温控器类型添加其他属性，比如thermostatMode等
              }
            }
          }
        }
      }
    });
  } catch (err) {
    console.error('状态推送失败:', err);
  }
}

// 结合你的定时获取逻辑，每30秒获取并推送
setInterval(async () => {
  // 替换为你获取单个温控器最新数值的逻辑
  const latestTempData = await fetchLatestThermostatData('设备ID');
  // 推送状态，agentUserId为用户唯一标识
  await pushThermostatState('用户UID', '设备ID', latestTempData);
}, 30000);

3. 关键说明

• SYNC指令仅用于同步设备的基本信息（如设备类型、支持的属性），不负责状态更新；
• QUERY指令是Google Home平台主动发起的状态查询，但单设备界面不会定时触发该请求，仅在用户首次打开界面或手动刷新时可能调用；
• 主动推送状态后，Google Home平台会自动同步到所有关联的客户端界面，包括单个温控器页面。

内容的提问来源于stack exchange，提问作者홍길동