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

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

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

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

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

سمات الجهاز

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

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

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

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

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

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

أمثلة

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

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

حالات الجهاز

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

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

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

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

INACTIVE
STANDBY
ACTIVE
playbackState String

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

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

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

أمثلة

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

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

أوامر الجهاز

بلا عُري

أخطاء الجهاز

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