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

action.devices.traits.Volume – המאפיין הזה שייך למכשירים שאפשר לשנות בהם את עוצמת הקול (לדוגמה, הגדרת עוצמת הקול לרמה מסוימת, השבתת הקול או הפעלת הקול).

מאפייני המכשיר

מכשירים עם המאפיין הזה עשויים לדווח על המאפיינים הבאים כחלק מהפעולה SYNC. למידע נוסף על טיפול באובייקטים של SYNC, ראו מימוש של Intent.

דוגמאות

רמקול שאפשר להשתיק ושהוא מדווח על המצב הנוכחי

{
  "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 כשעוצמת הקול כבר נמוכה ככל האפשר.