مرحبًا بك في "مركز مطوّري Google Home"، الوجهة الجديدة لتعلّم كيفية تطوير المهام المنزلية الذكية. ملاحظة: ستواصل إنشاء إجراءات في "وحدة تحكّم المهام".

مخطط سمة أداة اختيار التطبيقات المنزلية الذكية

action.devices.traits.AppSelector: تُستخدَم هذه السمة للأجهزة التي يمكنها تبديل مصادر الإدخال.

سمات الجهاز

قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات التالية كجزء من عملية SYNC. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في SYNC، يُرجى الاطّلاع على تنفيذ النية بالشراء.

السمات Type الوصف
availableApplications مصفوفة

مطلوب:

قائمة بالتطبيقات. يحتوي كل تطبيق على مرادفات واحدة أو أكثر بكل لغة معتمدة. يتم استخدام المرادف الأول في الإجابة.

[item, ...] العنصر

التطبيق الذي يمكن لمستخدمي هذا الجهاز التفاعل معه

key سلسلة

مطلوب:

مفتاح فريد للتطبيق لا يظهر للمستخدمين في الكلام أو الاستجابة

names مصفوفة

مطلوب:

اسم كل تطبيق ومرادفاته الخاصة باللغة

[item, ...] العنصر

مرادفات التطبيق

name_synonym مصفوفة

مطلوب:

مرادفات سهلة الاستخدام لاسم التطبيق للغة معينة. يتم استخدام المرادف الأول في الإجابة.

[item, ...] سلسلة

اسم التطبيق.

lang سلسلة

مطلوب:

رمز اللغة.

أمثلة

الجهاز الذي يتضمّن تطبيق YouTube

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

حالات الجهاز

قد تُبلِغ الكيانات التي تحمل هذه السمة عن الحالات التالية كجزء من عملية QUERY. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في QUERY، يُرجى الاطّلاع على تنفيذ النية بالشراء.

الولايات Type الوصف
currentApplication سلسلة

مطلوب:

القيمة الرئيسية للتطبيق الحالي النشط في المقدّمة.

أمثلة

الجهاز الذي يتضمّن تطبيق YouTube نشط حاليًا في المقدّمة.

{
  "currentApplication": "YouTube"
}

حوالات الجهاز

قد تستجيب الأجهزة التي تستخدم هذه السمة للأوامر التالية كجزء من عملية EXECUTE. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في EXECUTE، يُرجى الاطّلاع على تنفيذ النية بالشراء.

action.devices.commands.appInstall

ثبِّت التطبيق المحدَّد.

المعلّمات

المعلّمات Type الوصف
newApplication سلسلة

مفتاح التطبيق المراد تثبيته.

newApplicationName سلسلة

اسم التطبيق المُراد تثبيته

أمثلة

تثبيت تطبيق YouTube حسب المفتاح

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

تثبيت تطبيق YouTube حسب الاسم

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

action.devices.commands.appSearch

البحث عن التطبيق المحدّد

المعلّمات

المعلّمات Type الوصف
newApplication سلسلة

مفتاح التطبيق للبحث عنه.

newApplicationName سلسلة

اسم التطبيق للبحث عنه.

أمثلة

البحث عن تطبيق YouTube حسب المفتاح

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

البحث عن تطبيق YouTube حسب الاسم

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

action.devices.commands.appSelect

اختَر التطبيق المعني.

المعلّمات

المعلّمات Type الوصف
newApplication سلسلة

مفتاح التطبيق الذي سيتم اختياره.

newApplicationName سلسلة

اسم التطبيق المُراد اختياره

أمثلة

اختيار تطبيق 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 TV:n

أخطاء الجهاز

راجِع القائمة الكاملة للأخطاء والاستثناءات.
  • noAvailableApp: التطبيق غير موجود أو غير متاح.
  • appLaunchFailed: تعذّر تشغيل التطبيق.
  • alreadyInstalledApp: سبق أن تم تثبيت التطبيق.