طرحواره ویژگی حجم خانه هوشمند

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

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

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

مثال‌ها

دستگاه بلندگو که می‌تواند بی‌صدا شود و وضعیت فعلی را گزارش دهد

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

وضعیت دستگاه

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

مثال‌ها

دستگاه بلندگو که می‌تواند بی‌صدا شود و وضعیت فعلی را گزارش دهد

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

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

دستگاه‌هایی که این ویژگی را دارند، می‌توانند به دستورات زیر به عنوان بخشی از عملیات EXECUTE پاسخ دهند. برای کسب اطلاعات بیشتر در مورد مدیریت اهداف EXECUTE ، به بخش «تحقق اهداف» مراجعه کنید.

action.devices.commands.mute

دستگاه را بی‌صدا یا بی‌صدا می‌کند.

پارامترها

مثال‌ها

بی‌صدا کردن بلندگوی دستگاه

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

action.devices.commands.setVolume

میزان صدا را بر اساس volumeMaxLevel ، روی سطح درخواستی تنظیم کنید.

پارامترها

مثال‌ها

تنظیم صدای مطلق دستگاه بلندگو

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

action.devices.commands.volumeRelative

بر اساس volumeMaxLevel ، صدا را n مرحله افزایش یا کاهش دهید. برای دستوراتی که از مقیاس نسبی استفاده می‌کنند، دستیار n را به طور مناسب انتخاب می‌کند تا با مراحل موجود مقیاس‌بندی شود. به عنوان مثال، «تلویزیون را خیلی بلندتر کن» تعداد مراحل بیشتری را نسبت به «تلویزیون را کمی بلندتر کن» تنظیم می‌کند.

پارامترها

مثال‌ها

تنظیم میزان نسبی صدای بلندگو در حالت فقط با فرمان

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

خطاهای دستگاه

• volumeAlreadyMax : دستگاه دستور VolumeUp را زمانی دریافت می‌کند که در بالاترین سطح صدا قرار دارد.
• volumeAlreadyMin : دستگاه دستور VolumeDown را زمانی دریافت می‌کند که در حال حاضر در پایین‌ترین سطح صدا قرار دارد.