مخطّط سمة Smart Home AppSelector

action.devices.traits.AppSelector - تُستخدَم هذه السمة للأجهزة التي يمكنها التبديل بين التطبيقات.

سمات الجهاز

قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات التالية كجزء من عملية SYNC. للاطّلاع على مزيد من المعلومات عن معالجة SYNC intents، اطّلِع على تلبية النية.

السمات	النوع	الوصف
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 intents، اطّلِع على تلبية النية.

الولايات	النوع	الوصف
currentApplication	String	مطلوبة قيمة المفتاح للتطبيق الحالي النشط في المقدّمة.

أمثلة

الجهاز الذي يعمل تطبيق YouTube عليه حاليًا في المقدّمة:

{
  "currentApplication": "YouTube"
}

أوامر الجهاز

قد تستجيب الأجهزة التي تتضمّن هذه السمة للطلبات التالية كجزء من عملية EXECUTE. للاطّلاع على مزيد من المعلومات عن معالجة EXECUTE intents، اطّلِع على تلبية النية.

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: سبق أن تم تثبيت التطبيق.