مخطط سمة التحكم في وسائل النقل في المنازل المزوّدة بأجهزة ذكية
action.devices.traits.TransportControl
: تُستخدَم هذه السمة للأجهزة التي يمكنها التحكّم في تشغيل الوسائط (على سبيل المثال، استئناف الموسيقى أثناء إيقافها مؤقتًا).
سمات الجهاز
قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات التالية كجزء من عملية SYNC
. لمزيد من المعلومات عن التعامل مع أغراض SYNC
، يُرجى الاطّلاع على تنفيذ النية.
السمات | النوع | الوصف |
---|---|---|
transportControlSupportedCommands |
صفيف |
يجب ملء هذا الحقل. قائمة بالسلاسل تصف الأوامر المتوافقة للتحكّم في النقل على هذا الجهاز |
[item, ...] |
String |
الأوامر المتاحة القيم المسموح بها:
|
أمثلة
الجهاز الذي يتوافق مع أوامر التشغيل
{ "transportControlSupportedCommands": [ "NEXT", "PREVIOUS", "PAUSE", "STOP", "RESUME" ] }
حالات الجهاز
غير مسموح بأي رسائل
مفاتيح الجهاز
قد تستجيب الأجهزة التي تتضمّن هذه السمة إلى الأوامر التالية كجزء من عملية EXECUTE
. لمزيد من المعلومات عن التعامل مع أغراض EXECUTE
، يُرجى الاطّلاع على تنفيذ النية.
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 |
منطقية |
يجب ملء هذا الحقل. اضغط على "true" لتفعيل وضع التكرار، وعلى "false" لإيقاف وضع التكرار. |
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": {} }