הסכימה של מאפיין נפח הקול בבית חכם

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

הגדרת עוצמת הקול ב-n שלבים, על סמך volumeMaxLevel. בפקודות שמשתמשות בסולם יחסי, Assistant תבחר את הערך של n בהתאם למספר השלבים הזמינים. לדוגמה, הפקודה הגברת עוצמת הקול בטלוויזיה הרבה תגדיר מספר שלבים גבוה יותר מהפקודה הגברת עוצמת הקול בטלוויזיה קצת.

פרמטרים

דוגמאות

הגדרת עוצמת הקול היחסית של מכשיר הרמקולים במצב 'פקודה בלבד'

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

שגיאות במכשיר

• volumeAlreadyMax: המכשיר מקבל את הפקודה VolumeUp כשהוא כבר בעוצמת הקול הגבוהה ביותר.
• volumeAlreadyMin: המכשיר מקבל את הפקודה VolumeDown כשעוצמת הקול כבר נמוכה ככל האפשר.