Akıllı Ev Döndürme Özelliği Şeması

action.devices.traits.Rotation: Bu özellik, döndürmeyi destekleyen cihazlara aittir.

Dönüş, yüzde veya derece cinsinden belirtilebilir. Cihaz, derece cinsinden dönüşü destekliyorsa varsayılan dönüş yönü saat yönündedir.

Cihaz ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

Özellikler Tür Açıklama
supportsDegrees Boole

Zorunlu.

Cihazın dereceye göre döndürmeye izin vermesi durumunda true olarak ayarlayın.
supportsPercent Boole

Zorunlu.

Cihazın yüzdeye göre döndürmeye izin vermesi durumunda true olarak ayarlayın.
rotationDegreesRange Nesne

Bir cihazın dönebileceği aralığı derece cinsinden gösterir.
rotationDegreesMin Number

Zorunlu.

Derece cinsinden minimum dönüş.

Değer 0 ile 360 arasında olmalıdır.
rotationDegreesMax Number

Zorunlu.

Derece cinsinden maksimum dönüş.

Değer 0 ile 360 arasında olmalıdır.
supportsContinuousRotation Boole

(Varsayılan: false)

Cihazın sürekli döndürmeye izin vermesi durumunda true olarak ayarlayın. RotateAbsolute komutu, göreceli bir sorgu verildiğinde desteklenen döndürme aralığını kapsar.
commandOnlyRotation Boole

(Varsayılan: false)

Cihazın tek yönlü (doğru) veya iki yönlü (yanlış) iletişimi destekleyip desteklemediğini gösterir. Cihaz, bu özellik için QUERY amacına veya Durum Raporu'na yanıt veremiyorsa bu özelliği doğru olarak ayarlayın.

Örnekler

Yüzde ve derece cinsinden dönüşü destekleyen cihaz.

{
  "supportsDegrees": true,
  "supportsPercent": true,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 180
  }
}

Yalnızca derece cinsinden döndürmeyi destekleyen cihaz.

{
  "supportsDegrees": true,
  "supportsPercent": false,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 90
  }
}

Yalnızca sürekli döndürme komutlarını destekleyen cihaz.

{
  "supportsDegrees": true,
  "supportsPercent": true,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 360
  },
  "supportsContinuousRotation": true,
  "commandOnlyRotation": true
}

Cihaz DURUMLARI

Bu özelliğe sahip öğeler, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

Eyaletler Tür Açıklama
rotationDegrees Number

Cihazın kaç derece döndürüldüğünü gösteren rotationDegreesRange içindeki mevcut seviye. Bu değer her zaman saat yönünde dönüşe göre olmalıdır.
rotationPercent Number

Cihazın şu anda hangi yüzdeyle döndürüldüğünü gösteren mevcut seviye. 0,0 kapalıya, 100,0 ise açık duruma karşılık gelir.

Değer 0 ile 100 arasında olmalıdır.
targetRotationPercent Number

Cihazın, devam eden bir dönme değişikliği sonucunda döneceği veya döndüğü dönme yüzdesini gösteren seviye.

Değer 0 ile 100 arasında olmalıdır.

Örnekler

Cihaz ne kadar döndürülmüş? (yüzde ve derece)

{
  "rotationDegrees": 45,
  "rotationPercent": 25
}

Cihaz ne kadar döndürülüyor? (yalnızca derece)

{
  "rotationDegrees": 45
}

Cihaz ne kadar döndürülüyor? (sürekli)

{
  "rotationDegrees": 270,
  "rotationPercent": 75
}

Şu anda yeni bir konuma dönen cihaz (yüzde).

{
  "rotationPercent": 75,
  "targetRotationPercent": 100
}

Cihaz KOMUTLARI

Bu özelliğe sahip cihazlar, EXECUTE işlemi kapsamında aşağıdaki komutlara yanıt verebilir. EXECUTE amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

action.devices.commands.RotateAbsolute

Cihazın mutlak dönüşünü ayarlayın.

Parametreler

Yük aşağıdakilerden birini içeriyor:

Mutlak dönüşü derece cinsinden ayarlayın.

Parametreler Tür Açıklama
rotationDegrees Number

Zorunlu.

Cihazın son saat yönünde dönüşünü belirten, derece cinsinden mutlak değer. Değer, rotationDegreesRange özelliği içinde olmalıdır.

Mutlak rotasyonu yüzde olarak ayarlayın.

Parametreler Tür Açıklama
rotationPercent Number

Zorunlu.

Cihazın son dönüşünü belirten, yüzde cinsinden mutlak değer.

Değer 0 ile 100 arasında olmalıdır.

Örnekler

Cihazı yüzde 50 eğin.

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationPercent": 50
  }
}

Cihazı saat yönünün tersine 15 derece döndürün (rotationDegrees: 45).

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 30
  }
}

Cihazı saat yönünde 100 derece döndürün (supportsContinuousRotation: true, rotationDegrees: 270).

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 10
  }
}

Cihazın döndürme ayarı yapılırken bir hata oluştu.

Desteklenen değerler:

deviceJammingDetected

Cihaz HATALARI

Hatalar ve istisnalar listesinin tamamını inceleyin.