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

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

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

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

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

سمات الجهاز

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

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

مطلوبة

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

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

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

key String

مطلوبة

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

names صفيف

مطلوبة

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

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

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

lang String

مطلوبة

رمز اللغة

name_synonym صفيف

مطلوبة

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

[item, ...] String

أدخِل الاسم.

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. للاطّلاع على مزيد من المعلومات عن معالجة QUERY intents، اطّلِع على تلبية النية.

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

مطلوبة

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

أمثلة

الجهاز المزوَّد بمصدر إدخال HDMI الذي تم اختياره حاليًا

{
  "currentInput": "hdmi_1"
}

أوامر الجهاز

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

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