Panduan Tempat Tidur Smart Home

action.devices.types.BED - Interaksi dengan tempat tidur mungkin termasuk menyesuaikan berbagai mode dan suasana latar.

Jenis ini menunjukkan bahwa perangkat mendapatkan ikon Tempat Tidur 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.

Trait ini direkomendasikan, jika berlaku untuk perangkat Anda. Namun, Anda bebas memadupadankan fungsi dari semua karakteristik yang tersedia agar paling cocok dengan fungsi produk yang sudah ada.

Persyaratan kualitas

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

Contoh perangkat: Tempat tidur simpel

Bagian ini berisi contoh payload intent yang merepresentasikan "Bed" umum berdasarkan jenis dan ciri 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.BED",
        "traits": [
          "action.devices.traits.Modes"
        ],
        "name": {
          "name": "Simple bed"
        },
        "willReportState": true,
        "attributes": {
          "availableModes": [
            {
              "name": "massage_key",
              "name_values": [
                {
                  "name_synonym": [
                    "Massage"
                  ],
                  "lang": "en"
                }
              ],
              "settings": [
                {
                  "setting_name": "lumbar_key",
                  "setting_values": [
                    {
                      "setting_synonym": [
                        "Back",
                        "Middle"
                      ],
                      "lang": "en"
                    }
                  ]
                },
                {
                  "setting_name": "head_key",
                  "setting_values": [
                    {
                      "setting_synonym": [
                        "Head",
                        "Neck"
                      ],
                      "lang": "en"
                    }
                  ]
                }
              ],
              "ordered": true
            }
          ]
        },
        "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,
        "currentModeSettings": {
          "massage_key": "lumbar_key"
        }
      }
    }
  }
}

Contoh perintah EXECUTE

SetModes

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

Permintaan
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.SetModes",
                "params": {
                  "updateModeSettings": {
                    "massage_key": "head_key"
                  }
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Respons
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "currentModeSettings": {
            "massage_key": "head_key"
          }
        }
      }
    ]
  }
}

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.