مخطط سمة مستوى الصوت الذكي

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

سمات الجهاز

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

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

مطلوبة

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

مطلوبة

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

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

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

يجب أن تتراوح القيمة بين 0 و100.
levelStepSize عدد صحيح

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

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

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

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

أمثلة

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

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

حالات الجهاز

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

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

مطلوبة

تمثّل هذه السمة النسبة المئوية الحالية لمستوى الصوت. يجب أن تتراوح القيمة بين >0 وvolumeMaxLevel.

الحد الأدنى للقيمة: 0
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

الحد الأدنى للقيمة: 0

أمثلة

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

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

action.devices.commands.volumeRelative

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

المعلمات

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

مطلوبة

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

أمثلة

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

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

أخطاء الجهاز

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