স্মার্ট হোম ভলিউম বৈশিষ্ট্য স্কিমা

action.devices.traits.Volume - এই বৈশিষ্ট্যটি এমন ডিভাইসগুলির অন্তর্গত যা ভলিউম পরিবর্তন করতে সক্ষম (উদাহরণস্বরূপ, ভলিউম একটি নির্দিষ্ট স্তরে সেট করা, নিঃশব্দ বা আনমিউট)।

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

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

গুণাবলী টাইপ বর্ণনা
volumeMaxLevel পূর্ণসংখ্যা

প্রয়োজন।

সর্বাধিক ভলিউম স্তর, 0 (নিঃশব্দ) একটি বেসলাইন ধরে নিয়ে। সহকারী তদনুসারে ক্রিয়াবিশেষণ কমান্ডগুলিকে সামঞ্জস্য করবে (যেমন 'টিভিটিকে একটু জোরে করুন')।

volumeCanMuteAndUnmute বুলিয়ান

প্রয়োজন।

ডিভাইসটি নিঃশব্দ এবং ভলিউম আনমিউট করতে পারে কিনা তা নির্দেশ করে৷ নিঃশব্দ একটি পৃথক বিকল্প কারণ 'নিঃশব্দ' আচরণ পূর্ববর্তী ভলিউম মনে রাখার সময় ভলিউমকে 0 এ নিয়ে যায়, যাতে আনমিউট এটি পুনরুদ্ধার করে। এটি ভলিউম স্থিতিতে প্রতিফলিত হয়-যদি ভলিউম 5 হয় এবং ব্যবহারকারী নিঃশব্দ করে, ভলিউমটি 5 থাকে এবং isMuted সত্য।

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

(ডিফল্ট: 40 )

ব্যবহারকারী বা প্রস্তুতকারকের দ্বারা সংজ্ঞায়িত ডিফল্ট ভলিউমের ভলিউম (শতাংশে)। স্কেল 0-100 হতে হবে।

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

(ডিফল্ট: 1 )

আপেক্ষিক ভলিউম প্রশ্নের জন্য ডিফল্ট ধাপ আকার যেমন 'ভলিউম আপ <device_name>-এ।

commandOnlyVolume বুলিয়ান

(ডিফল্ট: false )

ডিভাইসটি একমুখী (সত্য) বা দ্বিমুখী (মিথ্যা) যোগাযোগ ব্যবহার করে কাজ করে কিনা তা নির্দেশ করে। উদাহরণস্বরূপ, অনুরোধ পাঠানোর পরে কন্ট্রোলার নতুন ডিভাইসের অবস্থা নিশ্চিত করতে পারলে, এই ক্ষেত্রটি মিথ্যা হবে। অনুরোধটি সফলভাবে সম্পাদিত হয়েছে কিনা বা ডিভাইসের অবস্থা (উদাহরণস্বরূপ, যদি ডিভাইসটি একটি ঐতিহ্যগত ইনফ্রারেড রিমোট হয়) নিশ্চিত করা সম্ভব না হয়, তাহলে এই ক্ষেত্রটিকে সত্যে সেট করুন।

উদাহরণ

স্পিকার ডিভাইস যা নিঃশব্দ করা যেতে পারে এবং বর্তমান অবস্থা রিপোর্ট করে

{
  "volumeMaxLevel": 11,
  "volumeCanMuteAndUnmute": true,
  "levelStepSize": 2,
  "commandOnlyVolume": false,
  "volumeDefaultPercentage": 6
}

ডিভাইস STATES

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

রাজ্যগুলি টাইপ বর্ণনা
currentVolume পূর্ণসংখ্যা

প্রয়োজন।

বর্তমান ভলিউম শতাংশ। এটি অবশ্যই >0 এবং volumeMaxLevel এর মধ্যে হতে হবে।

isMuted বুলিয়ান

volumeCanMuteAndUnmute অ্যাট্রিবিউট সত্যে সেট করা থাকলে প্রয়োজন। ডিভাইসটি নিঃশব্দ হলে সত্য; অন্যথায় মিথ্যা। যদি isMuted সত্য হয়, ডিভাইসটি এখনও মনে রাখা পয়েন্টের জন্য currentVolume প্রদান করে।

উদাহরণ

স্পিকার ডিভাইস যা নিঃশব্দ করা যেতে পারে এবং বর্তমান অবস্থা রিপোর্ট করে

{
  "currentVolume": 5,
  "isMuted": false
}

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

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

action.devices.commands.mute

ডিভাইসটি মিউট বা আনমিউট করুন।

পরামিতি

পরামিতি টাইপ বর্ণনা
mute বুলিয়ান

প্রয়োজন।

একটি ডিভাইস নিঃশব্দ বা একটি ডিভাইস আনমিউট কিনা.

উদাহরণ

স্পিকার ডিভাইস নিঃশব্দ করুন

{
  "command": "action.devices.commands.mute",
  "params": {
    "mute": true
  }
}

action.devices.commands.setVolume

ভলিউম volumeMaxLevel উপর ভিত্তি করে অনুরোধ করা স্তরে ভলিউম সেট করুন।

পরামিতি

পরামিতি টাইপ বর্ণনা
volumeLevel পূর্ণসংখ্যা

প্রয়োজন।

নতুন ভলিউম, 0 থেকে volumeMaxLevel পর্যন্ত।

উদাহরণ

স্পিকার ডিভাইসের পরম ভলিউম সেট করুন

{
  "command": "action.devices.commands.setVolume",
  "params": {
    "volumeLevel": 6
  }
}

action.devices.commands.volumeRelative

volumeMaxLevel উপর ভিত্তি করে ভলিউম আপ বা ডাউন n ধাপ সেট করুন। যে কমান্ডগুলি একটি আপেক্ষিক স্কেল ব্যবহার করে, সহকারী উপলভ্য পদক্ষেপগুলিতে স্কেল করার জন্য যথাযথভাবে n নির্বাচন করবে। উদাহরণস্বরূপ, টিভিটিকে আরও জোরে করুন টিভিকে একটু জোরে করার চেয়ে উচ্চ সংখ্যক ধাপ সেট করবে।

পরামিতি

পরামিতি টাইপ বর্ণনা
relativeSteps পূর্ণসংখ্যা

প্রয়োজন।

'কমানোর' জন্য নেতিবাচক।

উদাহরণ

শুধুমাত্র কমান্ড মোডে স্পিকার ডিভাইসের আপেক্ষিক ভলিউম সেট করুন

{
  "command": "action.devices.commands.volumeRelative",
  "params": {
    "relativeSteps": -1
  }
}

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

ত্রুটি এবং ব্যতিক্রমগুলির সম্পূর্ণ তালিকা দেখুন।
  • volumeAlreadyMax : ডিভাইসটি VolumeUp কমান্ড পায় যখন এটি ইতিমধ্যেই সর্বোচ্চ ভলিউমে থাকে।
  • volumeAlreadyMin : ডিভাইসটি VolumeDown কমান্ড পায় যখন এটি ইতিমধ্যেই সর্বনিম্ন ভলিউমে থাকে।