Akıllı Ev Kapısı Kılavuzu
action.devices.types.GATE - Kapılar açılabilir ve kapatılabilir. Aksi halde, yönde yönlendirilir.
Bu tür, cihazın Kapı simgesini ve ilgili bazı eş anlamlıları ve takma adları aldığı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.
Kalite gereksinimleri
- Gecikme: 2.500 ms.den az 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ı
Bu bölümde, cihaz türüne ve yukarıdaki özelliklere göre yaygın "Kapı"yı gösteren örnek amaç yükleri yer alı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.GATE",
"traits": [
"action.devices.traits.LockUnlock",
"action.devices.traits.OpenClose"
],
"name": {
"name": "Simple gate"
},
"willReportState": 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,
"openPercent": 50,
"isLocked": false,
"isJammed": false
}
}
}
}
Örnek EXECUTE komutları
Kilit Açma
Komut parametreleri hakkında ek ayrıntılar için
action.devices.traits.LockUnlock referansına bakın.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.LockUnlock",
"params": {
"lock": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"isLocked": true,
"isJammed": false
}
}
]
}
}
OpenClose
Komut parametreleri hakkında ek ayrıntılar için
action.devices.traits.OpenClose referansına bakın.
{
"requestId": "6894439706274654518",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.OpenClose",
"params": {
"openPercent": 100
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654518",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"openPercent": 100
}
}
]
}
}