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

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

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

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

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

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

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

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

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

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

في ستارة النافذة التي يمكن فتحها من الأعلى والأسفل، يؤدي التمرير 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"
            }
          ]
        }
      }
    ]
  }
}

أخطاء الجهاز

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