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

مخطط سمة أداة اختيار المنزل المزوّد بأجهزة ذكية

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

يمكن أن تحتوي إدخالات الوسائط على أسماء ديناميكية لكل جهاز تمثل خلاصات الصوت أو الفيديو. ويمكن أن تكون هذه الخلاصات سلكية أو متصلة بالشبكة، ولكن يجب تسميتها ومستمرة بشكل معقول. لا تتيح هذه السمة الخلاصات العشوائية المؤقتة، مثل مكتبة على شبكة قابلة للبحث. إنّ مصادر بلوتوث المقترنة والتي تحمل أسماء متوافقة. يمكن أن تحتوي المصادر على أسماء متعددة، لذا يمكن استخدام الأسماء التي ينشئها المستخدمون والتي يتم اكتشافها، بالإضافة إلى الأسماء التلقائية. على سبيل المثال، قد تكون "hdmi_1" أيضًا "مشغّل أقراص DVD" أو "usb_1" وقد تكون أيضًا "محرك الأقراص الثابتة".

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

وكما هي الحال مع Toggles والأوضاع، يجب توفير أسماء الإدخالات بجميع اللغات المتاحة، لا سيما في الأسماء التلقائية.

سمات الجهاز

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

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

مطلوب:

قائمة بالعناصر التي تمثّل إدخال الصوت أو خلاصات الفيديو يمكن أن تكون الخلاصات سلكية أو متصلة بالشبكة. يجب تسمية كل خلاصة ومستمرة بشكل معقول. احرص على تعريف المرادفات بعناية لتجنّب ظهور أي عبارات غير مرغوب فيها.

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

هذا الإدخال متاح.

key سلسلة

مطلوب:

المفتاح الفريد للإدخال. ويجب ألا يتم عرض المفتاح للمستخدمين في الكلام أو الاستجابة.

names مصفوفة

مطلوب:

قائمة أسماء المدخلات لكل اللغات المتاحة.

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

الإدخال للغة متاحة معيَّنة.

lang سلسلة

مطلوب:

رمز اللغة.

name_synonym مصفوفة

مطلوب:

أسماء سهلة الاستخدام للإدخال بلغة معيّنة يتم استخدام المرادف الأول في استجابة "مساعد Google" للمستخدم.

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

اسم الإدخال.

commandOnlyInputSelector منطقي

(تلقائي: false)

تشير إلى ما إذا كان الجهاز يتيح استخدام الاتصال الأحادي (صحيح) أو الثنائي (خطأ). اضبط هذه السمة على "صحيح" إذا تعذّر على الجهاز استجابة هدف QUERY أو حالة التقرير لهذه السمة.

orderedInputs منطقي

(تلقائي: false)

صحيح إذا تم ترتيب قائمة النتائج. ويشير هذا أيضًا إلى توفُّر الدالة "التالية" و"السابقة".

أمثلة

الجهاز يتضمّن إدخالَين مطلوبَين.

{
  "availableInputs": [
    {
      "key": "hdmi_1",
      "names": [
        {
          "lang": "en",
          "name_synonym": [
            "HDMI 1",
            "1st HDMI",
            "DVD Player"
          ]
        },
        {
          "lang": "de",
          "name_synonym": [
            "HDMI 1",
            "Zuerst HDMI",
            "DVD Spieler"
          ]
        }
      ]
    },
    {
      "key": "usb_1",
      "names": [
        {
          "lang": "en",
          "name_synonym": [
            "USB 1",
            "First USB",
            "Hard Drive"
          ]
        },
        {
          "lang": "de",
          "name_synonym": [
            "USB 1",
            "Zuerst USB",
            "Festplatte"
          ]
        }
      ]
    }
  ],
  "orderedInputs": true
}

حالات الجهاز

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

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

مطلوب:

مفتاح الإدخال قيد الاستخدام حاليًا.

أمثلة

الجهاز مع منفذ HDMI المحدد حاليًا.

{
  "currentInput": "hdmi_1"
}

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

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

action.devices.commands.SetInput

اضبط إدخال الوسائط.

المعلّمات

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

مطلوب:

مفتاح الإدخال الجديد

أمثلة

اختيار إدخال USB

{
  "command": "action.devices.commands.SetInput",
  "params": {
    "newInput": "usb_1"
  }
}

action.devices.commands.NextInput

اختَر الإدخال التالي. ولا يمكن استخدامها إلا عند ضبط السمة orderedInputs على "صحيح".

يتطلب هذا الأمر السمات التالية:
{
  "orderedInputs": true
}

المعلّمات

المعلّمات Type الوصف

ما من مواقع

أمثلة

ما مِن معلّمات

{
  "command": "action.devices.commands.NextInput",
  "params": {}
}

action.devices.commands.PreviousInput

اختَر الإدخال السابق. ولا يمكن استخدامها إلا عند ضبط السمة orderedInputs على "صحيح".

يتطلب هذا الأمر السمات التالية:
{
  "orderedInputs": true
}

المعلّمات

المعلّمات Type الوصف

ما من مواقع

أمثلة

ما مِن معلّمات

{
  "command": "action.devices.commands.PreviousInput",
  "params": {}
}

نماذج من الكلمات

de-DE

  • Ändere den Eingangskanal auf AUX .

en-US

  • change input mode to HDMI 1

es-ES

  • cambia a hdmi 1

fr-FR

  • Activation du mode HDMI1 .
  • Mets la télé sur HDMI 1 .

hi-IN

  • टीवी की इनपुट HDMI 1 में स्विच करो

it-IT

  • metti ingresso aux sulla tv

ja-JP

  • テレビ HDMI1 にして

ko-KR

  • TV HDMI 1 로 바꿔 줘

nl-NL

  • zet de TV op bluetooth

pt-BR

  • Muda a entrada da TV para HDMI2 .
  • mudar a entrada para AUX

sv-SE

  • Sätt på hdmi 1

أخطاء الجهاز

راجِع القائمة الكاملة للأخطاء والاستثناءات.

unsupportedInput: الإدخال غير متوافق حاليًا.