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

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: האפליקציה כבר הותקנה.