הסכימה של מאפיין 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": {}
}

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

  • Ändere den Eingangskanal auf AUX .
  • change input mode to HDMI 1
  • cambia a hdmi 1
  • Activation du mode HDMI1 .
  • Mets la télé sur HDMI 1 .
  • टीवी की इनपुट HDMI 1 में स्विच करो
  • metti ingresso aux sulla tv
  • テレビ HDMI1 にして
  • TV HDMI 1 로 바꿔 줘
  • zet de TV op bluetooth
  • Muda a entrada da TV para HDMI2 .
  • mudar a entrada para AUX
  • Sätt på hdmi 1

שגיאות במכשיר

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

unsupportedInput: אין כרגע תמיכה בקלט הזה.