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

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

action.devices.traits.InputSelector - يتم استخدام هذه السمة للأجهزة القادرة على تبديل مصدرَي الإدخال.

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

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

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

الجهاز ATTRIBUTES

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

السمات النوع الوصف
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
}

حالة الجهاز STATES

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

الولايات النوع الوصف
currentInput سلسلة

مطلوبة.

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

أمثلة

الجهاز المزوّد بمنفذ إدخال HDMI حاليًا

{
  "currentInput": "hdmi_1"
}

مفاتيح COMMAND

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

action.devices.commands.SetInput

عيّن إدخال الوسائط.

المَعلمات

المَعلمات النوع الوصف
newInput سلسلة

مطلوبة.

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

أمثلة

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

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

action.devices.commands.NextInput

اختَر الإدخال التالي. ينطبق هذا الإعداد فقط عند ضبط السمة orderedInputs على true.

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

المَعلمات

المَعلمات النوع الوصف

ما من مواقع

أمثلة

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

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

action.devices.commands.PreviousInput

اختَر الإدخال السابق. ينطبق هذا الإعداد فقط عند ضبط السمة orderedInputs على true.

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

المَعلمات

المَعلمات النوع الوصف

ما من مواقع

أمثلة

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

{
  "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: الإدخال غير متوافق حاليًا.