مخطط ميزة حجم المنزل الذكي
action.devices.traits.Volume
: تنتمي هذه السمة إلى الأجهزة التي يمكنها تغيير مستوى الصوت (مثل ضبط مستوى الصوت على مستوى معيّن أو كتم الصوت أو إعادة الصوت).
الجهاز ATTRIBUTES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن السمات التالية كجزء من عملية SYNC
. لمزيد من المعلومات حول التعامل مع إجراءات SYNC
، يُرجى الاطّلاع على تنفيذ الإجراء.
السمات | النوع | الوصف |
---|---|---|
volumeMaxLevel |
عدد صحيح |
مطلوبة. الحد الأقصى لمستوى الصوت، مع افتراض أن القيمة المرجعية 0 (تجاهل). سيعدّل "مساعد Google" الأوامر الصوتية (مثل "رفع صوت التلفزيون قليلاً") وفقًا لذلك. |
volumeCanMuteAndUnmute |
منطقي |
مطلوبة. يشير إلى ما إذا كان يمكن للجهاز كتم الصوت أو إعادته. "كتم الصوت" هو خيار منفصل لأن السلوك "كتم الصوت" يؤدي إلى رفع مستوى الصوت إلى 0 مع تذكر مستوى الصوت السابق، حتى تتم إعادة الصوت إلى تفعيله. وينعكس هذا على حالة مستوى الصوت - إذا كان مستوى الصوت 5، وتم كتم صوت المستخدم، سيظل مستوى الصوت 5 و |
volumeDefaultPercentage |
عدد صحيح |
(القيمة التلقائية: الحجم (بالنسبة المئوية) للمستوى التلقائي الذي يحدده المستخدم أو الشركة المصنعة. يجب أن يكون المقياس 0-100. |
levelStepSize |
عدد صحيح |
(القيمة التلقائية: حجم الخطوة الافتراضي لطلبات البحث ذات الحجم النسبي مثل "رفع الصوت على <device_name>". |
commandOnlyVolume |
منطقي |
(القيمة التلقائية: تشير إلى ما إذا كان الجهاز يعمل باستخدام اتصال أحادي الاتجاه (صواب) أو ثنائي الاتجاه (خطأ). على سبيل المثال، إذا كانت وحدة التحكّم تستطيع تأكيد حالة الجهاز الجديد بعد إرسال الطلب، سيكون هذا الحقل خطأ. إذا تعذّر عليك تأكيد ما إذا كان قد تم تنفيذ الطلب بنجاح أو الحصول على حالة الجهاز (على سبيل المثال، إذا كان الجهاز عبارة عن جهاز تحكم عن بُعد بالأشعة تحت الحمراء التقليدية)، فعيِّن هذا الحقل على "صحيح". |
أمثلة
مكبّر صوت يمكن كتم صوته ويُبلغ عن حالته الحالية
{ "volumeMaxLevel": 11, "volumeCanMuteAndUnmute": true, "levelStepSize": 2, "commandOnlyVolume": false, "volumeDefaultPercentage": 6 }
حالة الجهاز STATES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن الحالات
التالية كجزء من عملية QUERY
. لمزيد من المعلومات حول التعامل مع إجراءات QUERY
، يُرجى الاطّلاع على تنفيذ الإجراء.
الولايات | النوع | الوصف |
---|---|---|
currentVolume |
عدد صحيح |
مطلوبة. النسبة المئوية الحالية لمستوى الصوت. يجب أن تتراوح القيمة من |
isMuted |
منطقي |
مطلوبة إذا تم ضبط سمة |
أمثلة
مكبّر صوت يمكن كتم صوته ويُبلغ عن حالته الحالية
{ "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 |
عدد صحيح |
مطلوبة. مجلد جديد، من |
أمثلة
ضبط مستوى الصوت المطلق لجهاز مكبّر الصوت
{ "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
عندما يبلغ مستوى الصوت الأدنى بالفعل.