مخطّط سمة TransportControl للمنزل الذكي
action.devices.traits.TransportControl
: تُستخدَم هذه السمة للأجهزة التي يمكنها التحكّم في تشغيل الوسائط (على سبيل المثال، استئناف الموسيقى أثناء إيقافها مؤقتًا).
سمات الجهاز
قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات التالية
كجزء من عملية SYNC
. للاطّلاع على مزيد من المعلومات عن معالجة SYNC
intents، اطّلِع على تلبية النية.
السمات | النوع | الوصف |
---|---|---|
transportControlSupportedCommands |
صفيف |
مطلوبة قائمة بسلاسل تصف أوامر التحكّم في النقل المتوافقة على هذا الجهاز |
[item, ...] |
String |
الأوامر المتاحة القيم المسموح بها:
|
أمثلة
الجهاز المتوافق مع أوامر التشغيل
{ "transportControlSupportedCommands": [ "NEXT", "PREVIOUS", "PAUSE", "STOP", "RESUME" ] }
حالات الجهاز
بلا عُري
أوامر الجهاز
قد تستجيب الأجهزة التي تتضمّن هذه السمة للطلبات التالية
كجزء من عملية EXECUTE
. للاطّلاع على مزيد من المعلومات عن معالجة EXECUTE
intents، اطّلِع على تلبية النية.
action.devices.commands.mediaStop
يمكنك إيقاف تشغيل الوسائط مؤقتًا.
يتطلّب هذا الطلب السمات التالية:{ "transportControlSupportedCommands": [ "STOP" ] }
المعلمات
المعلمات | النوع | الوصف |
---|---|---|
ما من مواقع |
أمثلة
بلا معلَمات
{ "command": "action.devices.commands.mediaStop", "params": {} }
action.devices.commands.mediaNext
انتقِل إلى عنصر الوسائط التالي.
يتطلّب هذا الطلب السمات التالية:{ "transportControlSupportedCommands": [ "NEXT" ] }
المعلمات
المعلمات | النوع | الوصف |
---|---|---|
ما من مواقع |
أمثلة
بلا معلَمات
{ "command": "action.devices.commands.mediaNext", "params": {} }
action.devices.commands.mediaPrevious
التخطّي إلى عنصر الوسائط السابق
يتطلّب هذا الطلب السمات التالية:{ "transportControlSupportedCommands": [ "PREVIOUS" ] }
المعلمات
المعلمات | النوع | الوصف |
---|---|---|
ما من مواقع |
أمثلة
بلا معلَمات
{ "command": "action.devices.commands.mediaPrevious", "params": {} }
action.devices.commands.mediaPause
يمكنك إيقاف تشغيل الوسائط مؤقتًا.
يتطلّب هذا الطلب السمات التالية:{ "transportControlSupportedCommands": [ "PAUSE" ] }
المعلمات
المعلمات | النوع | الوصف |
---|---|---|
ما من مواقع |
أمثلة
بلا معلَمات
{ "command": "action.devices.commands.mediaPause", "params": {} }
action.devices.commands.mediaResume
استئناف تشغيل الوسائط
يتطلّب هذا الطلب السمات التالية:{ "transportControlSupportedCommands": [ "RESUME" ] }
المعلمات
المعلمات | النوع | الوصف |
---|---|---|
ما من مواقع |
أمثلة
بلا معلَمات
{ "command": "action.devices.commands.mediaResume", "params": {} }
action.devices.commands.mediaSeekRelative
انتقِل إلى موضع نسبي.
يتطلّب هذا الطلب السمات التالية:{ "transportControlSupportedCommands": [ "SEEK_RELATIVE" ] }
المعلمات
المعلمات | النوع | الوصف |
---|---|---|
relativePositionMs |
عدد صحيح |
مطلوبة عدد المللي ثانية للقيمة التي تريد التقديم (عدد صحيح موجب) أو الإيقاف (عدد صحيح سالب) إليها. |
أمثلة
تقديم الفيديو لمدة 10 ثوانٍ
{ "command": "action.devices.commands.mediaSeekRelative", "params": { "relativePositionMs": 10000 } }
الترجيع 10 ثوانٍ
{ "command": "action.devices.commands.mediaSeekRelative", "params": { "relativePositionMs": -10000 } }
action.devices.commands.mediaSeekToPosition
انتقِل إلى موضع مطلق.
يتطلّب هذا الطلب السمات التالية:{ "transportControlSupportedCommands": [ "SEEK_TO_POSITION" ] }
المعلمات
المعلمات | النوع | الوصف |
---|---|---|
absPositionMs |
عدد صحيح |
مطلوبة وحدات المللي ثانية للموضع المطلق الذي تريد الانتقال إليه |
أمثلة
التقديم/الترجيع إلى 30 ثانية
{ "command": "action.devices.commands.mediaSeekToPosition", "params": { "absPositionMs": 30000 } }
action.devices.commands.mediaRepeatMode
اضبط وضع التشغيل المتكرّر.
يتطلّب هذا الطلب السمات التالية:{ "transportControlSupportedCommands": [ "SET_REPEAT" ] }
المعلمات
المعلمات | النوع | الوصف |
---|---|---|
isOn |
صحيح/خطأ |
مطلوبة صحيح لتفعيل وضع التكرار، وخطأ لإيقافه |
isSingle |
صحيح/خطأ |
(القيمة التلقائية: إذا تم تحديدها، تعني القيمة true تفعيل وضع تكرار العنصر الواحد، وتعني القيمة false تفعيل وضع التكرار العادي (مثل قائمة تشغيل). |
أمثلة
وضع التكرار مفعَّل
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": true } }
وضع التكرار غير مفعَّل
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": false } }
تكرار مقطع صوتي واحد
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": true, "isSingle": true } }
action.devices.commands.mediaShuffle
ترتيب قائمة التشغيل الحالية عشوائيًا
يتطلّب هذا الطلب السمات التالية:{ "transportControlSupportedCommands": [ "SHUFFLE" ] }
المعلمات
المعلمات | النوع | الوصف |
---|---|---|
ما من مواقع |
أمثلة
بلا معلَمات
{ "command": "action.devices.commands.mediaShuffle", "params": {} }
action.devices.commands.mediaClosedCaptioningOn
فعِّل ميزة الترجمة والشرح.
يتطلّب هذا الطلب السمات التالية:{ "transportControlSupportedCommands": [ "CAPTION_CONTROL" ] }
المعلمات
المعلمات | النوع | الوصف |
---|---|---|
closedCaptioningLanguage |
String |
اللغة أو اللكنة لمقاطع الترجمة والشرح |
userQueryLanguage |
String |
اللغة أو الإعدادات الإقليمية لطلب بحث المستخدم |
أمثلة
تفعيل ميزة الترجمة والشرح باللغة الإنجليزية
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "en" } }
تفعيل الترجمة والشرح باللغة الكورية
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "ko-KR" } }
تفعيل ميزة الترجمة والشرح باللغة الكورية مع طلب بحث المستخدم باللغة الإنجليزية الأمريكية
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "ko-KR", "userQueryLanguage": "en-US" } }
action.devices.commands.mediaClosedCaptioningOff
أوقِف ميزة الترجمة والشرح.
يتطلّب هذا الطلب السمات التالية:{ "transportControlSupportedCommands": [ "CAPTION_CONTROL" ] }
المعلمات
المعلمات | النوع | الوصف |
---|---|---|
ما من مواقع |
أمثلة
إيقاف ميزة "الترجمة والشرح"
{ "command": "action.devices.commands.mediaClosedCaptioningOff", "params": {} }