Smart Home AppSelector Trait Schema

‫action.devices.traits.AppSelector – התכונה הזו משמשת למכשירים שיכולים לעבור בין אפליקציות.

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

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

מאפיינים	סוג	תיאור
availableApplications	מערך	חובה. רשימת האפליקציות. לכל אפליקציה יש מילה נרדפת אחת או יותר בכל שפה נתמכת. המערכת משתמשת במילה הנרדפת הראשונה בתשובה.
[item, ...]	אובייקט	אפליקציה שמשתמשים במכשיר הזה יכולים ליצור איתה אינטראקציה.
key	String	חובה. מפתח ייחודי לאפליקציה שלא מוצג למשתמשים בדיבור או בתגובה.
names	מערך	חובה. שם כל אפליקציה והמילים הנרדפות שלה בשפות שונות.
[item, ...]	אובייקט	מילים נרדפות לאפליקציות.
name_synonym	מערך	חובה. מילים נרדפות ידידותיות למשתמש לשם האפליקציה בשפה נתונה. המילה הנרדפת הראשונה משמשת בתשובה.
[item, ...]	String	שם האפליקציה.
lang	String	חובה. קוד שפה.

דוגמאות

מכשיר עם אפליקציית YouTube

{
  "availableApplications": [
    {
      "key": "youtube",
      "names": [
        {
          "name_synonym": [
            "YouTube",
            "YouTube US"
          ],
          "lang": "en"
        },
        {
          "name_synonym": [
            "YouTube",
            "YouTube DE"
          ],
          "lang": "de"
        }
      ]
    }
  ]
}

מצבי המכשיר

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

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

דוגמאות

מכשיר עם אפליקציית YouTube שפועלת כרגע בחזית.

{
  "currentApplication": "YouTube"
}

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

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

action.devices.commands.appInstall

מתקינים את האפליקציה שצוינה.

פרמטרים

פרמטרים	סוג	תיאור
newApplication	String	המפתח של האפליקציה להתקנה.
newApplicationName	String	שם האפליקציה להתקנה.

דוגמאות

התקנת אפליקציית YouTube באמצעות מפתח

{
  "command": "action.devices.commands.appInstall",
  "params": {
    "newApplication": "YouTube"
  }
}

התקנת אפליקציית YouTube לפי שם

{
  "command": "action.devices.commands.appInstall",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

action.devices.commands.appSearch

מחפשים את האפליקציה שצוינה.

פרמטרים

פרמטרים	סוג	תיאור
newApplication	String	המפתח של האפליקציה שרוצים לחפש.
newApplicationName	String	שם האפליקציה לחיפוש.

דוגמאות

חיפוש אפליקציית YouTube לפי מפתח

{
  "command": "action.devices.commands.appSearch",
  "params": {
    "newApplication": "YouTube"
  }
}

חיפוש של אפליקציית YouTube לפי שם

{
  "command": "action.devices.commands.appSearch",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

action.devices.commands.appSelect

בוחרים את האפליקציה הרלוונטית.

פרמטרים

פרמטרים	סוג	תיאור
newApplication	String	המפתח של האפליקציה שרוצים לבחור.
newApplicationName	String	שם האפליקציה שרוצים לבחור.

דוגמאות

בחירת אפליקציית YouTube באמצעות מקש

{
  "command": "action.devices.commands.appSelect",
  "params": {
    "newApplication": "YouTube"
  }
}

בחירה של אפליקציית YouTube לפי שם

{
  "command": "action.devices.commands.appSelect",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

דוגמאות לניסוחים

de-DE

• Öffne Netflix auf dem Fernseher .

en-US

• begin using YouTube app on the smart TV

es-ES

• pon netflix en la tele del salón

fr-FR

• Mets Netflix sur la télé .

hi-IN

• टीवी पर नेटफ्लिक्स ऍप लॉन्च करो

it-IT

• Apri Netflix sulla televisione della mia camera .

ja-JP

• YouTube のアプリを テレビ でスタート

ko-KR

• TV 에서 유튜브 앱 열어 줘

nl-NL

• Start Netflix op mijn TV .

pt-BR

• Abra o Netflix na TV para mim.
• Abre o Youtube na televisão .

sv-SE

• Öppna Youtube på TV:n

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

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

• ‫noAvailableApp: האפליקציה לא קיימת או לא זמינה.
• ‫appLaunchFailed: הפעלת האפליקציה נכשלה.
• ‫alreadyInstalledApp: האפליקציה כבר הותקנה.