مخطط سمة التحكم في وسائل النقل في المنازل المزوّدة بأجهزة ذكية

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

سمات الجهاز

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

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

أمثلة

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

{
  "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	منطقية	(القيمة التلقائية: 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	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": {}
}

أخطاء الجهاز

راجِع القائمة الكاملة للأخطاء والاستثناءات.