مخطّط سمة 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 |
صحيح/خطأ |
(القيمة التلقائية: يشير إلى ما إذا كان الجهاز يتيح استخدام اتّصال أحادي الاتجاه (صحيح) أو اتّصال ثنائي الاتجاه (خطأ). اضبط هذه السمة على "صحيح" إذا لم يتمكّن الجهاز من الاستجابة لطلب QUERY أو الإبلاغ عن حالة هذه السمة. |
orderedInputs |
صحيح/خطأ |
(القيمة التلقائية: صحيح إذا كانت قائمة النتائج مرتبة. ويشير ذلك أيضًا إلى توفّر وظيفتَي "التالي" و"السابق". |
أمثلة
جهاز يتضمّن مدخلَين مرتبَين
{ "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
: الإدخال غير متاح حاليًا.