Lược đồ thuộc tính phân phối nhà thông minh

action.devices.traits.Dispense – Đặc điểm này thuộc về những thiết bị hỗ trợ việc phân phát một số lượng cụ thể của một hoặc nhiều mặt hàng thực tế.

Đặc điểm này cũng hỗ trợ phân phát một chế độ cài đặt sẵn, ví dụ: "bát đựng thức ăn cho mèo" cho thiết bị cho thú cưng ăn hoặc "cốc" cho vòi nước.

THUỘC TÍNH của thiết bị

Các thiết bị có đặc điểm này có thể báo cáo các thuộc tính sau đây trong thao tác SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem phần Thực hiện ý định.

Ví dụ

Máy rót nước hỗ trợ các đơn vị đo chất lỏng có giá trị đặt sẵn.

{
  "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"
          ]
        }
      ]
    }
  ]
}

Máy cho thú cưng ăn tự động không có chế độ cài đặt sẵn.

{
  "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"
      }
    }
  ]
}

TRẠNG THÁI thiết bị

Các thực thể có đặc điểm này có thể báo cáo các trạng thái sau đây trong quá trình hoạt động QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem phần Thực hiện ý định.

Ví dụ

Máy phân phát còn bao nhiêu bánh thưởng cho chó?

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

Bình nước của tôi còn bao nhiêu nước?

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

Trước đây tôi đã cho mèo ăn bao nhiêu thức ăn?

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

Vòi nước có còn chảy không?

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

Bạn chỉ cần báo cáo amountRemaining và amountLastDispensed bằng một đơn vị đo lường.

Bạn có thể cung cấp nhiều mặt hàng trong mảng dispenseItems. Mỗi tên mặt hàng phải là duy nhất và phải tương ứng với một mặt hàng trong thuộc tính supportedDispenseItems.

Lệnh cho thiết bị

Các thiết bị có đặc điểm này có thể phản hồi các lệnh sau trong thao tác EXECUTE. Để tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem phần Thực hiện ý định.

action.devices.commands.Dispense

Phân phát các mục.

Thông số

Phần dữ liệu chứa một trong những nội dung sau:

Rút tiền theo số lượng.

Phân phát theo giá trị đặt sẵn.

Phân phát không có tham số.

Ví dụ

Cho tôi 1 cốc nước.

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

Đổ đầy bát nước cho mèo.

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

Rót nước.

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

LỖI thiết bị

• dispenseAmountRemainingExceeded: Người dùng đã cố gắng rút một mặt hàng hoặc số tiền từ một thiết bị không còn đủ số tiền.
• dispenseAmountAboveLimit: Người dùng đã cố gắng rút một số tiền vượt quá hạn mức mà họ có thể yêu cầu trong một truy vấn duy nhất. Điều này nhằm tránh trường hợp vô tình rót quá nhiều nước (ví dụ: 500.000 cốc nước).
• dispenseAmountBelowLimit: Người dùng đã cố gắng rút một mặt hàng hoặc số tiền từ thiết bị mà số tiền đó thấp hơn số tiền tối thiểu mà thiết bị có thể rút.
• dispenseFractionalAmountNotSupported: Người dùng đã cố gắng phân phối một lượng nhỏ của một mặt hàng mà thiết bị không thể chia nhỏ (ví dụ: các mặt hàng có thể đếm được như bánh thưởng cho chó có thể không chia được bằng thiết bị).
• genericDispenseNotSupported: Người dùng cố gắng phân phát từ một thiết bị mà không chỉ định mặt hàng hoặc chế độ cài đặt sẵn, nhưng thiết bị đó không hỗ trợ chức năng này (ví dụ: hành động phân phát mặc định).
• dispenseUnitNotSupported: Người dùng cố gắng phân phối từ một thiết bị có đơn vị không được hỗ trợ cho trường hợp đó (ví dụ: mặt hàng không được cung cấp nên supported_unit validation đã bị bỏ qua).
• dispenseFractionalUnitNotSupported: Người dùng đã cố gắng phân phát một phần nhỏ của một mặt hàng có thể chia nhỏ nhưng không phải cho đơn vị cụ thể được chỉ định (ví dụ: vòi có thể phân phát 2,7 cốc nhưng không thể phân phát 2,7 ml).
• deviceCurrentlyDispensing: Người dùng cố gắng phân phát một mặt hàng nhưng thiết bị đang phân phát.
• deviceClogged: Người dùng cố gắng phân phối một mặt hàng nhưng thiết bị bị tắc nghẽn.
• deviceBusy: Người dùng cố gắng phân phát một mặt hàng nhưng thiết bị đang bận (chung).

TRƯỜNG HỢP NGOẠI LỆ về thiết bị

Bạn có thể báo cáo những trường hợp ngoại lệ này dưới dạng exceptionCode trong đối tượng states của phản hồi:

• amountRemainingLow – Người dùng lấy một mặt hàng hoặc số tiền từ thiết bị, khiến số tiền còn lại ở mức thấp. Bạn có trách nhiệm xác định những yếu tố tạo nên mức "thấp".
• userNeedsToWait – Khi người dùng phải đợi trước khi mặt hàng hoặc số tiền được yêu cầu có thể được phân phối thành công (ví dụ: vòi nước sẽ phân phối nước nóng nhưng người dùng cần đợi nước nóng lên trước khi bắt đầu phân phối).