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

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

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

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

מאפיינים סוג תיאור
volumeMaxLevel Integer

חובה.

רמת עוצמת הקול המקסימלית, בהנחה שרמת הבסיס היא 0 (השתקה). ‫Assistant ישנה את הפקודות שכוללות תואר פועל (למשל, 'תגביר קצת את הטלוויזיה') בהתאם.
volumeCanMuteAndUnmute בוליאני

חובה.

התנאי מציין אם אפשר להשתיק את עוצמת הקול במכשיר ולבטל את ההשתקה. ההשתקה היא אפשרות נפרדת, כי כשהיא מופעלת עוצמת הקול יורדת ל-0, אבל המערכת זוכרת את העוצמה הקודמת וכשמבטלים את ההשתקה היא חוזרת. הדבר משתקף במצב עוצמת הקול – אם עוצמת הקול היא 5 והמשתמש משתיק את הצליל, עוצמת הקול נשארת 5 והערך של isMuted הוא true.
volumeDefaultPercentage Integer

(ברירת מחדל: 40)

העוצמה (באחוזים) של עוצמת הקול שמוגדרת כברירת מחדל על ידי המשתמש או היצרן. הערך חייב להיות בין 0 ל-100.

הערך צריך להיות בין 0 ל-100.
levelStepSize Integer

(ברירת מחדל: 1)

גודל הצעד שמוגדר כברירת מחדל לשאילתות לגבי עוצמת הקול היחסית, כמו 'הגברת עוצמת הקול ב<שם_המכשיר>'.
commandOnlyVolume בוליאני

(ברירת מחדל: false)

מציין אם המכשיר פועל באמצעות תקשורת חד-כיוונית (true) או דו-כיוונית (false). לדוגמה, אם הבקר יכול לאשר את מצב המכשיר החדש אחרי שליחת הבקשה, הערך בשדה הזה יהיה false. אם אי אפשר לוודא שהבקשה בוצעה בהצלחה או לקבל את מצב המכשיר (לדוגמה, אם המכשיר הוא שלט אינפרא אדום רגיל), צריך להגדיר את השדה הזה כ-true.

דוגמאות

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

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

מצבי המכשיר

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

מדינות סוג תיאור
currentVolume Integer

חובה.

עוצמת הקול הנוכחית באחוזים. הערך חייב להיות בין >0 ל-volumeMaxLevel.

ערך מינימלי: 0.
isMuted בוליאני

חובה אם המאפיין volumeCanMuteAndUnmute מוגדר כ-true. ‫True אם המכשיר מושתק. אחרת, False. אם isMuted הוא true, המכשיר עדיין מחזיר currentVolume עבור הנקודה שנשמרה.

דוגמאות

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

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

פקודות למכשיר

מכשירים עם המאפיין הזה עשויים להגיב לפקודות הבאות כחלק מהפעולה EXECUTE. מידע נוסף על טיפול בכוונות זמין במאמר הגשמת כוונות.EXECUTE

action.devices.commands.mute

השתקה או ביטול ההשתקה של המכשיר.

פרמטרים

פרמטרים סוג תיאור
mute בוליאני

חובה.

האם להשתיק את המכשיר או לבטל את ההשתקה שלו.

דוגמאות

השתקת הרמקול

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

action.devices.commands.setVolume

הגדרת עוצמת הקול לרמה המבוקשת, על סמך volumeMaxLevel.

פרמטרים

פרמטרים סוג תיאור
volumeLevel Integer

חובה.

נפח חדש, מ-0 עד volumeMaxLevel.

ערך מינימלי: 0.

דוגמאות

הגדרת עוצמת קול מוחלטת של רמקול

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

action.devices.commands.volumeRelative

הגדרת עוצמת הקול ב-n שלבים, בהתאם ל-volumeMaxLevel. בפקודות שמשתמשות בסולם יחסי, העוזר הדיגיטלי יבחר את n באופן מתאים כדי להתאים את הסולם לשלבים הזמינים. לדוגמה, הפקודה Make the TV much louder (הגברת עוצמת הקול בטלוויזיה) תגדיר מספר גבוה יותר של שלבים מאשר הפקודה Make the TV a tiny bit louder (הגברת עוצמת הקול בטלוויזיה במעט).

פרמטרים

פרמטרים סוג תיאור
relativeSteps Integer

חובה.

שלילי אם יש ירידה.

דוגמאות

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

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

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

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