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