Akıllı Ev Süpürge Kılavuzu
action.devices.types.VACUUM - Elektrikli süpürgeler temizlik işlemini başlatma, durdurma ve duraklatma, yuvaya yerleştirme, mevcut temizleme döngüsünü kontrol etme, elektrik süpürgesini bulma veya çeşitli modları ayarlama gibi işlevlere sahip olabilir. Bazı elektrik süpürgeleri evdeki belirli bölgeleri temizlemeyi destekleyebilir.
Bu tür, cihazda elektrikli süpürge simgesinin yanı sıra ilgili bazı eş anlamlılar ve takma adların alındığını gösterir.
Cihaz özellikleri
Hizmetinizin desteklemesi gereken özellikler ve durumlar, EXECUTE ve QUERY yanıtlarının nasıl oluşturulacağı gibi uygulama ayrıntıları için ilgili özellik dokümanlarına bakın.
Gerekli özellikler
Cihazınız için geçerliyse bu özellikler ve komutlar gerekir.
Önerilen özellikler
Cihazınız için geçerliyse bu özellikler önerilir. Bununla birlikte, mevcut ürün işlevlerinizle en iyi şekilde eşleşmesi için mevcut tüm özelliklerle karıştırıp eşleştirebilirsiniz.
-
action.devices.traits.Dock -
action.devices.traits.EnergyStorage -
action.devices.traits.Locator -
action.devices.traits.OnOff -
action.devices.traits.RunCycle
Kalite gereksinimleri
- Gecikme: 800 ms'den az veya bu değere eşit olmalıdır.
- Güvenilirlik: %97'den fazla veya bu değere eşit olmalıdır.
Örnek cihaz: Sade elektrik süpürgesi
Bu bölümde, cihaz türüne ve yukarıdaki özelliklere göre ortak bir "Elektrikli Süpürge"yi temsil eden örnek yük yükleri yer almaktadır. Uygulamanıza özellik ekler veya mevcut özellikleri kaldırırsanız bu değişiklikleri yansıtacak şekilde yanıtlarınızı uygun şekilde değiştirin.
Örnek SYNC yanıtı
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.VACUUM",
"traits": [
"action.devices.traits.Dock",
"action.devices.traits.EnergyStorage",
"action.devices.traits.StartStop"
],
"name": {
"name": "Simple vacuum"
},
"willReportState": true,
"attributes": {
"queryOnlyEnergyStorage": true,
"pausable": true
},
"deviceInfo": {
"manufacturer": "smart-home-inc",
"model": "hs1234",
"hwVersion": "3.2",
"swVersion": "11.4"
}
}
]
}
}
Örnek QUERY yanıtı
{
"requestId": "6894439706274654514",
"inputs": [
{
"intent": "action.devices.QUERY",
"payload": {
"devices": [
{
"id": "123"
}
]
}
}
]
}
{
"requestId": "6894439706274654514",
"payload": {
"devices": {
"123": {
"status": "SUCCESS",
"online": true,
"isRunning": false,
"isPaused": false,
"isDocked": true,
"descriptiveCapacityRemaining": "HIGH",
"capacityRemaining": [
{
"unit": "SECONDS",
"rawValue": 36000
},
{
"unit": "PERCENTAGE",
"rawValue": 90
}
]
}
}
}
}
Örnek EXECUTE komutları
Yuvaya yerleştir
Komut parametreleri hakkında ek ayrıntılar için
action.devices.traits.Dock referansına bakın.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.Dock"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"isDocked": true
}
}
]
}
}
Başlat
Komut parametreleri hakkında ek ayrıntılar için
action.devices.traits.StartStop referansına bakın.
{
"requestId": "6894439706274654518",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.StartStop",
"params": {
"start": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654518",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"isRunning": true,
"isPaused": false
}
}
]
}
}