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

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

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

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

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

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

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

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

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

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

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

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

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

الشكل 1. تحليل أعمى من أعلى إلى أسفل

مثال على استجابة SYNC

الطلب
{
  "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"
          }
        ]
      }
    }
  }
}

أمثلة على أوامر EXECUTE

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"
            }
          ]
        }
      }
    ]
  }
}

أخطاء الجهاز

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