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

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

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

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

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

דוגמאות

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

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

מצבי המכשיר

ישויות עם התכונה הזו עשויות לדווח על הנושאים הבאים כחלק מהפעולה QUERY. למידה מידע נוסף על טיפול בכוונות של QUERY: מילוי Intent.

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

דוגמאות

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

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

CommandS במכשיר

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

action.devices.commands.mute

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

פרמטרים

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

דוגמאות

השתקת הרמקול

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

action.devices.commands.setVolume

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

פרמטרים

פרמטרים	סוג	תיאור
volumeLevel	Integer	חובה. עוצמת קול חדשה, מ-0 עד volumeMaxLevel.

דוגמאות

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

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

action.devices.commands.volumeRelative

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

פרמטרים

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

דוגמאות

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

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

ERRORS במכשיר

ראה את הרשימה המלאה של שגיאות וחריגים.

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