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

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

سمات الجهاز

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

السمات النوع الوصف
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 intents، اطّلِع على تلبية النية.

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

مطلوبة

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

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

أمثلة

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

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

أوامر الجهاز

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

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 عندما يكون الصوت على أدنى مستوى.