طرحواره صفت حجم خانه هوشمند

action.devices.traits.Volume - این ویژگی متعلق به دستگاه هایی است که می توانند صدا را تغییر دهند (به عنوان مثال، تنظیم صدا در یک سطح خاص، بی صدا یا لغو صدا).

ویژگی های دستگاه

دستگاه های دارای این ویژگی ممکن است ویژگی های زیر را به عنوان بخشی از عملیات SYNC گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد SYNC ، به تحقق هدف مراجعه کنید.

ویژگی های	تایپ کنید	شرح
volumeMaxLevel	عدد صحیح	ضروری. حداکثر سطح صدا، با فرض خط پایه 0 (بی صدا). دستیار دستورات قید (مثلاً "تلویزیون را کمی بلندتر کنید") بر این اساس تنظیم می کند.
volumeCanMuteAndUnmute	بولی	ضروری. نشان می‌دهد که آیا دستگاه می‌تواند صدا را قطع و وصل کند یا خیر. بی‌صدا کردن یک گزینه جداگانه است، زیرا رفتار "موت" صدا را در حین به خاطر سپردن ولوم قبلی به 0 می‌رساند، به طوری که لغو بی‌صدا آن را بازیابی می‌کند. این در حالت ولوم منعکس می‌شود—اگر ولوم 5 باشد و کاربر بی‌صدا کند، میزان صدا 5 باقی می‌ماند و isMuted درست است.
volumeDefaultPercentage	عدد صحیح	(پیش‌فرض: 40 ) حجم (در درصد) برای حجم پیش فرض تعریف شده توسط کاربر یا سازنده. مقیاس باید 0-100 باشد.
levelStepSize	عدد صحیح	(پیش‌فرض: 1 ) اندازه گام پیش‌فرض برای جستارهای حجم نسبی مانند «افزایش حجم در <device_name>».
commandOnlyVolume	بولی	(پیش‌فرض: false ) نشان می دهد که آیا دستگاه با استفاده از ارتباط یک طرفه (درست) یا دو طرفه (کاذب) کار می کند. به عنوان مثال، اگر کنترلر بتواند وضعیت دستگاه جدید را پس از ارسال درخواست تأیید کند، این فیلد نادرست خواهد بود. اگر تأیید انجام موفقیت آمیز درخواست یا دریافت وضعیت دستگاه (به عنوان مثال، اگر دستگاه یک کنترل از راه دور مادون قرمز سنتی است) امکان پذیر نیست، این قسمت را روی true تنظیم کنید.

مثال ها

دستگاه بلندگوی قابل قطع و گزارش وضعیت فعلی

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

وضعیت دستگاه

موجودیت های دارای این ویژگی ممکن است وضعیت های زیر را به عنوان بخشی از عملیات QUERY گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد QUERY ، به تحقق هدف مراجعه کنید.

ایالت ها	تایپ کنید	شرح
currentVolume	عدد صحیح	ضروری. درصد حجم فعلی باید بین >0 و volumeMaxLevel باشد.
isMuted	بولی	اگر ویژگی volumeCanMuteAndUnmute روی true تنظیم شده باشد، الزامی است. درست است اگر دستگاه بی صدا باشد. نادرست در غیر این صورت اگر isMuted درست باشد، دستگاه همچنان currentVolume برای نقطه به خاطر سپرده شده برمی گرداند.

مثال ها

دستگاه بلندگوی قابل قطع و گزارش وضعیت فعلی

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

دستورات دستگاه

دستگاه های دارای این ویژگی ممکن است به دستورات زیر به عنوان بخشی از عملیات EXECUTE پاسخ دهند. برای کسب اطلاعات بیشتر در مورد مدیریت EXECUTE intent ها، به اجرای Intent مراجعه کنید.

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 زمانی دریافت می کند که از قبل در کمترین میزان صدا باشد.