مخطّط سمة TransportControl للمنزل الذكي

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

سمات الجهاز

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

السمات النوع الوصف
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 intents، اطّلِع على تلبية النية.

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 صحيح/خطأ

مطلوبة

صحيح لتفعيل وضع التكرار، وخطأ لإيقافه

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

أخطاء الجهاز

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