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

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": {}
}

أخطاء الجهاز

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