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.

Panduan Kulkas Smart Home

action.devices.types.REFRIGERATOR - Lemari es adalah perangkat untuk mengelola suhu yang mungkin memiliki berbagai mode/setelan.

Jenis ini menunjukkan bahwa perangkat mendapatkan ikon Kulkas serta beberapa sinonim dan alias yang terkait.

Kemampuan perangkat

Lihat dokumentasi ciri yang sesuai untuk mengetahui detail implementasi, seperti atribut dan status yang harus didukung oleh layanan Anda, serta cara membuat respons EXECUTE dan QUERY.

Sifat yang diperlukan

Sifat dan perintah ini diperlukan, jika berlaku untuk perangkat Anda.

Persyaratan kualitas

  • Latensi: harus kurang dari atau sama dengan 3000 md.
  • Keandalan: harus lebih dari atau sama dengan 97%.

Contoh perangkat: Lemari es sederhana

Bagian ini berisi contoh payload intent yang mewakili "Kulkas" umum berdasarkan jenis perangkat dan fitur di atas. Jika Anda menambahkan atau menghapus fitur dalam implementasi, ubah respons sebagaimana mestinya untuk mencerminkan perubahan tersebut.

Contoh respons SYNC

Permintaan
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
Respons
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.REFRIGERATOR",
        "traits": [
          "action.devices.traits.TemperatureControl"
        ],
        "name": {
          "name": "Simple refrigerator"
        },
        "willReportState": true,
        "attributes": {
          "temperatureRange": {
            "minThresholdCelsius": 0,
            "maxThresholdCelsius": 10
          },
          "temperatureUnitForUX": "C"
        },
        "deviceInfo": {
          "manufacturer": "smart-home-inc",
          "model": "hs1234",
          "hwVersion": "3.2",
          "swVersion": "11.4"
        }
      }
    ]
  }
}

Contoh respons QUERY

Permintaan
{
  "requestId": "6894439706274654514",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123"
          }
        ]
      }
    }
  ]
}
Respons
{
  "requestId": "6894439706274654514",
  "payload": {
    "devices": {
      "123": {
        "status": "SUCCESS",
        "online": true,
        "temperatureSetpointCelsius": 5,
        "temperatureAmbientCelsius": 7
      }
    }
  }
}

Contoh perintah EXECUTE

SetelSuhu

Untuk detail tambahan parameter perintah, lihat referensi action.devices.traits.TemperatureControl.

Permintaan
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.SetTemperature",
                "params": {
                  "temperature": 4
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Respons
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "temperatureSetpointCelsius": 4,
          "temperatureAmbientCelsius": 7
        }
      }
    ]
  }
}

KESALAHAN perangkat

Lihat daftar lengkap error dan pengecualian.