סכימת תכונות של בורר קלט לבית חכם

action.devices.traits.InputSelector – התכונה הזו משמשת למכשירים שיכולים להחליף בין מקורות קלט.

קלטי מדיה יכולים לקבל שמות דינמיים לכל מכשיר שמייצגים פידים של אודיו או וידאו. הפידים האלה יכולים להיות בחיבור קווי או ברשת, אבל צריך לתת להם שמות ועקביים באופן סביר. התכונה הזו לא תומכת בפידים זמניים שרירותיים, כמו ספרייה ברשת שניתן לבצע בה חיפוש. מותאם, שם יש תמיכה במקורות Bluetooth. למקורות יכולים להיות כמה שמות, לכן הם נוצרו על ידי המשתמשים והמצאו אותם שמות נתמכים, וכן שמות ברירת מחדל. לדוגמה, 'hdmi_1' יכול להיות גם 'נגן DVD', או 'usb_1' יכול להיות גם 'כונן קשיח'.

אפשר לסדר את קלטי המדיה כך שיתמכו בערך 'הבא' ו'הקודם' פקודות.

בדומה ל-Toggles ול-Modes, השמות צריך לספק נתונים בכל השפות הזמינות, הדבר רלוונטי במיוחד לשמות ברירת מחדל.

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

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

מאפיינים	סוג	תיאור
availableInputs	מערך	חובה. רשימת אובייקטים שמייצגים פידים של אודיו או וידאו של קלט. פידים יכולים להיות בחיבור קווי או ברשת. צריך לתת לכל פיד שם ועקביות באופן סביר. חשוב להגדיר את המילים הנרדפות בקפידה כדי למנוע הפעלה לא רצויה (יותר מדי).
[item, ...]	מפגע	קלט זמין.
key	String	חובה. מקש ייחודי לקלט. אין לחשוף את המפתח למשתמשים בדיבור או בתגובה.
names	מערך	חובה. רשימת שמות לקלט בכל השפות הזמינות.
[item, ...]	מפגע	קלט עבור שפה זמינה נתונה.
lang	String	חובה. קוד שפה.
name_synonym	מערך	חובה. שמות ידידותיים למשתמש לקלט, בשפה נתונה. המילה הנרדפת הראשונה מופיעה בתשובה של Google Assistant למשתמש.
[item, ...]	String	שם קלט.
commandOnlyInputSelector	בוליאני	(ברירת המחדל: false) מציינת אם המכשיר תומך בתקשורת חד-כיוונית (true) או בתקשורת דו-כיוונית (false). יש להגדיר את המאפיין הזה כ-True אם המכשיר לא יכול להגיב ל-Intent QUERY או למצב הדיווח של התכונה הזו.
orderedInputs	בוליאני	(ברירת המחדל: false) הערך הוא True אם רשימת הפלט מסודרת. הדבר מציין גם שהמצב 'הבא' ו'הקודם' פונקציונליות זמינה.

דוגמאות

מכשיר עם שני קלטים לפי סדר מסוים.

{
  "availableInputs": [
    {
      "key": "hdmi_1",
      "names": [
        {
          "lang": "en",
          "name_synonym": [
            "HDMI 1",
            "1st HDMI",
            "DVD Player"
          ]
        },
        {
          "lang": "de",
          "name_synonym": [
            "HDMI 1",
            "Zuerst HDMI",
            "DVD Spieler"
          ]
        }
      ]
    },
    {
      "key": "usb_1",
      "names": [
        {
          "lang": "en",
          "name_synonym": [
            "USB 1",
            "First USB",
            "Hard Drive"
          ]
        },
        {
          "lang": "de",
          "name_synonym": [
            "USB 1",
            "Zuerst USB",
            "Festplatte"
          ]
        }
      ]
    }
  ],
  "orderedInputs": true
}

מצבי המכשיר

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

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

דוגמאות

נבחר כרגע מכשיר עם קלט HDMI.

{
  "currentInput": "hdmi_1"
}

CommandS במכשיר

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

action.devices.commands.SetInput

מגדירים את קלט המדיה.

פרמטרים

פרמטרים	סוג	תיאור
newInput	String	חובה. המקש של הקלט החדש.

דוגמאות

בחירת קלט USB

{
  "command": "action.devices.commands.SetInput",
  "params": {
    "newInput": "usb_1"
  }
}

action.devices.commands.NextInput

בוחרים את הקלט הבא. רלוונטי רק כאשר המאפיין orderedInputs מוגדר כ-True.

פקודה זו דורשת את המאפיינים הבאים:

{
  "orderedInputs": true
}

פרמטרים

פרמטרים	סוג	תיאור
אין נכסים

דוגמאות

ללא פרמטרים

{
  "command": "action.devices.commands.NextInput",
  "params": {}
}

action.devices.commands.PreviousInput

בוחרים את הקלט הקודם. רלוונטי רק כאשר המאפיין orderedInputs מוגדר כ-True.

פקודה זו דורשת את המאפיינים הבאים:

{
  "orderedInputs": true
}

פרמטרים

פרמטרים	סוג	תיאור
אין נכסים

דוגמאות

ללא פרמטרים

{
  "command": "action.devices.commands.PreviousInput",
  "params": {}
}

ביטויים לדוגמה

de-DE

• Ändere den Eingangskanal auf AUX .

en-US

• change input mode to HDMI 1

es-ES

• cambia a hdmi 1

fr-FR

• Activation du mode HDMI1 .
• Mets la télé sur HDMI 1 .

hi-IN

• टीवी की इनपुट HDMI 1 में स्विच करो

it-IT

• metti ingresso aux sulla tv

ja-JP

• テレビ HDMI1 にして

ko-KR

• TV HDMI 1 로 바꿔 줘

nl-NL

• zet de TV op bluetooth

pt-BR

• Muda a entrada da TV para HDMI2 .
• mudar a entrada para AUX

sv-SE

• Sätt på hdmi 1

ERRORS במכשיר

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

unsupportedInput: הקלט לא נתמך כרגע.