স্মার্ট হোম টাইমার বৈশিষ্ট্য স্কিমা

action.devices.traits.Timer - Timer ট্রেইটটি কোনো ডিভাইসের টাইমারকে নির্দেশ করে।

উদাহরণস্বরূপ, একটি স্মার্ট স্প্রিংকলার কন্ট্রোলার বা স্মার্ট লাইট সুইচে একটি বিল্ট-ইন টাইমার থাকতে পারে। এই বৈশিষ্ট্যটি ব্যবহার করে ডিভাইসগুলোর বিল্ট-ইন টাইমার নিয়ন্ত্রণ করা যায়, যেমন—নতুন টাইমার চালু করা, চলমান টাইমার থামানো ও বাতিল করা এবং কত সময় বাকি আছে তা জিজ্ঞাসা করা।

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

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

বৈশিষ্ট্য প্রকার বর্ণনা
maxTimerLimitSec পূর্ণসংখ্যা

প্রয়োজনীয়।

ডিভাইসটিতে উপলব্ধ দীর্ঘতম টাইমার সেটিং নির্দেশ করে, যা সেকেন্ডে পরিমাপ করা হয়।

সর্বনিম্ন মান: 1 ।

commandOnlyTimer বুলিয়ান

(ডিফল্ট: false )

ডিভাইসটি একমুখী (true) নাকি দ্বিমুখী (false) যোগাযোগ সমর্থন করে, তা নির্দেশ করে। যদি ডিভাইসটি এই ট্রেইটের জন্য কোনো QUERY ইন্টেন্ট বা রিপোর্ট স্টেটে সাড়া দিতে না পারে, তবে এই অ্যাট্রিবিউটটিকে true-তে সেট করুন।

উদাহরণ

দুই ঘণ্টার টাইমার সীমাযুক্ত ডিভাইস।

{
  "maxTimerLimitSec": 7200
}

ডিভাইসের অবস্থা

এই বৈশিষ্ট্যযুক্ত সত্তাগুলো QUERY অপারেশনের অংশ হিসেবে নিম্নলিখিত অবস্থাগুলো রিপোর্ট করতে পারে। QUERY ইনটেন্ট পরিচালনা সম্পর্কে আরও জানতে, ইনটেন্ট ফুলফিলমেন্ট দেখুন।

রাজ্যগুলি প্রকার বর্ণনা
timerRemainingSec পূর্ণসংখ্যা

প্রয়োজনীয়।

অবশিষ্ট সময় সেকেন্ডে, -১, অথবা [০, maxTimerLimitSec ]। কোনো টাইমার চলছে না বোঝাতে -১ সেট করুন।

timerPaused বুলিয়ান

যদি একটি সক্রিয় টাইমার থাকে কিন্তু বর্তমানে সেটি বিরতি দেওয়া অবস্থায় থাকে, তবে সত্য।

উদাহরণ

ডিভাইস টাইমারে আর কত সময় বাকি আছে? (চলছে না)।

{
  "timerRemainingSec": -1
}

ডিভাইস টাইমারে আর কত সময় বাকি আছে? (চলমান)।

{
  "timerRemainingSec": 60
}

ডিভাইস টাইমারে আর কত সময় বাকি আছে? (বিরতি দেওয়া)।

{
  "timerRemainingSec": 30,
  "timerPaused": true
}

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

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

action.devices.commands.TimerStart

একটি নতুন টাইমার চালু করুন।

প্যারামিটার

প্যারামিটার প্রকার বর্ণনা
timerTimeSec পূর্ণসংখ্যা

প্রয়োজনীয়।

টাইমারের সময়কাল সেকেন্ডে; অবশ্যই [1, maxTimerLimitSec ]-এর মধ্যে হতে হবে।

সর্বনিম্ন মান: 1 ।

উদাহরণ

পাঁচ মিনিটের জন্য ডিভাইস টাইমারটি চালু করুন।

{
  "command": "action.devices.commands.TimerStart",
  "params": {
    "timerTimeSec": 300
  }
}

টাইমার চালু করতে একটি ত্রুটি ঘটেছে।

সমর্থিত মানসমূহ:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerAdjust

টাইমারের সময়কাল সামঞ্জস্য করুন।

প্যারামিটার

প্যারামিটার প্রকার বর্ণনা
timerTimeSec পূর্ণসংখ্যা

প্রয়োজনীয়।

সেকেন্ডে টাইমারের ধনাত্মক বা ঋণাত্মক সমন্বয়; অবশ্যই [ -maxTimerLimitSec , maxTimerLimitSec ] এর মধ্যে হতে হবে।

উদাহরণ

ডিভাইস টাইমারে এক মিনিট যোগ করুন।

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": 60
  }
}

ডিভাইস টাইমার থেকে ৩০ সেকেন্ড বিয়োগ করে।

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": -30
  }
}

টাইমার সমন্বয় করতে গিয়ে একটি ত্রুটি ঘটেছে।

সমর্থিত মানসমূহ:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerPause

টাইমার থামান।

প্যারামিটার

প্যারামিটার প্রকার বর্ণনা

কোন সম্পত্তি নেই

উদাহরণ

ডিভাইস টাইমারটি থামান।

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

টাইমারটি বিরতি দেওয়ার সময় একটি ত্রুটি ঘটেছে।

সমর্থিত মানসমূহ:

noTimerExists

action.devices.commands.TimerResume

টাইমার পুনরায় চালু করুন।

প্যারামিটার

প্যারামিটার প্রকার বর্ণনা

কোন সম্পত্তি নেই

উদাহরণ

ডিভাইস টাইমারটি পুনরায় চালু করুন।

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

টাইমারটি পুনরায় চালু করতে একটি ত্রুটি ঘটেছে।

সমর্থিত মানসমূহ:

noTimerExists

action.devices.commands.TimerCancel

টাইমারটি বাতিল করুন।

প্যারামিটার

প্যারামিটার প্রকার বর্ণনা

কোন সম্পত্তি নেই

উদাহরণ

ডিভাইস টাইমারটি বন্ধ করুন। 

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

টাইমার বন্ধ করার সময় একটি ত্রুটি ঘটেছে।

সমর্থিত মানসমূহ:

noTimerExists

ডিভাইসের ত্রুটি

ত্রুটি ও ব্যতিক্রমগুলির সম্পূর্ণ তালিকা দেখুন।