স্মার্ট হোম রোটেশন ট্রেইট স্কিমা

action.devices.traits.Rotation - এই ট্রেইটটি সেইসব ডিভাইসের অন্তর্গত যেগুলো ঘূর্ণন সমর্থন করে।

ঘূর্ণন শতাংশ বা ডিগ্রিতে নির্দিষ্ট করা যেতে পারে এবং যদি ডিভাইসটি ডিগ্রিতে ঘূর্ণন সমর্থন করে, তবে ঘূর্ণনের ডিফল্ট দিক হবে ঘড়ির কাঁটার দিকে।

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

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

বৈশিষ্ট্য প্রকার বর্ণনা
supportsDegrees বুলিয়ান

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

ডিভাইসটি ডিগ্রি অনুসারে ঘোরানোর অনুমতি দিলে এটিকে 'true' সেট করুন।

supportsPercent বুলিয়ান

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

ডিভাইসটি শতাংশ অনুযায়ী ঘোরানোর অনুমতি দিলে এটিকে 'true' সেট করুন।

rotationDegreesRange বস্তু

একটি ডিভাইস যে পরিসরে ঘুরতে পারে, তা ডিগ্রিতে প্রকাশ করুন।

rotationDegreesMin সংখ্যা

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

ডিগ্রিতে সর্বনিম্ন ঘূর্ণন।

মান অবশ্যই 0 থেকে 360 মধ্যে হতে হবে।

rotationDegreesMax সংখ্যা

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

ডিগ্রিতে সর্বোচ্চ ঘূর্ণন।

মান অবশ্যই 0 থেকে 360 মধ্যে হতে হবে।

supportsContinuousRotation বুলিয়ান

(ডিফল্ট: false )

ডিভাইসটি অবিচ্ছিন্ন ঘূর্ণনের অনুমতি দিলে এটিকে 'true' সেট করুন। একটি আপেক্ষিক কোয়েরি দেওয়া হলে, RotateAbsolute কমান্ডটি সমর্থিত ঘূর্ণন পরিসরের মধ্যে পর্যায়ক্রমে ঘুরবে।

commandOnlyRotation বুলিয়ান

(ডিফল্ট: false )

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

উদাহরণ

যে ডিভাইসটি শতাংশ এবং ডিগ্রি উভয় এককে ঘূর্ণন সমর্থন করে।

{
  "supportsDegrees": true,
  "supportsPercent": true,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 180
  }
}

যে ডিভাইসটি শুধু ডিগ্রিতে ঘূর্ণন সমর্থন করে।

{
  "supportsDegrees": true,
  "supportsPercent": false,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 90
  }
}

যে ডিভাইসটি শুধুমাত্র অবিচ্ছিন্ন ঘূর্ণন কমান্ড সমর্থন করে।

{
  "supportsDegrees": true,
  "supportsPercent": true,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 360
  },
  "supportsContinuousRotation": true,
  "commandOnlyRotation": true
}

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

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

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

rotationDegreesRange মধ্যে বর্তমান স্তর, যা নির্দেশ করে ডিভাইসটি কত ডিগ্রি ঘোরানো হয়েছে। এই মানটি সর্বদা ঘড়ির কাঁটার দিকে ঘূর্ণনের সাপেক্ষে হওয়া উচিত।

rotationPercent সংখ্যা

বর্তমান স্তর যা নির্দেশ করে ডিভাইসটি বর্তমানে কত শতাংশ ঘোরানো আছে। ০.০ মানে বন্ধ এবং ১০০.০ মানে খোলা।

মান অবশ্যই 0 থেকে 100 মধ্যে হতে হবে।

targetRotationPercent সংখ্যা

স্তরটি ঘূর্ণনের শতাংশ নির্দেশ করে, যেখানে চলমান ঘূর্ণন পরিবর্তনের ফলে ডিভাইসটি যাবে বা যাচ্ছে।

মান অবশ্যই 0 থেকে 100 মধ্যে হতে হবে।

উদাহরণ

যন্ত্রটি কতটুকু ঘোরানো হয়েছে? (শতাংশ এবং ডিগ্রিতে)।

{
  "rotationDegrees": 45,
  "rotationPercent": 25
}

ডিভাইসটি কতটুকু ঘোরানো হয়েছে? (শুধুমাত্র ডিগ্রিতে)।

{
  "rotationDegrees": 45
}

ডিভাইসটি কতটুকু ঘোরানো হয়? (ধারাবাহিকভাবে)।

{
  "rotationDegrees": 270,
  "rotationPercent": 75
}

একটি ডিভাইস বর্তমানে একটি নতুন অবস্থানে ঘুরছে (শতাংশ)।

{
  "rotationPercent": 75,
  "targetRotationPercent": 100
}

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

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

action.devices.commands.RotateAbsolute

ডিভাইসটির পরম ঘূর্ণন নির্ধারণ করুন।

প্যারামিটার

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

পরম ঘূর্ণন ডিগ্রিতে নির্ধারণ করুন।

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

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

একটি পরম মান, যা ডিগ্রিতে পরিমাপ করা হয় এবং ডিভাইসটির চূড়ান্ত ঘড়ির কাঁটার দিকে ঘূর্ণন নির্দিষ্ট করে। মানটি অবশ্যই rotationDegreesRange অ্যাট্রিবিউটের মধ্যে থাকতে হবে।

পরম ঘূর্ণন শতাংশে নির্ধারণ করুন।

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

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

শতাংশে প্রকাশিত একটি পরম মান, যা ডিভাইসটির চূড়ান্ত ঘূর্ণন নির্দিষ্ট করে।

মান অবশ্যই 0 থেকে 100 মধ্যে হতে হবে।

উদাহরণ

ডিভাইসটি ৫০ শতাংশে কাত করুন।

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationPercent": 50
  }
}

ডিভাইসটিকে ঘড়ির কাঁটার বিপরীত দিকে ১৫ ডিগ্রি ঘোরান ( rotationDegrees: 45 )।

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 30
  }
}

ডিভাইসটিকে ঘড়ির কাঁটার দিকে ১০০ ডিগ্রী ঘোরান ( supportsContinuousRotation: true , rotationDegrees: 270 )।

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 10
  }
}

ডিভাইসটির ঘূর্ণন নির্ধারণ করতে একটি ত্রুটি ঘটেছে।

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

deviceJammingDetected

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

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