مخطّط الصفة "التحكّم في المنزل الذكي"

action.devices.traits.TransportControl: يتم استخدام هذه السمة للأجهزة القادرة على التحكّم في تشغيل الوسائط (مثل استئناف تشغيل الموسيقى أثناء إيقافها مؤقتًا).

الجهاز ATTRIBUTES

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

السمات	النوع	الوصف
transportControlSupportedCommands	المصفوفة	مطلوبة. قائمة بالسلاسل التي تصف أوامر التحكم في النقل المتوافقة على هذا الجهاز.
[item, ...]	سلسلة	الأوامر المعتمدة. القيم المسموح بها: CAPTION_CONTROL NEXT PAUSE PREVIOUS RESUME SEEK_RELATIVE SEEK_TO_POSITION SET_REPEAT SHUFFLE STOP

أمثلة

الجهاز الذي يتوافق مع أوامر التشغيل

{
  "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	منطقي	(القيمة التلقائية: false) في حال تحديدها، تعني "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": {}
}

أخطاء الجهاز

يمكنك الاطلاع على القائمة الكاملة للأخطاء والاستثناءات.