مخطط سمة Smart Lock TransportControl

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

سمات الجهاز

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

السمات	Type	الوصف
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. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في EXECUTE، يُرجى الاطّلاع على تنفيذ النية بالشراء.

action.devices.commands.mediaStop

أوقِف تشغيل الوسائط مؤقتًا.

يتطلب هذا الأمر السمات التالية:

{
  "transportControlSupportedCommands": [
    "STOP"
  ]
}

المَعلمات

المَعلمات	Type	الوصف
ما من مواقع

أمثلة

ما مِن معلّمات

{
  "command": "action.devices.commands.mediaStop",
  "params": {}
}

action.devices.commands.mediaNext

التخطي إلى عنصر الوسائط التالي

يتطلب هذا الأمر السمات التالية:

{
  "transportControlSupportedCommands": [
    "NEXT"
  ]
}

المَعلمات

المَعلمات	Type	الوصف
ما من مواقع

أمثلة

ما مِن معلّمات

{
  "command": "action.devices.commands.mediaNext",
  "params": {}
}

action.devices.commands.mediaPrevious

التخطّي إلى عنصر الوسائط السابق

يتطلب هذا الأمر السمات التالية:

{
  "transportControlSupportedCommands": [
    "PREVIOUS"
  ]
}

المَعلمات

المَعلمات	Type	الوصف
ما من مواقع

أمثلة

ما مِن معلّمات

{
  "command": "action.devices.commands.mediaPrevious",
  "params": {}
}

action.devices.commands.mediaPause

أوقِف تشغيل الوسائط مؤقتًا.

يتطلب هذا الأمر السمات التالية:

{
  "transportControlSupportedCommands": [
    "PAUSE"
  ]
}

المَعلمات

المَعلمات	Type	الوصف
ما من مواقع

أمثلة

ما مِن معلّمات

{
  "command": "action.devices.commands.mediaPause",
  "params": {}
}

action.devices.commands.mediaResume

استئناف تشغيل الوسائط

يتطلب هذا الأمر السمات التالية:

{
  "transportControlSupportedCommands": [
    "RESUME"
  ]
}

المَعلمات

المَعلمات	Type	الوصف
ما من مواقع

أمثلة

ما مِن معلّمات

{
  "command": "action.devices.commands.mediaResume",
  "params": {}
}

action.devices.commands.mediaSeekRelative

انتقل إلى موضع نسبي.

يتطلب هذا الأمر السمات التالية:

{
  "transportControlSupportedCommands": [
    "SEEK_RELATIVE"
  ]
}

المَعلمات

المَعلمات	Type	الوصف
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"
  ]
}

المَعلمات

المَعلمات	Type	الوصف
absPositionMs	عدد صحيح	مطلوب: مللي ثانية للمطلق المطلق للتقديم.

أمثلة

تقديم فيديو لمدة 30 ثانية

{
  "command": "action.devices.commands.mediaSeekToPosition",
  "params": {
    "absPositionMs": 30000
  }
}

action.devices.commands.mediaRepeatMode

ضبط وضع التشغيل المتكرّر

يتطلب هذا الأمر السمات التالية:

{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

المَعلمات

المَعلمات	Type	الوصف
isOn	منطقي	مطلوب: صحيح: لتفعيل وضع التكرار، القيمة "خطأ" لإيقاف وضع التكرار.
isSingle	منطقي	(تلقائي: 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"
  ]
}

المَعلمات

المَعلمات	Type	الوصف
ما من مواقع

أمثلة

ما مِن معلّمات

{
  "command": "action.devices.commands.mediaShuffle",
  "params": {}
}

action.devices.commands.mediaClosedCaptioningOn

تفعيل الترجمة والشرح

يتطلب هذا الأمر السمات التالية:

{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

المَعلمات

المَعلمات	Type	الوصف
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"
  ]
}

المَعلمات

المَعلمات	Type	الوصف
ما من مواقع

أمثلة

إيقاف الترجمة والشرح

{
  "command": "action.devices.commands.mediaClosedCaptioningOff",
  "params": {}
}

أخطاء الجهاز

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