مخطط سمة مستوى الصوت في المنزل المزوّد بأجهزة ذكية

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

ATTRIBUTES للجهاز

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

السمات	النوع	الوصف
volumeMaxLevel	عدد صحيح	يجب ملء هذا الحقل. تمثّل هذه السمة الحدّ الأقصى لمستوى الصوت، مع افتراض أنّ القيمة المرجعية 0 (كتم الصوت). سيعدّل "مساعد Google" الطلبات الصوتية (مثل "رفع صوت التلفزيون قليلاً") وفقًا لذلك.
volumeCanMuteAndUnmute	منطقي	يجب ملء هذا الحقل. يشير إلى ما إذا كان يمكن للجهاز كتم الصوت أو إعادة الصوت. كتم الصوت هو خيار منفصل كخيار "كتم الصوت" يؤدي هذا الإجراء إلى خفض مستوى الصوت إلى 0 مع حفظ مستوى الصوت السابق، لذلك تتم إعادة الصوت إلى حال إعادة الصوت. ينعكس ذلك في حالة مستوى الصوت، فإذا كان مستوى الصوت 5، وكتم صوت المستخدم، يظلّ مستوى الصوت 5 وisMuted على "صحيح".
volumeDefaultPercentage	عدد صحيح	(القيمة التلقائية: 40) مستوى الصوت (بالنسبة المئوية) لحجم الصوت التلقائي الذي حدّده المستخدم أو الشركة المصنّعة. يجب أن يكون المقياس 0-100.
levelStepSize	عدد صحيح	(القيمة التلقائية: 1) حجم الخطوة التلقائي لطلبات البحث النسبية عن مستوى الصوت مثل "رفع الصوت على <device_name>".
commandOnlyVolume	منطقي	(القيمة التلقائية: false) يشير إلى ما إذا كان الجهاز يعمل باستخدام اتصال أحادي الاتجاه (صحيح) أو اتصال ثنائي الاتجاه (خطأ). على سبيل المثال، إذا كان بإمكان وحدة التحكّم تأكيد حالة الجهاز الجديدة بعد إرسال الطلب، سيكون هذا الحقل false. إذا تعذّر تأكيد ما إذا تم تنفيذ الطلب بنجاح أو معرفة حالة الجهاز (على سبيل المثال، إذا كان الجهاز عبارة عن جهاز تقليدي عن بُعد بالأشعة تحت الحمراء)، اضبط هذا الحقل على "صحيح".

أمثلة

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

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

حالة الجهاز

يجوز للكيانات التي تستخدم هذه السمة الإبلاغ عما يلي: كجزء من عملية QUERY. للتعلّم مزيد من المعلومات عن التعامل مع QUERY هدفًا. اطّلِع على تحقيق النية بالشراء:

الولايات	النوع	الوصف
currentVolume	عدد صحيح	يجب ملء هذا الحقل. النسبة المئوية لمستوى الصوت الحالي يجب أن تتراوح القيمة بين >0 وvolumeMaxLevel.
isMuted	منطقي	مطلوبة في حال ضبط السمة volumeCanMuteAndUnmute على "صحيح" صحيح في حال كتم صوت الجهاز false في الحالات الأخرى. إذا كانت isMuted صحيحة، سيظل الجهاز يعرض currentVolume للنقطة التي يتم تذكّرها.

أمثلة

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

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

CommandS للجهاز

قد تستجيب الأجهزة التي تتضمن هذه السمة لما يلي: الأوامر كجزء من عملية 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 عندما يكون قيد التشغيل عند خفض مستوى الصوت