مخطّط سمة InputSelector في المنزل الذكي

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

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

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

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

سمات الجهاز

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

السمات النوع الوصف
availableInputs صفيف

مطلوبة

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

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

الإدخال المتاح

key String

مطلوبة

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

names صفيف

مطلوبة

قائمة بأسماء مصادر الإدخال لكل اللغات المتاحة

[item, ...] كائن

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

lang String

مطلوبة

رمز اللغة

name_synonym مصفوفة

مطلوبة

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

[item, ...] String

أدخِل الاسم.

commandOnlyInputSelector منطقي

(القيمة التلقائية: false)

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

orderedInputs صحيح/خطأ

(القيمة التلقائية: false)

True إذا كانت قائمة المخرجات مرتبة. ويشير ذلك أيضًا إلى توفّر وظيفتَي "التالي" و"السابق".

أمثلة

جهاز يتضمّن مدخلَين مرتبَين

{
  "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. لمزيد من المعلومات حول كيفية التعامل مع نية QUERY، يمكنك الاطّلاع على التنفيذ حسب نية العميل.

الولايات النوع الوصف
currentInput String

مطلوبة

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

أمثلة

الجهاز الذي يتضمّن مصدر إدخال HDMI محدّد حاليًا.

{
  "currentInput": "hdmi_1"
}

أوامر الجهاز

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

action.devices.commands.SetInput

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

المعلمات

المعلمات النوع الوصف
newInput String

مطلوبة

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

أمثلة

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

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

action.devices.commands.NextInput

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

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

المعلمات

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

ما من مواقع

أمثلة

بلا معلَمات

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

action.devices.commands.PreviousInput

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

يتطلّب هذا الطلب السمات التالية:
{
  "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: الإدخال غير متاح حاليًا.