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