Selamat datang di Pusat Developer Google Home, tujuan baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Skema Fitur ColorTemperature Smart Home

action.devices.traits.ColorTemperature - Sifat ini dimiliki oleh semua perangkat yang dapat menyetel suhu warna.

Hal ini berlaku untuk bohlam "warmth" yang menggunakan titik warna di Kelvin. Ini umumnya modalitas terpisah dari ColorSpectrum, dan mungkin ada titik putih yang tersedia melalui Suhu yang tidak dapat dijangkau oleh Spectrum. Berdasarkan fitur yang tersedia, Google dapat memilih mode yang sesuai untuk digunakan berdasarkan permintaan dan jenis lampu (misalnya, Membuat lampu ruang keluarga berwarna putih dapat mengirimkan perintah Suhu ke beberapa bohlam dan perintah Spektrum ke strip LED).

ATRIBUT Perangkat

Atribut Definisi
temperatureMinK Opsional. Wajib jika temperatureMaxK ditetapkan. Suhu warna minimum yang didukung oleh cahaya, di Kelvin.
temperatureMaxK Opsional. Wajib jika temperatureMinK ditetapkan. Suhu warna maksimum yang didukung oleh cahaya, di Kelvin.

Contoh Permintaan dan Respons SYNC

Permintaan
{
    "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.LIGHT',
        traits: [
          'action.devices.traits.ColorTemperature'
        ],
        name: {
          defaultNames: ['AAA bulb A19 color hyperglow'],
          name: 'lamp1',
          nicknames: ['reading lamp']
        },
        willReportState: true,
        attributes: {
          temperatureMinK: 2000,
          temperatureMaxK: 6500
        },
        deviceInfo: {
          manufacturer: 'AAA',
          model: 'hg11',
          hwVersion: '1.2',
          swVersion: '5.4'
        },
        customData: {
          fooValue: 12,
          barValue: false,
          bazValue: 'dancing alpaca'
        }
      }]
    }
  };
});

// ...

exports.smarthome = functions.https.onRequest(app);
JSON
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "agentUserId": "1836.15267389",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.LIGHT",
        "traits": [
          "action.devices.traits.ColorTemperature"
        ],
        "name": {
          "defaultNames": [
            "AAA bulb A19 color hyperglow"
          ],
          "name": "lamp1",
          "nicknames": [
            "reading lamp"
          ]
        },
        "willReportState": true,
        "attributes": {
          "temperatureMinK": 2000,
          "temperatureMaxK": 6500
        },
        "deviceInfo": {
          "manufacturer": "AAA",
          "model": "hg11",
          "hwVersion": "1.2",
          "swVersion": "5.4"
        },
        "customData": {
          "fooValue": 12,
          "barValue": false,
          "bazValue": "dancing alpaca"
        }
      }
    ]
  }
}
Validator

STATUS Perangkat

Negara bagian Definisi
color Objek. Setelan warna saat ini. Karena cahaya tertentu berada dalam spektrum ATAU mode suhu, objek ini menyertakan setelan warna saat ini dalam mode yang relevan.
  • String name. Jika titik warna (Spektrum atau Suhu) cocok dengan nama yang telah ditetapkan di daftar warna partner, tampilkan nama tersebut.
  • Bilangan bulat temperature. Suhu warna di Kelvin.

Contoh Permintaan dan Respons QUERY

Berapa suhu warna terang saya saat ini?
Permintaan
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [{
    "intent": 'action.devices.QUERY',
    "payload": {
      "devices": [{
        "id": "123",
        "customData": {
          "fooValue": 74,
          "barValue": true,
          "bazValue": "foo"
        }
      }]
    }
  }]
}
Node.js
'use strict';

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

const app = smarthome();

app.onQuery((body, headers) => {
  return {
    requestId: body.requestId,
    payload: {
      devices: {
        123: {
          online: true,
          color: {
            name: 'warm white',
            temperature: 25000
          },
          status: 'SUCCESS'
        }
      }
    }
  };
});

// ...

exports.smarthome = functions.https.onRequest(app);
JSON
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "devices": {
      "123": {
        "online": true,
        "color": {
          "name": "warm white",
          "temperature": 25000
        },
        "status": "SUCCESS"
      }
    }
  }
}

COMMAND Perangkat

Perintah Parameter/Definisi
action.devices.commands.ColorAbsolute Objek color. Wajib diisi. Akan menyertakan RGB atau Suhu dan secara opsional, nama.
  • String name. Nama warna (dalam bahasa Inggris) seperti yang diberikan dalam perintah pengguna. Tidak selalu tersedia (untuk perintah relatif).
  • Bilangan bulat temperature. Suhu warna di Kelvin.

Contoh Permintaan dan Respons EXECUTE

Sesuaikan cahaya saya ke putih lembut.
Permintaan
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [{
    "intent": "action.devices.EXECUTE",
    "payload": {
      "commands": [{
        "devices": [{
          "id": "123",
          "customData": {
            "fooValue": 74,
            "barValue": true,
            "bazValue": "sheepdip"
          }
        }],
        "execution": [{
          "command": "action.devices.commands.ColorAbsolute",
          "params": {
              "color": {
                "name": "soft white",
                "temperature": 2700
              }
          }
        }]
      }]
    }
  }]
}
Node.js
'use strict';

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

const app = smarthome();

app.onExecute((body, headers) => {
  return {
    requestId: body.requestId,
    payload: {
      commands: [{
        ids: ['123'],
        status: 'SUCCESS',
        states: {
          color: {
            name: 'soft white',
            temperature: 2700
          }
        }
      }]
    }
  };
});

// ...

exports.smarthome = functions.https.onRequest(app);
JSON
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "color": {
            "name": "soft white",
            "temperature": 2700
          }
        }
      }
    ]
  }
}