مخطّط سمة مستوى الصوت في المنزل الذكي

action.devices.traits.Volume - تنطبق هذه السمة على الأجهزة التي يمكنها تغيير مستوى الصوت (على سبيل المثال، ضبط مستوى الصوت على مستوى معيّن أو كتم الصوت أو إعادة صوته).

سمات الجهاز

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

السمات النوع الوصف
volumeMaxLevel عدد صحيح

مطلوبة

الحد الأقصى لمستوى الصوت، بافتراض أنّ 0 هو المستوى الأساسي (كتم الصوت). سيعدّل "مساعد Google" الطلبات التي تتضمّن ظرفًا (مثل "رفع مستوى صوت التلفزيون قليلاً") وفقًا لذلك.
volumeCanMuteAndUnmute صحيح/خطأ

مطلوبة

يشير إلى ما إذا كان بإمكان الجهاز كتم الصوت وإعادته. إنّ كتم الصوت هو خيار منفصل لأنّ سلوك "كتم الصوت" يضبط مستوى الصوت على 0 مع تذكر مستوى الصوت السابق، وبالتالي يتم استعادة مستوى الصوت عند إلغاء كتم الصوت. وينعكس ذلك في حالة مستوى الصوت. إذا كان مستوى الصوت 5، وأوقف المستخدم الصوت، سيظل مستوى الصوت 5 ويكون isMuted صحيحًا.
volumeDefaultPercentage عدد صحيح

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

مستوى الصوت (بالنسبة المئوية) للمستوى التلقائي الذي حدّده المستخدم أو الشركة المصنّعة يجب أن يتراوح مقياس التقييم بين 0 و100.
levelStepSize عدد صحيح

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

حجم الخطوة التلقائي لطلبات البحث النسبية عن مستوى الصوت مثل "رفع الصوت على <device_name>".
commandOnlyVolume صحيح/خطأ

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

يشير إلى ما إذا كان الجهاز يعمل باستخدام اتّصال أحادي الاتجاه (صحيح) أو اتّصال ثنائي الاتجاه (خطأ). على سبيل المثال، إذا كان بإمكان وحدة التحكّم تأكيد حالة الجهاز الجديد بعد إرسال الطلب، سيكون هذا الحقل خطأ. إذا تعذّر تأكيد ما إذا تم تنفيذ الطلب بنجاح أو معرفة حالة الجهاز (على سبيل المثال، إذا كان الجهاز عبارة عن جهاز تقليدي عن بُعد بالأشعة تحت الحمراء)، اضبط هذا الحقل على "صحيح".

أمثلة

جهاز مكبّر صوت يمكن كتم صوته والإبلاغ عن الحالة الحالية

{
  "volumeMaxLevel": 11,
  "volumeCanMuteAndUnmute": true,
  "levelStepSize": 2,
  "commandOnlyVolume": false,
  "volumeDefaultPercentage": 6
}

حالة الجهاز

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

الولايات النوع الوصف
currentVolume عدد صحيح

يجب ملء هذا الحقل.

النسبة المئوية الحالية لمستوى الصوت يجب أن تكون القيمة بين >0 وvolumeMaxLevel.
isMuted صحيح/خطأ

مطلوبة في حال ضبط السمة volumeCanMuteAndUnmute على "صحيح" صحيح إذا كان الجهاز صامتًا، وخطأ في الحالات الأخرى. إذا كانت القيمة isMuted صحيحة، سيستمر الجهاز في عرض القيمة currentVolume للنقطة التي تم تذكُّرها.

أمثلة

جهاز مكبّر صوت يمكن كتم صوته والإبلاغ عن حالته الحالية

{
  "currentVolume": 5,
  "isMuted": false
}

أوامر الجهاز

قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر التالية كجزء من عملية EXECUTE. للاطّلاع على مزيد من المعلومات عن معالجة أهداف EXECUTE، يمكنك الاطّلاع على تلبية الأهداف.

action.devices.commands.mute

كتم صوت الجهاز أو إعادته

المعلمات

المعلمات النوع الوصف
mute منطقي

مطلوبة

تحديد ما إذا كنت تريد كتم صوت جهاز أو إزالة كتم صوته

أمثلة

كتم صوت مكبّر الصوت

{
  "command": "action.devices.commands.mute",
  "params": {
    "mute": true
  }
}

action.devices.commands.setVolume

اضبط مستوى الصوت على المستوى المطلوب استنادًا إلى volumeMaxLevel.

المعلمات

المعلمات النوع الوصف
volumeLevel عدد صحيح

مطلوبة

المجلد الجديد من 0 إلى volumeMaxLevel.

أمثلة

ضبط مستوى الصوت المطلق لجهاز مكبّر الصوت

{
  "command": "action.devices.commands.setVolume",
  "params": {
    "volumeLevel": 6
  }
}

action.devices.commands.volumeRelative

اضبط مستوى الصوت على n خطوة أعلى أو أقل، استنادًا إلى volumeMaxLevel. بالنسبة إلى الأوامر التي تستخدِم مقياسًا نسبيًا، سيختار "مساعد Google" n بشكلٍ مناسب لتوسيع النطاق إلى الخطوات المتاحة. على سبيل المثال، سيؤدي طلب رفع مستوى صوت التلفزيون بشكل كبير إلى ضبط عدد خطوات أكبر من طلب رفع مستوى صوت التلفزيون قليلاً.

المعلمات

المعلمات النوع الوصف
relativeSteps عدد صحيح

مطلوبة

سالبًا لقيمة "انخفاض".

أمثلة

ضبط مستوى الصوت النسبي لجهاز مكبّر الصوت في وضع الأوامر فقط

{
  "command": "action.devices.commands.volumeRelative",
  "params": {
    "relativeSteps": -1
  }
}

أخطاء الجهاز

اطّلِع على القائمة الكاملة للأخطاء والاستثناءات.
  • volumeAlreadyMax: يتلقّى الجهاز الأمر VolumeUp عندما يكون مستوى الصوت مرتفعًا إلى أقصى حدّ.
  • volumeAlreadyMin: يتلقّى الجهاز الأمر VolumeDown عندما يكون الصوت على أدنى مستوى.