הסכימה של מאפיין InputSelector לבית חכם

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

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

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

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

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

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

מאפיינים סוג תיאור
availableInputs מערך

חובה.

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

[item, ...] אובייקט

קלט זמין.

key String

חובה.

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

names מערך

חובה.

רשימת שמות לקלט בכל השפות הזמינות.

[item, ...] אובייקט

קלט עבור שפה זמינה נתונה.

lang String

חובה.

קוד השפה.

name_synonym מערך

חובה.

שמות ידידותיים למשתמש של הקלט, בשפה נתונה. המילה הנרדפת הראשונה מופיעה בתשובה של Google Assistant למשתמש.

[item, ...] String

מזינים שם.

commandOnlyInputSelector בוליאני

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

השדה הזה מציין אם המכשיר תומך בתקשורת חד-כיוונית (true) או דו-כיוונית (false). מגדירים את המאפיין הזה כ-true אם המכשיר לא יכול להגיב לכוונה מסוג 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, ראו ביצוע כוונות.

מדינות סוג תיאור
currentInput String

חובה.

המפתח של הקלט הנוכחי.

דוגמאות

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

{
  "currentInput": "hdmi_1"
}

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

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

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: אין כרגע תמיכה בקלט הזה.