دليل المكنسة الكهربائية الذكية

action.devices.types.VACUUM - قد تتضمّن المكانس الكهربائية وظائف مثل بدء التنظيف وإيقافه وإيقافه مؤقتًا، أو إرساء المكنسة، أو التحقّق من دورة التنظيف الحالية، أو تحديد موقع المكنسة، أو تعديل أوضاع مختلفة. قد تتيح بعض المكانس الكهربائية تنظيف مناطق معيّنة في المنزل.

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

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

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

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

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

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

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

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

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

Request
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
Response
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.VACUUM",
        "traits": [
          "action.devices.traits.Dock",
          "action.devices.traits.EnergyStorage",
          "action.devices.traits.StartStop"
        ],
        "name": {
          "name": "Simple vacuum"
        },
        "willReportState": true,
        "attributes": {
          "queryOnlyEnergyStorage": true,
          "pausable": true
        },
        "deviceInfo": {
          "manufacturer": "smart-home-inc",
          "model": "hs1234",
          "hwVersion": "3.2",
          "swVersion": "11.4"
        }
      }
    ]
  }
}

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

Request
{
  "requestId": "6894439706274654514",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123"
          }
        ]
      }
    }
  ]
}
Response
{
  "requestId": "6894439706274654514",
  "payload": {
    "devices": {
      "123": {
        "status": "SUCCESS",
        "online": true,
        "isRunning": false,
        "isPaused": false,
        "isDocked": true,
        "descriptiveCapacityRemaining": "HIGH",
        "capacityRemaining": [
          {
            "unit": "SECONDS",
            "rawValue": 36000
          },
          {
            "unit": "PERCENTAGE",
            "rawValue": 90
          }
        ]
      }
    }
  }
}

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

إرساء

لمزيد من التفاصيل عن مَعلمات الأمر، اطّلِع على action.devices.traits.Dock مرجع.

Request
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.Dock"
              }
            ]
          }
        ]
      }
    }
  ]
}
Response
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "PENDING",
        "states": {
          "online": true,
          "isDocked": true
        }
      }
    ]
  }
}

StartStop

لمزيد من التفاصيل عن مَعلمات الأمر، اطّلِع على action.devices.traits.StartStop مرجع.

Request
{
  "requestId": "6894439706274654518",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.StartStop",
                "params": {
                  "start": true
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Response
{
  "requestId": "6894439706274654518",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "PENDING",
        "states": {
          "online": true,
          "isRunning": true,
          "isPaused": false
        }
      }
    ]
  }
}

PauseUnpause

لمزيد من التفاصيل عن مَعلمات الأمر، اطّلِع على action.devices.traits.StartStop مرجع.

Request
{
  "requestId": "6894439706274654520",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.PauseUnpause",
                "params": {
                  "pause": true
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Response
{
  "requestId": "6894439706274654520",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "PENDING",
        "states": {
          "online": true,
          "isRunning": false,
          "isPaused": true
        }
      }
    ]
  }
}

أخطاء الجهاز

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