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

‫action.devices.traits.MediaState: تُستخدَم هذه السمة للأجهزة التي يمكنها الإبلاغ عن حالات الوسائط.

يستخدم "مساعد Google" سمة MediaState للأغراض التالية:

  • معرفة المحتوى الذي يتم تشغيله على كل جهاز، وما إذا كان "مساعد Google" قد بدأ تشغيله أم لا تساعد هذه المعلومات "مساعد Google" في فهم نوايا المستخدم بشكل أفضل. على سبيل المثال، سيقول المستخدمون "إيقاف العرض الليلة مؤقتًا" عندما يكون الهدف الفعلي هو "أوقِف الجهاز مؤقتًا الذي يشغِّل حاليًا بثًا لهذه الليلة".
  • لنقل المحتوى بين مشغّلات الوسائط: إذا كان "مساعد Google" يعرف المحتوى الذي يتم تشغيله وموقع التشغيل الحالي، يمكنه نقل هذا المحتوى إلى جهاز آخر عندما ينتقل المستخدم بين الغرف، أو حفظه لمشاهدته لاحقًا على جهاز عشوائي.

يمكنك تحديد مستوى وجانب حالات الوسائط التي يوفّرها حلّك من خلال ضبط السمات في هذه السمة. تُستخدَم هذه السمة عادةً مع سمات TransportControl

سمات الجهاز

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

السمات النوع الوصف
supportActivityState صحيح/خطأ

(القيمة التلقائية: false)

حدِّد ما إذا كان بإمكان الجهاز الإبلاغ عن حالة النشاط.
supportPlaybackState صحيح/خطأ

(القيمة التلقائية: false)

حدِّد ما إذا كان بإمكان الجهاز الإبلاغ عن حالة التشغيل الحالية.

أمثلة

جهاز وسائط يُبلغ عن كلّ من النشاط وحالة التشغيل للاستجابة لطلب المزامنة

{
  "supportActivityState": true,
  "supportPlaybackState": true
}

حالات الجهاز

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

الولايات النوع الوصف
activityState String

تشير إلى ما إذا كان الجهاز نشطًا والمستخدم يتفاعل معه بشكل نشط.

القيم المسموح بها:

INACTIVE
STANDBY
ACTIVE
playbackState String

الإشارة إلى الحالة الحالية عند تشغيل الوسائط

القيم المسموح بها:

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

أمثلة

جهاز وسائط يرصد كلاً من النشاط وحالة التشغيل

{
  "activityState": "ACTIVE",
  "playbackState": "PAUSED"
}

أوامر الجهاز

بلا عُري

أخطاء الجهاز

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