スマートホーム コンセント ガイド

デバイスタイプ

action.devices.types.OUTLET スマートホームの基本的なデバイスであるコンセントには、バイナリモードのオン / オフのみがあります。

action.devices.traits.OnOff

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

必須の属性、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.OUTLET',
        traits: [
          'action.devices.traits.OnOff'
        ],
        name: {
          defaultNames: ['AAA Outlet C110'],
          name: 'Homer Simple Outlet',
          nicknames: ['wall plug']
        },
        willReportState: false,
        deviceInfo: {
          manufacturer: 'AAA',
          model: 'c110',
          hwVersion: '3.2',
          swVersion: '11.4'
        },
        customData: {
          fooValue: 74,
          barValue: true,
          bazValue: 'sheepdip'
        }
      }]
    }
  };
});

// ...

exports.smarthome = functions.https.onRequest(app);
JSONレスポンス
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "agentUserId": "1836.15267389",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.OUTLET",
        "traits": [
          "action.devices.traits.OnOff"
        ],
        "name": {
          "defaultNames": [
            "AAA Outlet C110"
          ],
          "name": "Homer Simple Outlet",
          "nicknames": [
            "wall plug"
          ]
        },
        "willReportState": false,
        "deviceInfo": {
          "manufacturer": "AAA",
          "model": "c110",
          "hwVersion": "3.2",
          "swVersion": "11.4"
        },
        "customData": {
          "fooValue": 74,
          "barValue": true,
          "bazValue": "sheepdip"
        }
      }
    ]
  }
}
検証ツール

デバイスエラー

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