কীভাবে স্মার্ট হোম অ্যাকশন তৈরি করতে হয় তা শেখার নতুন গন্তব্য Google হোম ডেভেলপার সেন্টারে স্বাগতম। দ্রষ্টব্য: আপনি অ্যাকশন কনসোলে নির্মাণ কাজ চালিয়ে যাবেন।
সেভ করা পৃষ্ঠা গুছিয়ে রাখতে 'সংগ্রহ' ব্যবহার করুন আপনার পছন্দ অনুযায়ী কন্টেন্ট সেভ করুন ও সঠিক বিভাগে রাখুন।

স্মার্ট হোম ডিসপেন্স ট্রিট স্কিমা

action.devices.traits.Dispense - এই বৈশিষ্ট্যটি এমন ডিভাইসগুলির অন্তর্গত যা নির্দিষ্ট পরিমাণে এক বা একাধিক শারীরিক আইটেম বিতরণ করতে সহায়তা করে।

এই বৈশিষ্ট্যটি একটি প্রিসেট বিতরণকেও সমর্থন করে, উদাহরণস্বরূপ একটি পোষা খাবারের জন্য একটি "বিড়ালের খাবারের বাটি" বা একটি কলের জন্য একটি "গ্লাস"।

ডিভাইস বৈশিষ্ট্য

এই বৈশিষ্ট্য সহ ডিভাইসগুলি SYNC অপারেশনের অংশ হিসাবে নিম্নলিখিত বৈশিষ্ট্যগুলি রিপোর্ট করতে পারে৷ SYNC ইন্টেন্টগুলি পরিচালনা করার বিষয়ে আরও জানতে, ইন্টেন্ট পরিপূর্ণতা দেখুন।

গুণাবলী টাইপ বর্ণনা
supportedDispenseItems অ্যারে

ডিভাইসটি বিতরণ করতে পারে এমন সমস্ত আইটেমের তথ্য রয়েছে৷

[ item, ... ] অবজেক্ট

বিতরণযোগ্য আইটেম।

item_name স্ট্রিং

প্রয়োজন।

বিতরণ করা আইটেমের অভ্যন্তরীণ নাম। এটি অ-ব্যবহারকারী-বান্ধব হতে পারে এবং সমস্ত ভাষা জুড়ে শেয়ার করা হয়৷

item_name_synonyms অ্যারে

প্রয়োজন।

প্রতিটি সমর্থিত ভাষায় বিতরণের জন্য সমার্থক নাম।

[ item, ... ] অবজেক্ট

একটি প্রদত্ত ভাষায় বিতরণ করা আইটেমের সমার্থক নাম।

synonyms অ্যারে

প্রয়োজন।

বিতরণ করা আইটেমের সমার্থক নাম। যদি প্রযোজ্য হয় তাহলে সমার্থক শব্দের মধ্যে একবচন এবং বহুবচন উভয় রূপই অন্তর্ভুক্ত করা উচিত। এই তালিকার প্রথম স্ট্রিংটি অবশ্যই সেই ভাষার আইটেমের বহুবচন রূপ হতে হবে।

[ item, ... ] স্ট্রিং

সমার্থক নাম

lang স্ট্রিং

প্রয়োজন।

ভাষার কোড (ISO 639-1)। সমর্থিত ভাষা দেখুন।

supported_units অ্যারে

প্রয়োজন।

ডিভাইসটি সেই আইটেমটির জন্য সমর্থন করে এমন ইউনিটগুলির সেট৷

[ item, ... ] স্ট্রিং

সমর্থিত ইউনিট।

সমর্থিত মান:

CENTIMETERS
CUPS
DECILITERS
FLUID_OUNCES
GALLONS
GRAMS
KILOGRAMS
LITERS
MILLIGRAMS
MILLILITERS
MILLIMETERS
NO_UNITS
OUNCES
PINCH
PINTS
PORTION
POUNDS
QUARTS
TABLESPOONS
TEASPOONS
default_portion অবজেক্ট

প্রয়োজন।

যে আইটেমটি বিতরণ করা হতে পারে তার সাধারণ পরিমাণ।

amount পূর্ণসংখ্যা

প্রয়োজন।

বিতরণ করা পরিমাণ।

unit স্ট্রিং

প্রয়োজন।

বিতরণ ইউনিট।

supportedDispensePresets অ্যারে

ডিভাইস দ্বারা সমর্থিত প্রিসেট.

[ item, ... ] অবজেক্ট

প্রিসেট

preset_name স্ট্রিং

প্রয়োজন।

প্রিসেটের জন্য অভ্যন্তরীণ নাম। এই নামটি অ-ব্যবহারকারী-বান্ধব হতে পারে এবং সমস্ত ভাষা জুড়ে শেয়ার করা হয়৷

preset_name_synonyms অ্যারে

প্রয়োজন।

প্রতিটি সমর্থিত ভাষায় প্রিসেটের জন্য সমার্থক নাম।

[ item, ... ] অবজেক্ট

প্রদত্ত ভাষায় প্রিসেটের সমার্থক নাম।

synonyms অ্যারে

প্রয়োজন।

প্রিসেটের জন্য সমার্থক নাম। যদি প্রযোজ্য হয় তাহলে সমার্থক শব্দে একবচন এবং বহুবচন উভয় রূপই অন্তর্ভুক্ত করা উচিত।

[ item, ... ] স্ট্রিং

সমার্থক নাম

lang স্ট্রিং

প্রয়োজন।

ভাষার কোড (ISO 639-1)। সমর্থিত ভাষা দেখুন।

উদাহরণ

জল সরবরাহকারী যা প্রিসেট সহ তরলগুলির জন্য ইউনিট সমর্থন করে।

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

ডিভাইস STATES

এই বৈশিষ্ট্য সহ ডিভাইসগুলি QUERY অপারেশনের অংশ হিসাবে নিম্নলিখিত রাজ্যগুলির রিপোর্ট করতে পারে৷ QUERY অভিপ্রায় পরিচালনার বিষয়ে আরও জানতে, অভিপ্রায় পূরণ দেখুন৷

রাজ্যগুলি টাইপ বর্ণনা
dispenseItems অ্যারে

ডিভাইসটি বিতরণ করতে পারে এমন আইটেমগুলির অবস্থা।

[ item, ... ] অবজেক্ট

প্রদত্ত আইটেমের অবস্থা।

itemName স্ট্রিং

item_name বৈশিষ্ট্য থেকে আইটেমের নাম।

amountRemaining অবজেক্ট

ডিভাইসে থাকা আইটেমের পরিমাণ। ডিভাইসটি বর্তমানে বিতরণ করা হলে, এটি অবশিষ্ট পরিমাণ বা ডিভাইসটি বিতরণ শেষ হলে কত পরিমাণ হবে তা রিপোর্ট করে।

amount সংখ্যা

অবশিষ্ট পরিমাণ

unit স্ট্রিং

supported_units অ্যাট্রিবিউট থেকে amount জন্য একক।

amountLastDispensed অবজেক্ট

সেই আইটেমের পরিমাণ যা ডিভাইসটি সম্প্রতি বিতরণ করেছে৷ ডিভাইসটি বর্তমানে বিতরণ করা হলে, এটি বর্তমান বিতরণের পরিমাণের আগে এটি বিতরণ করা পরিমাণের প্রতিবেদন করা উচিত।

amount সংখ্যা

অবশিষ্ট পরিমাণ

unit স্ট্রিং

supported_units অ্যাট্রিবিউট থেকে amount জন্য একক।

isCurrentlyDispensing বুলিয়ান

ডিভাইসটি বর্তমানে এই আইটেমটি বিতরণ করছে কিনা তা নির্দেশ করে৷

উদাহরণ

আমার ডিসপেনসারে কতগুলো কুকুরের ট্রিট বাকি আছে?

{
  "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 DispenseItems অ্যাট্রিবিউটের একটি আইটেমের সাথে সঙ্গতিপূর্ণ হতে হবে।

ডিভাইস কমান্ড

এই বৈশিষ্ট্য সহ ডিভাইসগুলি EXECUTE অপারেশনের অংশ হিসাবে নিম্নলিখিত কমান্ডগুলিতে সাড়া দিতে পারে। EXECUTE intents হ্যান্ডলিং সম্পর্কে আরও জানতে, Intent completement দেখুন।

action.devices.commands.Dispense

আইটেম বিতরণ.

পরামিতি

পেলোডে নিম্নলিখিতগুলির মধ্যে একটি রয়েছে:

পরিমাণ দ্বারা বিতরণ.

পরামিতি টাইপ বর্ণনা
item স্ট্রিং

item_name বৈশিষ্ট্য থেকে বিতরণ করা আইটেমের নাম।

amount সংখ্যা

প্রয়োজন।

বিতরণ করার পরিমাণ।

unit স্ট্রিং

প্রয়োজন।

supported_units অ্যাট্রিবিউট থেকে amount জন্য একক।

প্রিসেট দ্বারা বিতরণ.

পরামিতি টাইপ বর্ণনা
presetName স্ট্রিং

প্রয়োজন।

preset_name অ্যাট্রিবিউট থেকে বিতরণ করার জন্য প্রিসেটের নাম।

পরামিতি ছাড়া বিতরণ.

পরামিতি টাইপ বর্ণনা

কোনো বৈশিষ্ট্য নেই

উদাহরণ

আমাকে 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 : ব্যবহারকারীরা একটি আইটেম বিতরণ করার চেষ্টা করে কিন্তু ডিভাইসটি ব্যস্ত (জেনেরিক)।

ডিভাইসের ব্যতিক্রম

এই ব্যতিক্রমগুলি আপনার প্রতিক্রিয়ার states অবজেক্টে একটি exceptionCode কোড হিসাবে রিপোর্ট করা যেতে পারে:

  • amountRemainingLow অবশিষ্ট কম - ব্যবহারকারী ডিভাইস থেকে একটি আইটেম বা পরিমাণ বিতরণ করে যা অবশিষ্ট পরিমাণকে নিম্ন স্তরে নিয়ে আসে। আপনি একটি "নিম্ন" স্তর গঠন কি সংজ্ঞায়িত করার জন্য দায়ী.
  • userNeedsToWait - যখন ব্যবহারকারীকে অনুরোধ করা আইটেম বা পরিমাণ সফলভাবে বিতরণ করার আগে অপেক্ষা করতে হয় (উদাহরণস্বরূপ, একটি কল গরম জল সরবরাহ করবে তবে ব্যবহারকারীকে বিতরণ শুরু করার আগে জল গরম হওয়ার জন্য অপেক্ষা করতে হবে)।