دليل ماكينات جزّ الأعشاب الذكية

action.devices.types.MOWER - قد تتضمّن التفاعلات مع ماكينات جز العشب بدء التشغيل وإيقافه مؤقتًا وإيقاف تشغيله وإيقاف التحقق من الدورة الحالية وتحديد موقع جزّازة العشب وتعديل الأوضاع المختلفة.

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

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

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

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

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

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

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

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

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

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

نموذج استجابة المزامنة

طلب
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
الرد
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.MOWER",
        "traits": [
          "action.devices.traits.Dock",
          "action.devices.traits.EnergyStorage",
          "action.devices.traits.StartStop"
        ],
        "name": {
          "name": "Simple mower"
        },
        "willReportState": true,
        "attributes": {
          "queryOnlyEnergyStorage": true,
          "pausable": true,
          "availableZones": [
            "left driveway",
            "right driveway",
            "around the hedges"
          ]
        },
        "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,
        "isRunning": true,
        "isPaused": false,
        "isDocked": false,
        "activeZones": [
          "left driveway"
        ],
        "descriptiveCapacityRemaining": "HIGH",
        "capacityRemaining": [
          {
            "unit": "SECONDS",
            "rawValue": 36000
          },
          {
            "unit": "PERCENTAGE",
            "rawValue": 90
          }
        ]
      }
    }
  }
}

نماذج أوامر EXECUTE

تثبيت الجهاز على قاعدة الإرساء

للحصول على تفاصيل إضافية عن معلَمات الأوامر، يُرجى الاطّلاع على مرجع action.devices.traits.Dock.

طلب
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.Dock"
              }
            ]
          }
        ]
      }
    }
  ]
}
الرد
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "isDocked": true
        }
      }
    ]
  }
}

تشغيل

للحصول على تفاصيل إضافية عن معلَمات الأوامر، يُرجى الاطّلاع على مرجع action.devices.traits.StartStop.

طلب
{
  "requestId": "6894439706274654518",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.StartStop",
                "params": {
                  "start": true,
                  "zone": "right driveway"
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
الرد
{
  "requestId": "6894439706274654518",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "isRunning": true,
          "isPaused": false,
          "activeZones": [
            "right driveway"
          ]
        }
      }
    ]
  }
}

أخطاء الجهاز

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