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

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

Döndürme yüzde veya derece cinsinden belirtilebilir. Cihaz derece cinsinden döndürmeyi destekliyorsa varsayılan döndürme yönü saat yönündedir.

CİHAZ ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC amaçlarının ele alınması hakkında daha fazla bilgi edinmek için Niyet karşılama bölümüne bakın.

Özellikler Tür Açıklama
supportsDegrees Boole

Zorunludur.

Cihaz derece cinsinden dönmeye izin veriyorsa doğru olarak ayarlayın.
supportsPercent Boole

Zorunludur.

Cihaz yüzdeye göre dönmeye izin veriyorsa doğru olarak ayarlayın.
rotationDegreesRange Nesne

Bir cihazın dönebileceği derece aralığını temsil eder.
rotationDegreesMin Number

Zorunludur.

Derecede minimum dönüş.
rotationDegreesMax Number

Zorunludur.

Derecede maksimum dönüş.
supportsContinuousRotation Boole

(Varsayılan: false)

Cihaz sürekli dönmeye izin veriyorsa doğru değerine ayarlayın. Göreli bir sorgu verildiğinde RotateAbsolute komutu, desteklenen döndürme aralığını sarar.
commandOnlyRotation Boole

(Varsayılan: false)

Cihazın tek yönlü (doğru) veya iki yönlü (yanlış) iletişimi destekleyip desteklemediğini belirtir. Cihaz bir QUERY intent'ine yanıt veremiyorsa veya bu özellik için durum raporlayamıyorsa bu özelliği true olarak ayarlayın.

Örnekler

Hem yüzde hem de 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 kesintisiz 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 intent'lerini ele alma hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.

Eyaletler Tür Açıklama
rotationDegrees Number

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

Cihazın şu anda hangi yüzdede döndürüldüğünü gösteren mevcut seviye. 0,0 kapalı, 100,0 açık anlamına gelir.
targetRotationPercent Number

Döndürme değişikliğinde sürekli bir değişiklik nedeniyle cihazın gideceği veya hareket edeceği dönüş yüzdesini gösteren seviye.

Örnekler

Cihaz ne kadar döndürüldü? (yüzde ve derece).

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

Cihaz ne kadar döndürülmüş? (yalnızca derece).

{
  "rotationDegrees": 45
}

Cihaz ne kadar döndürüldü? (devamlı).

{
  "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ın ele alınması hakkında daha fazla bilgi edinmek için Niyet karşılama bölümüne bakın.

action.devices.commands.RotateAbsolute

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

Parametreler

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

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

Parametreler Tür Açıklama
rotationDegrees Number

Zorunludur.

Cihazın saat yönündeki nihai dönüşünü belirten, derece cinsinden mutlak bir değer. Değer, rotationDegreesRange özelliğine uygun olmalıdır.

Mutlak rotasyonu yüzde olarak ayarlayın.

Parametreler Tür Açıklama
rotationPercent Number

Zorunludur.

Cihazın nihai dönüşünü yüzdelik olarak belirten mutlak değer.

Örnekler

Cihazı 50 dereceye yatırın.

{
  "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önüşümü ayarlanırken hata oluştu.

Desteklenen değerler:

deviceJammingDetected

Cihaz ERRORS

Hata ve istisnaların tam listesini inceleyin.