Akıllı Ev Fırını Kılavuzu
action.devices.types.OVEN: Fırınlarla etkileşim, belirli sıcaklıklarda pişirme veya ızgarada pişirmeyi kapsar. Fırının içi ısındığı için içindeki fiziksel sıcaklık da değişiklik gösterdiği için bu değer de izlenebilir. Fırın, pişirme süresini sınırlandıran bir pişirme süresine sahip.
Bu tür, cihazın Fırın simgesinin yanı sıra bazı eş anlamlı kelimeleri ve takma adları aldığını belirtir.
Fırınlar,action.devices.traits.OnOff ve action.devices.traits.TemperatureControl için tür tabanlı dil bilgisine sahiptir:
- Cihaz
OnOffözelliğini destekliyorsa Fırını ön ısıtma biraction.devices.commands.OnOffkomutu gönderir. - Cihaz
TemperatureControlözelliğini destekliyorsa Fırını 350 dereceye önceden ısıt özelliği, fırını istediğiniz sıcaklığa ayarlamak için bir komut gönderir.
Cihaz özellikleri
Hizmetinizin desteklemesi gereken özellikler ve durumlar ile EXECUTE ve QUERY yanıtlarının nasıl oluşturulacağı gibi uygulama ayrıntıları için ilgili özellik belgelerine bakın.
Gerekli özellikler
Bu özellikler ve komutlar, cihazınız için geçerliyse gereklidir. Cihazınız bu özellikleri desteklemiyorsa bir QUERY veya EXECUTE yanıtına functionNotSupported hata kodunu girin. Daha fazla bilgi için Hatalar ve istisnalar bölümüne bakın.
Önerilen özellikler
Cihazınız için geçerliyse bu özellikler önerilir. Bununla birlikte, mevcut ürün işlevselliğinize en iyi şekilde uyması için mevcut tüm özellikleri bir arada kullanabilirsiniz.
Kalite gereksinimleri
- Gecikme: En fazla 3000 ms olmalıdır.
- Güvenilirlik: En az %97 olmalıdır.
Örnek cihaz: Basit fırın
Bu bölümde, cihaz türüne ve yukarıdaki özelliklere göre ortak bir "Fırın"ı temsil eden örnek amaç yükleri yer alır. Uygulamanızda özellik ekler veya kaldırırsanız yanıtlarınızı bu değişiklikleri yansıtacak şekilde değiştirin.
Örnek Senkronizasyon yanıtı
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.OVEN",
"traits": [
"action.devices.traits.Cook",
"action.devices.traits.OnOff",
"action.devices.traits.TemperatureControl",
"action.devices.traits.Timer",
"action.devices.traits.StartStop"
],
"name": {
"name": "Simple oven"
},
"willReportState": true,
"attributes": {
"supportedCookingModes": [
"BAKE",
"CONVECTION_BAKE",
"ROAST"
],
"maxTimerLimitSec": 3600,
"temperatureRange": {
"minThresholdCelsius": 65,
"maxThresholdCelsius": 288
},
"temperatureUnitForUX": "F"
},
"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": true,
"isRunning": true,
"temperatureSetpointCelsius": 175,
"currentCookingMode": "BAKE",
"timerRemainingSec": -1
}
}
}
}
Örnek EXECUTE komutları
Yemek Yapma
Komut parametreleri hakkında daha ayrıntılı bilgi için
action.devices.traits.Cook referansına bakın.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.Cook",
"params": {
"start": true,
"cookingMode": "ROAST"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentCookingMode": "ROAST"
}
}
]
}
}
OnOff
Komut parametreleri hakkında daha ayrıntılı 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
}
}
]
}
}
SetTemperature
Komut parametreleri hakkında daha ayrıntılı bilgi için
action.devices.traits.TemperatureControl referansına bakın.
{
"requestId": "6894439706274654520",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.SetTemperature",
"params": {
"temperature": 200
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654520",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"temperatureSetpointCelsius": 200,
"temperatureAmbientCelsius": 100
}
}
]
}
}
TimerStart
Komut parametreleri hakkında daha ayrıntılı bilgi için
action.devices.traits.Timer referansına bakın.
{
"requestId": "6894439706274654522",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.TimerStart",
"params": {
"timerTimeSec": 300
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654522",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"timerRemainingSec": 300
}
}
]
}
}
TimerAdjust
Komut parametreleri hakkında daha ayrıntılı bilgi için
action.devices.traits.Timer referansına bakın.
{
"requestId": "6894439706274654524",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.TimerAdjust",
"params": {
"timerTimeSec": -10
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654524",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"timerRemainingSec": 290
}
}
]
}
}
TimerPause
Komut parametreleri hakkında daha ayrıntılı bilgi için
action.devices.traits.Timer referansına bakın.
{
"requestId": "6894439706274654526",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.TimerPause"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654526",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"timerRemainingSec": 300,
"timerPaused": true
}
}
]
}
}
TimerResume
Komut parametreleri hakkında daha ayrıntılı bilgi için
action.devices.traits.Timer referansına bakın.
{
"requestId": "6894439706274654528",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.TimerResume"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654528",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"timerRemainingSec": 300,
"timerPaused": false
}
}
]
}
}
TimerCancel
Komut parametreleri hakkında daha ayrıntılı bilgi için
action.devices.traits.Timer referansına bakın.
{
"requestId": "6894439706274654530",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.TimerCancel"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654530",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"timerRemainingSec": -1
}
}
]
}
}
StartStop
Komut parametreleri hakkında daha ayrıntılı bilgi için
action.devices.traits.StartStop referansına bakın.
{
"requestId": "6894439706274654532",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.StartStop",
"params": {
"start": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654532",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"isRunning": true
}
}
]
}
}