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

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

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

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

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

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

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

מאפיינים	סוג	תיאור
availableInputs	מערך	חובה. רשימת אובייקטים שמייצגים פידים של אודיו או וידאו. העדכונים יכולים להיות בחיבור קווי או ברשת. צריך לתת שם לכל פיד ולהקפיד על עקביות באופן סביר. חשוב להגדיר בקפידה את המילים הנרדפות כדי למנוע טריגרים לא רצויים (יותר מדי).
[item, ...]	אובייקט	קלט זמין.
key	String	חובה. מפתח ייחודי לקלט. אין לחשוף את המפתח למשתמשים בדיבור או בתגובה.
names	מערך	חובה. רשימת שמות עבור הקלט בכל השפות הזמינות.
[item, ...]	אובייקט	קלט לשפה זמינה נתונה.
lang	String	חובה. קוד שפה.
name_synonym	מערך	חובה. שמות ידידותיים למשתמש לקלט, בשפה נתונה. המילה הנרדפת הראשונה מופיעה בתגובת Google Assistant למשתמש.
[item, ...]	String	שם קלט.
commandOnlyInputSelector	בוליאני	(ברירת המחדל: false) הערך הזה מציין אם המכשיר תומך בתקשורת חד-כיוונית (true) או בתקשורת דו-כיוונית (לא נכונה). יש להגדיר את המאפיין הזה כ-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
}

מכשיר STATES

ישויות עם התכונה הזו עשויות לדווח על המצבים הבאים כחלק מהפעולה 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: הקלט לא נתמך כרגע.