スマートホーム ケトル ガイド

デバイスタイプ

action.devices.types.KETTLE ケトルはお湯を沸かすデバイスです。ケトルの制御操作には、電源オン / オフ、目標温度の調整、さまざまなモード設定の調整などが含まれます。

このタイプは、ケトルアイコンとケトルタイプの同義語 / 別名がデバイスに与えられることを示します。

これらは、このタイプのデバイスに推奨されるトレイトですが、利用可能なすべてのトレイトの中から、既存の製品機能に最適な組み合わせを自由に選ぶことができます。

必須の属性、EXECUTE、QUERY などの実装の詳細については、個別のトレイトのドキュメントをご覧ください。

SYNC リクエストとレスポンスの例

これは上記のデバイスタイプとトレイトを使った例です。SYNC レスポンスの作成方法を理解するためのものです。トレイトを追加または削除した場合は、その変更を反映するように修正する必要があります。

リクエスト
{
    "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
    "inputs": [{
      "intent": "action.devices.SYNC"
    }]
}
Node.jsレスポンス
'use strict';

const {smarthome} = require('actions-on-google');
const functions = require('firebase-functions');

const app = smarthome();

app.onSync((body, headers) => {
  return {
    requestId: body.requestId,
    payload: {
      agentUserId: '1836.15267389',
      devices: [{
        id: '123',
        type: 'action.devices.types.KETTLE',
        traits: [
          'action.devices.traits.TemperatureControl',
          'action.devices.traits.OnOff'
        ],
        name: {
          defaultNames: ['AAA Smart Kettle'],
          name: 'Kettle',
          nicknames: ['tea kettle']
        },
        willReportState: true,
        attributes: {
          temperatureRange: {
            minThresholdCelsius: 0.0,
            maxThresholdCelsius: 100.00
          },
          temperatureUnitForUX: 'F'
        },
        deviceInfo: {
          manufacturer: 'Smart Kettle Manufacturers',
          model: 'F600G',
          hwVersion: '3.2',
          swVersion: '11.4'
        },
        customData: {
          fooValue: 74,
          barValue: true,
          bazValue: 'lambtwirl'
        }
      }]
    }
  };
});

// ...

exports.smarthome = functions.https.onRequest(app);
JSONレスポンス
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "agentUserId": "1836.15267389",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.KETTLE",
        "traits": [
          "action.devices.traits.TemperatureControl",
          "action.devices.traits.OnOff"
        ],
        "name": {
          "defaultNames": [
            "AAA Smart Kettle"
          ],
          "name": "Kettle",
          "nicknames": [
            "tea kettle"
          ]
        },
        "willReportState": true,
        "attributes": {
          "temperatureRange": {
            "minThresholdCelsius": 0,
            "maxThresholdCelsius": 100
          },
          "temperatureUnitForUX": "F"
        },
        "deviceInfo": {
          "manufacturer": "Smart Kettle Manufacturers",
          "model": "F600G",
          "hwVersion": "3.2",
          "swVersion": "11.4"
        },
        "customData": {
          "fooValue": 74,
          "barValue": true,
          "bazValue": "lambtwirl"
        }
      }
    ]
  }
}
検証ツール

デバイスエラー

エラーと例外の全リストをご覧ください。

デバイス文法

ケトルは action.devices.traits.OnOff のための型ベースの文法を持っています。デバイスが OnOff をサポートしている場合、「お湯を沸かして」action.devices.commands.OnOff コマンドが送信されます。