สคีมาลักษณะการจ่ายยาสมาร์ทโฮม

action.devices.traits.Dispense - ลักษณะนี้ใช้กับอุปกรณ์ที่รองรับการจ่ายสิ่งของจริงอย่างน้อย 1 รายการตามจำนวนที่ระบุ

นอกจากนี้ แอตทริบิวต์นี้ยังรองรับการแสดงค่าที่กำหนดล่วงหน้า เช่น "ชามอาหารแมว" สำหรับเครื่องให้อาหารสัตว์ หรือ "แก้ว" สำหรับก๊อกน้ำ

แอตทริบิวต์อุปกรณ์

อุปกรณ์ที่มีลักษณะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดำเนินการ SYNC ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC ได้ที่การดำเนินการตาม Intent

ตัวอย่าง

เครื่องทำน้ำดื่มที่รองรับหน่วยของของเหลวที่มีค่าที่กำหนดไว้ล่วงหน้า

{
  "supportedDispenseItems": [
    {
      "item_name": "Water",
      "item_name_synonyms": [
        {
          "lang": "en",
          "synonyms": [
            "Water"
          ]
        }
      ],
      "supported_units": [
        "TEASPOONS",
        "TABLESPOONS",
        "FLUID_OUNCES",
        "CUPS",
        "PINTS",
        "QUARTS",
        "GALLONS",
        "MILLILITERS",
        "LITERS",
        "DECILITERS"
      ],
      "default_portion": {
        "amount": 2,
        "unit": "CUPS"
      }
    }
  ],
  "supportedDispensePresets": [
    {
      "preset_name": "cat_bowl",
      "preset_name_synonyms": [
        {
          "lang": "en",
          "synonyms": [
            "Cat water bowl",
            "Cat water dish",
            "Cat water cup"
          ]
        }
      ]
    },
    {
      "preset_name": "glass_1",
      "preset_name_synonyms": [
        {
          "lang": "en",
          "synonyms": [
            "Glass of water",
            "Glass"
          ]
        }
      ]
    }
  ]
}

เครื่องให้อาหารสัตว์เลี้ยงที่ไม่มีการตั้งค่าล่วงหน้า

{
  "supportedDispenseItems": [
    {
      "item_name": "Treat",
      "item_name_synonyms": [
        {
          "lang": "en",
          "synonyms": [
            "Treats",
            "Dog treats",
            "Treat",
            "Dog treat"
          ]
        }
      ],
      "supported_units": [
        "NO_UNITS"
      ],
      "default_portion": {
        "amount": 1,
        "unit": "NO_UNITS"
      }
    }
  ]
}

สถานะของอุปกรณ์

เอนทิตีที่มีลักษณะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดำเนินการ QUERY ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent QUERY ได้ที่การดำเนินการตาม Intent

ตัวอย่าง

มีขนมสำหรับสุนัขเหลืออยู่ในเครื่องจ่ายเท่าไร

{
  "dispenseItems": [
    {
      "itemName": "Dog treats",
      "amountRemaining": {
        "amount": 83,
        "unit": "NO_UNITS"
      },
      "amountLastDispensed": {
        "amount": 2,
        "unit": "NO_UNITS"
      },
      "isCurrentlyDispensing": false
    }
  ]
}

เครื่องทำน้ำเย็นเหลือน้ำอยู่เท่าไร

{
  "dispenseItems": [
    {
      "itemName": "Water",
      "amountRemaining": {
        "amount": 6.2,
        "unit": "GALLONS"
      },
      "amountLastDispensed": {
        "amount": 1,
        "unit": "CUPS"
      },
      "isCurrentlyDispensing": false
    }
  ]
}

ฉันให้อาหารแมวไปเท่าใดก่อนหน้านี้

{
  "dispenseItems": [
    {
      "itemName": "cat_food",
      "amountRemaining": {
        "amount": 16.5,
        "unit": "CUPS"
      },
      "amountLastDispensed": {
        "amount": 2.5,
        "unit": "CUPS"
      },
      "isCurrentlyDispensing": false
    }
  ]
}

ก๊อกน้ำยังคงจ่ายน้ำอยู่ไหม

{
  "dispenseItems": [
    {
      "itemName": "Water",
      "isCurrentlyDispensing": true
    }
  ]
}

amountRemaining และ amountLastDispensed ต้องรายงานโดยใช้หน่วยวัดเพียงหน่วยเดียวเท่านั้น

คุณระบุรายการได้หลายรายการภายในอาร์เรย์ dispenseItems ชื่อสินค้าแต่ละรายการต้องไม่ซ้ำกันและต้องตรงกับสินค้าในแอตทริบิวต์ supportedDispenseItems

คำสั่งของอุปกรณ์

อุปกรณ์ที่มีลักษณะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ EXECUTE ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE ได้ที่การดำเนินการตาม Intent

action.devices.commands.Dispense

จ่ายสินค้า

พารามิเตอร์

เพย์โหลดมีสิ่งใดสิ่งหนึ่งต่อไปนี้

จ่ายตามจำนวนเงิน

จ่ายตามค่าที่กำหนดล่วงหน้า

จ่ายเงินโดยไม่มีพารามิเตอร์

ตัวอย่าง

น้ำ 1 แก้ว

{
  "command": "action.devices.commands.Dispense",
  "params": {
    "amount": 1,
    "unit": "CUPS",
    "item": "Water"
  }
}

เติมน้ำในชามน้ำแมว

{
  "command": "action.devices.commands.Dispense",
  "params": {
    "presetName": "cat_bowl"
  }
}

กดน้ำ

{
  "command": "action.devices.commands.Dispense",
  "params": {}
}

ข้อผิดพลาดของอุปกรณ์

• dispenseAmountRemainingExceeded: ผู้ใช้พยายามจ่ายเงินหรือสินค้าจากอุปกรณ์ที่มีจำนวนไม่เพียงพอ
• dispenseAmountAboveLimit: ผู้ใช้พยายามจ่ายเงินเกินจำนวนที่ขอได้ในคําค้นหาเดียว เพื่อป้องกันไม่ให้น้ำไหลออกมามากเกินไปโดยไม่ตั้งใจ (เช่น น้ำ 500,000 แก้ว)
• dispenseAmountBelowLimit: ผู้ใช้พยายามจ่ายสิ่งของหรือจำนวนหนึ่งๆ จากอุปกรณ์ที่อยู่ต่ำกว่าจำนวนเงินขั้นต่ำที่จ่ายได้
• dispenseFractionalAmountNotSupported: ผู้ใช้พยายามจ่ายเงินเป็นเศษส่วนของสินค้าซึ่งอุปกรณ์ไม่สามารถแยกออกได้ (เช่น อุปกรณ์อาจแยกสินค้านับได้ เช่น ขนมสุนัข ไม่ได้)
• genericDispenseNotSupported: ผู้ใช้พยายามจ่ายเงินจากอุปกรณ์โดยไม่ระบุรายการหรือค่าที่กำหนดล่วงหน้า แต่อุปกรณ์ไม่รองรับฟังก์ชันการทำงานดังกล่าว (เช่น การดำเนินการจ่ายเงินเริ่มต้น)
• dispenseUnitNotSupported: ผู้ใช้พยายามจ่ายเงินจากอุปกรณ์ที่มีหน่วยที่ระบบไม่รองรับสำหรับกรณีนั้น (เช่น ไม่มีรายการดังกล่าว ระบบจึงข้าม supported_unit validation)
• dispenseFractionalUnitNotSupported: ผู้ใช้พยายามจ่ายอาหารในปริมาณบางส่วนที่แยกส่วนได้แต่แยกส่วนหน่วยที่ระบุไม่ได้ (เช่น ก๊อกน้ำอาจจ่ายได้ 2.7 ถ้วย แต่จ่ายไม่ได้ 2.7 มิลลิลิตร)
• deviceCurrentlyDispensing: ผู้ใช้พยายามจ่ายเงิน แต่อุปกรณ์จ่ายเงินไปแล้ว
• deviceClogged: ผู้ใช้พยายามจ่ายอาหาร แต่อุปกรณ์อุดตัน
• deviceBusy: ผู้ใช้พยายามจ่ายเงิน แต่อุปกรณ์ไม่ว่าง (ทั่วไป)

ข้อยกเว้นของอุปกรณ์

คุณรายงานข้อยกเว้นเหล่านี้เป็น exceptionCode ในออบเจ็กต์ states ของคำตอบได้

• amountRemainingLow - ผู้ใช้จ่ายสิ่งของหรือจำนวนเงินจากอุปกรณ์ ซึ่งทำให้จำนวนเงินคงเหลืออยู่ในระดับต่ำ คุณมีหน้าที่รับผิดชอบในการกำหนดสิ่งที่ถือเป็นระดับ "ต่ำ"
• userNeedsToWait - เมื่อผู้ใช้ต้องรอก่อนที่ระบบจะจ่ายสินค้าหรือจำนวนเงินที่ขอได้สําเร็จ (เช่น faucet จะจ่ายน้ำร้อน แต่ผู้ใช้ต้องรอให้น้ำร้อนขึ้นก่อนจึงจะเริ่มจ่าย)