مرحبًا بك في "مركز مطوّري برامج Google Home"، وجهتك الجديدة لتعلّم كيفية تطوير إجراءات منزلية ذكية. ملاحظة: ستواصل إنشاء الإجراءات في وحدة تحكم الإجراءات.
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

أخطاء الجهاز

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