مرحبًا بك في "مركز مطوّري برامج Google Home"، وجهتك الجديدة لتعلّم كيفية تطوير إجراءات منزلية ذكية. ملاحظة: ستواصل إنشاء الإجراءات في وحدة تحكم الإجراءات.
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

دليل غسيل المنزل الذكي

action.devices.types.WASHER - يمكن أن تتضمن الغسالات وظائف بدء وإيقاف مستقلة عن التشغيل أو الإيقاف (تحتوي بعض الغسالات على أزرار تشغيل منفصلة، وبعضها لا تحتوي على). يمكن إيقاف بعضها مؤقتًا واستئنافها أثناء الغسل. تشتمل الغسالات أيضًا على أوضاع مختلفة لكل منها إعداداتها الخاصة. وهذه البيانات خاصة بالغسّالة ويتم تفسيرها في شكل عام.

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

للاطّلاع على مثال حول كيفية التحكّم في الغسّالة باستخدام جهاز Google home home، راجِع الدرس التطبيقي حول الترميز في غسّالة المنزل الذكية.

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

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

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

هذه السمات والأوامر مطلوبة، إذا كانت منطبقة على جهازك.

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

  • action.devices.traits.Modes
  • action.devices.traits.OnOff
  • action.devices.traits.RunCycle
  • action.devices.traits.Toggles
  • متطلبات الجودة

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

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

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

    نموذج استجابة SYNC

    طلب
    {
      "requestId": "6894439706274654512",
      "inputs": [
        {
          "intent": "action.devices.SYNC"
        }
      ]
    }
    الردّ
    {
      "requestId": "6894439706274654512",
      "payload": {
        "agentUserId": "user123",
        "devices": [
          {
            "id": "123",
            "type": "action.devices.types.WASHER",
            "traits": [
              "action.devices.traits.OnOff",
              "action.devices.traits.RunCycle",
              "action.devices.traits.StartStop",
              "action.devices.traits.Modes"
            ],
            "name": {
              "name": "Simple washer"
            },
            "willReportState": true,
            "attributes": {
              "availableModes": [
                {
                  "name": "load_key",
                  "name_values": [
                    {
                      "name_synonym": [
                        "Load",
                        "Size",
                        "Load size"
                      ],
                      "lang": "en"
                    }
                  ],
                  "settings": [
                    {
                      "setting_name": "small_key",
                      "setting_values": [
                        {
                          "setting_synonym": [
                            "Small",
                            "Half"
                          ],
                          "lang": "en"
                        }
                      ]
                    },
                    {
                      "setting_name": "large_key",
                      "setting_values": [
                        {
                          "setting_synonym": [
                            "Large",
                            "Full"
                          ],
                          "lang": "en"
                        }
                      ]
                    }
                  ],
                  "ordered": true
                }
              ],
              "pausable": true
            },
            "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,
            "on": true,
            "isRunning": true,
            "isPaused": false,
            "currentRunCycle": [
              {
                "currentCycle": "rinse",
                "nextCycle": "spin",
                "lang": "en"
              }
            ],
            "currentTotalRemainingTime": 600,
            "currentCycleRemainingTime": 300,
            "currentModeSettings": {
              "load_key": "small_key"
            }
          }
        }
      }
    }

    نماذج أوامر EXECUTE

    إيقاف التشغيل

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

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

    StartStop

    للحصول على تفاصيل إضافية عن معلّمات الأوامر، راجِع مرجع 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
                    }
                  }
                ]
              }
            ]
          }
        }
      ]
    }
    الردّ
    {
      "requestId": "6894439706274654518",
      "payload": {
        "commands": [
          {
            "ids": [
              "123"
            ],
            "status": "SUCCESS",
            "states": {
              "online": true,
              "isRunning": true,
              "isPaused": false
            }
          }
        ]
      }
    }

    أوضاع

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

    طلب
    {
      "requestId": "6894439706274654522",
      "inputs": [
        {
          "intent": "action.devices.EXECUTE",
          "payload": {
            "commands": [
              {
                "devices": [
                  {
                    "id": "123"
                  }
                ],
                "execution": [
                  {
                    "command": "action.devices.commands.SetModes",
                    "params": {
                      "updateModeSettings": {
                        "load_key": "large_key"
                      }
                    }
                  }
                ]
              }
            ]
          }
        }
      ]
    }
    الردّ
    {
      "requestId": "6894439706274654522",
      "payload": {
        "commands": [
          {
            "ids": [
              "123"
            ],
            "status": "SUCCESS",
            "states": {
              "online": true,
              "currentModeSettings": {
                "load_key": "large_key"
              }
            }
          }
        ]
      }
    }

    أخطاء الجهاز

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