مرحبًا بك في "مركز مطوّري Google Home"، الوجهة الجديدة لتعلّم كيفية تطوير المهام المنزلية الذكية. ملاحظة: ستواصل إنشاء إجراءات في "وحدة تحكّم المهام".

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

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

سمات الجهاز

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

السمات Type الوصف
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. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في QUERY، يُرجى الاطّلاع على تنفيذ النية بالشراء.

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

مطلوب:

النسبة المئوية الحالية للحجم. يجب أن تتراوح المدّة بين >0 وvolumeMaxLevel.

isMuted منطقي

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

أمثلة

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

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

حوالات الجهاز

قد تستجيب الأجهزة التي تستخدم هذه السمة للأوامر التالية كجزء من عملية EXECUTE. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في EXECUTE، يُرجى الاطّلاع على تنفيذ النية بالشراء.

action.devices.commands.mute

يتم كتم صوت الجهاز أو إعادته.

المعلّمات

المعلّمات Type الوصف
mute منطقي

مطلوب:

يمكنك كتم صوت الجهاز أو إعادة صوته.

أمثلة

كتم صوت جهاز مكبّر الصوت

{
  "command": "action.devices.commands.mute",
  "params": {
    "mute": true
  }
}

action.devices.commands.setVolume

ضبط مستوى الصوت على المستوى المطلوب، استنادًا إلى volumeMaxLevel

المعلّمات

المعلّمات Type الوصف
volumeLevel عدد صحيح

مطلوب:

مجلد جديد من 0 إلى volumeMaxLevel.

أمثلة

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

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

action.devices.commands.volumeRelative

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

المعلّمات

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

مطلوب:

سلبي لـ "خفض".

أمثلة

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

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

أخطاء الجهاز

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