סכימה של תכונות עוצמת הקול בבית החכם

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

ATTRIBUTES במכשיר

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

מאפיינים	Type	תיאור
volumeMaxLevel	Integer	חובה. עוצמת הקול המקסימלית, בהנחה שהבסיס שהוגדר הוא 0 (השתקה). Assistant תשנה את הפקודות המילוליות (למשל, 'הגברת עוצמת הקול של הטלוויזיה') בהתאם.
volumeCanMuteAndUnmute	בוליאני	חובה. מציינת אם המכשיר יכול להשתיק או לבטל את ההשתקה של עוצמת הקול. השתקה היא אפשרות נפרדת מפני שההתנהגות 'השתקה' מחליפה את עוצמת הקול ל-0 בעת שמירת עוצמת הקול הקודמת, כך שביטול ההשתקה משחזר אותה. הבעיה מתבטאת במצב עוצמת הקול – אם עוצמת הקול היא 5 והמשתמש מושתק, עוצמת הקול נשארת 5 ו-isMuted נכון.
volumeDefaultPercentage	Integer	(ברירת מחדל: 40) עוצמת הקול (באחוזים) של עוצמת הקול שהוגדרה כברירת מחדל על ידי המשתמש או היצרן. קנה המידה חייב להיות בין 0 ל-100.
levelStepSize	Integer	(ברירת מחדל: 1) גודל השלב המוגדר כברירת מחדל לשאילתות עם נפח יחסי, כמו 'הגברת עוצמת הקול ב-<device_name>'
commandOnlyVolume	בוליאני	(ברירת מחדל: false) מציין אם המכשיר פועל באמצעות תקשורת חד-כיוונית (אמיתי) או דו-כיווני (לא נכון). לדוגמה, אם הבקר יכול לאשר את המצב של המכשיר החדש לאחר שליחת הבקשה, השדה הזה יהיה false. אם לא ניתן לאשר אם הבקשה בוצעה בהצלחה או להציג את מצב המכשיר (לדוגמה, אם המכשיר הוא שלט אינפרה-אדום מסורתי), מגדירים את השדה הזה כ-true.

דוגמאות

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

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

מצבים של המכשיר

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

מדינות	Type	תיאור
currentVolume	Integer	חובה. עוצמת הקול הנוכחית. עליה להיות בין >0 ל-volumeMaxLevel.
isMuted	בוליאני	חובה אם המאפיין volumeCanMuteAndUnmute מוגדר כ-True. הערך הוא True אם המכשיר מושתק; לא נכון. אם הערך הוא isMuted נכון, המכשיר עדיין יחזיר currentVolume עבור הנקודה שהוזכרו.

דוגמאות

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

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

פקודות מכשיר

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

action.devices.commands.mute

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

פרמטרים

פרמטרים	Type	תיאור
mute	בוליאני	חובה. האם להשתיק מכשיר או לבטל את ההשתקה שלו.

דוגמאות

השתקת מכשיר הרמקול

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

action.devices.commands.setVolume

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

פרמטרים

פרמטרים	Type	תיאור
volumeLevel	Integer	חובה. כרך חדש, מ-0 עד volumeMaxLevel.

דוגמאות

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

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

action.devices.commands.volumeRelative

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

פרמטרים

פרמטרים	Type	תיאור
relativeSteps	Integer	חובה. שלילי עבור 'הקטנה'.

דוגמאות

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

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

ERRORS מכשיר

לצפייה ברשימה המלאה של השגיאות והחריגים

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