مخطط سمة حجم المنزل المزوّد بأجهزة ذكية

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	عدد صحيح	يجب ملء هذا الحقل. سلبية لـ 'decrease'.

أمثلة

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

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

أخطاء الجهاز

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

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