Panduan Pengisi Daya Smart Home

action.devices.types.CHARGER - Interaksi dengan pengisi daya dapat mencakup memulai dan menghentikan pengisian daya, serta memeriksa tingkat pengisian daya saat ini, kapasitas yang tersisa, dan kapasitas hingga nilai penuh.

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

Kemampuan perangkat

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

Trait yang diperlukan

Sifat dan perintah ini diperlukan, jika berlaku untuk perangkat Anda. Jika perangkat Anda tidak mendukung karakteristik ini, masukkan kode error functionNotSupported dalam respons QUERY atau EXECUTE. Lihat Error dan pengecualian untuk info selengkapnya.

Persyaratan kualitas

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

Contoh perangkat: Pengisi daya sederhana

Bagian ini berisi contoh payload intent yang merepresentasikan "Pengisi daya" umum berdasarkan jenis dan karakteristik perangkat di atas. Jika Anda menambahkan atau menghapus karakteristik dalam implementasi, ubah respons yang sesuai 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.CHARGER",
        "traits": [
          "action.devices.traits.EnergyStorage"
        ],
        "name": {
          "name": "Simple charger"
        },
        "willReportState": true,
        "attributes": {
          "isRechargeable": true,
          "queryOnlyEnergyStorage": false
        },
        "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,
        "descriptiveCapacityRemaining": "MEDIUM",
        "capacityRemaining": [
          {
            "unit": "PERCENTAGE",
            "rawValue": 50
          }
        ],
        "capacityUntilFull": [
          {
            "unit": "SECONDS",
            "rawValue": 3600
          }
        ],
        "isCharging": true
      }
    }
  }
}

Contoh perintah EXECUTE

Pengisian Daya

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

Permintaan
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.Charge",
                "params": {
                  "charge": false
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Respons
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "capacityRemaining": [
            {
              "unit": "PERCENTAGE",
              "rawValue": 50
            }
          ],
          "isCharging": false
        }
      }
    ]
  }
}

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.