Akıllı Ev için Davlumbaz Kılavuzu
action.devices.types.HOOD - Fırın ve aralık dalgıçları açılabilir ve kapatılabilir, ayarlanabilir modlara sahip olabilir ve ayarlanabilir fan hızlarına sahip olabilir.
Bu tür, cihazın Hood simgesinin yanı sıra bazı alakalı eş anlamlıları ve takma adları aldığını gösterir.
Cihaz özellikleri
Hizmetinizin desteklemesi gereken özellikler ve durumlar, ayrıca 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.
Zorunlu ö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. Ancak mevcut ürün işlevlerinizle en iyi eşleşmeyi sağlamak için mevcut tüm özelliklerle karıştırabilir ve eşleştirebilirsiniz.
Kalite gereksinimleri
- Gecikme: 3.000 ms'den küçük veya buna eşit olmalıdır.
- Güvenilirlik: %97'den fazla veya bu değere eşit olmalıdır.
Örnek cihaz: Basit kapüşonlu
Bu bölümde, cihaz türüne ve yukarıdaki özelliklere dayalı olarak ortak bir "Davut"u temsil eden amaç yükü örnekleri yer alır. Uygulamanıza özellikler ekler veya mevcut özellikleri kaldırırsanız yanıtlarınızı bu değişiklikleri yansıtacak ş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.HOOD",
"traits": [
"action.devices.traits.FanSpeed",
"action.devices.traits.OnOff"
],
"name": {
"name": "Simple hood"
},
"willReportState": true,
"attributes": {
"availableFanSpeeds": {
"speeds": [
{
"speed_name": "low_key",
"speed_values": [
{
"speed_synonym": [
"low",
"slow"
],
"lang": "en"
}
]
},
{
"speed_name": "high_key",
"speed_values": [
{
"speed_synonym": [
"high"
],
"lang": "en"
}
]
}
],
"ordered": 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,
"on": false,
"currentFanSpeedSetting": "low_key"
}
}
}
}
Örnek EXECUTE komutları
Hızı ayarla
Komut parametreleri hakkında daha fazla bilgi için action.devices.traits.FanSpeed referansına bakın.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.SetFanSpeed",
"params": {
"fanSpeed": "high_key"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentFanSpeedSetting": "high_key"
}
}
]
}
}
Devre Dışı
Komut parametreleri hakkında daha fazla bilgi için action.devices.traits.OnOff referansına bakın.
{
"requestId": "6894439706274654518",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.OnOff",
"params": {
"on": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654518",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"on": true
}
}
]
}
}