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

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

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 عندما يبلغ مستوى الصوت الأدنى بالفعل.