مخطط ميزة حجم المنزل الذكي

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) تشير إلى ما إذا كان الجهاز يعمل باستخدام اتصال أحادي الاتجاه (صواب) أو ثنائي الاتجاه (خطأ). على سبيل المثال، إذا كانت وحدة التحكّم تستطيع تأكيد حالة الجهاز الجديد بعد إرسال الطلب، سيكون هذا الحقل خطأ. إذا تعذّر عليك تأكيد ما إذا كان قد تم تنفيذ الطلب بنجاح أو الحصول على حالة الجهاز (على سبيل المثال، إذا كان الجهاز عبارة عن جهاز تحكم عن بُعد بالأشعة تحت الحمراء التقليدية)، فعيِّن هذا الحقل على "صحيح".

أمثلة

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

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

حالة الجهاز STATES

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

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

أمثلة

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

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

مفاتيح COMMAND

قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر التالية كجزء من عملية 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

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

المَعلمات

المَعلمات	النوع	الوصف
relativeSteps	عدد صحيح	مطلوبة. سلبي لـ "خفض".

أمثلة

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

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

أخطاء الجهاز

يمكنك الاطلاع على القائمة الكاملة للأخطاء والاستثناءات.

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