دليل الستائر المنزلية الذكية

action.devices.types.BLINDS - يمكن فتح الستائر وإغلاقها، ويمكن استخدام أنواع مختلفة من الستائر، مثل الستائر (يمكن فتحها في اتجاه واحد) أو اللوحة أو العمودية (يمكن فتحها إما على اليسار أو اليمين) ومن أعلى لأسفل إلى أعلى (يمكن فتحها للأعلى أو للأسفل). قد تتضمّن بعض الستائر ألواحًا يمكن تدويرها.

يشير هذا النوع إلى أن الجهاز يحصل على رمز الستائر وبعض المرادفات والأسماء المستعارة.

إمكانيات الجهاز

راجع وثائق السمات المقابلة تفاصيل التنفيذ، مثل السمات والحالات التي يجب أن تتيحها خدمتك، وكيفية إنشاء ردود EXECUTE وQUERY.

السمات المطلوبة

هذه السمات والأوامر مطلوبة، إذا كانت منطبقة على الخاص بك. إذا لم يكن جهازك يتيح هذه السمات، أدخِل رمز الخطأ functionNotSupported في استجابة QUERY أو EXECUTE. عرض الأخطاء والاستثناءات لمزيد من المعلومات.

ننصح باستخدام هذه السمات إذا كانت منطبقة على جهازك. ومع ذلك، يمكنك مزج جميع السمات المتاحة ومطابقتها لمطابقة بياناتك على أفضل نحو وظائف المنتج.

متطلبات الجودة

  • وقت الاستجابة: يجب أن يكون أقل من أو يساوي 2500 ملي ثانية.
  • الموثوقية: يجب أن تكون أكبر من أو تساوي 97%.

مثال على جهاز: ستائر بسيطة

يحتوي هذا القسم على مثال على حمولات بيانات النية التي تمثّل "الستائر" الشائعة. بناءً على نوع الجهاز والسمات المذكورة أعلاه. إذا قمتَ بإضافة أو إزالة سمات في التنفيذ، عليك تعديل ردودك وفقًا لذلك لتعكس هذه التغييرات.

في ستارة النافذة من أعلى لأسفل إلى أعلى، يرفع اتجاه UP الجزء السفلي من المكفوفين والاتجاه DOWN يؤدي إلى خفض الجزء العلوي جزء من المكفوفين. يوضّح الشكل 1 مثال على ستائر من أعلى إلى أسفل، حيث يكون اتجاه UP برفع الجزء السفلي من المكفوفين بنسبة 50 في المائة يعمل الاتجاه DOWN على خفض الجزء العلوي من الستارة بنسبة 30 في المئة.

الشكل 1 ستارة معتِمة من أعلى إلى أسفل

نموذج رد المزامنة

طلب
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
الرد
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.BLINDS",
        "traits": [
          "action.devices.traits.OpenClose"
        ],
        "name": {
          "name": "Simple blinds"
        },
        "willReportState": true,
        "attributes": {
          "openDirection": [
            "UP",
            "DOWN"
          ]
        },
        "deviceInfo": {
          "manufacturer": "smart-home-inc",
          "model": "hs1234",
          "hwVersion": "3.2",
          "swVersion": "11.4"
        }
      }
    ]
  }
}

نموذج رد QUERY

طلب
{
  "requestId": "6894439706274654514",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123"
          }
        ]
      }
    }
  ]
}
الرد
{
  "requestId": "6894439706274654514",
  "payload": {
    "devices": {
      "123": {
        "status": "SUCCESS",
        "online": true,
        "openState": [
          {
            "openPercent": 30,
            "openDirection": "DOWN"
          },
          {
            "openPercent": 50,
            "openDirection": "UP"
          }
        ]
      }
    }
  }
}

نماذج أوامر التنفيذ

OpenClose

للحصول على تفاصيل إضافية حول معاملات الأوامر، عرض action.devices.traits.OpenClose المرجع.

طلب
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.OpenClose",
                "params": {
                  "openPercent": 10,
                  "openDirection": "DOWN"
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
الرد
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "openState": [
            {
              "openPercent": 10,
              "openDirection": "DOWN"
            },
            {
              "openPercent": 50,
              "openDirection": "UP"
            }
          ]
        }
      }
    ]
  }
}

أخطاء الجهاز

اطّلع على القائمة الكاملة الأخطاء والاستثناءات.