تلتزم Google بتعزيز المساواة العرقية للمجتمعات السوداء. أنظر كيف.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

إنذار الدخان + أول أكسيد الكربون

إنذار الدخان + أول أكسيد الكربون

تم تصميم Nest Protect للكشف عن الدخان وأول أكسيد الكربون (CO) في بيئة سكنية ، مع أجهزة استشعار متعددة لمساعدتها على فهم ما يحدث في المنزل.

توفر Nest API الوصول إلى البيانات التالية على Nest Protect:

  • حالة إنذار الدخان أو أول أكسيد الكربون (CO)
  • حالة صحة البطارية
  • آخر حالة اختبار يدوي والطابع الزمني
  • حالة الاتصال ومعلومات الاتصال الأخيرة
  • اسم الهيكل والجهاز "حيث الاسم" (الموقع في المنزل)

أذونات الدخان + CO

للوصول للقراءة إلى جميع قيم بيانات واجهة برمجة تطبيقات إنذار Smoke + CO ، حدد إذن قراءة Smoke + CO لعميلك.

لا تتوفر أذونات الكتابة لواجهة برمجة تطبيقات إنذار Smoke + CO.

معرفات الدخان + أول أكسيد الكربون

جهاز

يتم إدراج أجهزة Nest حسب النوع كمصفوفة من المعرفات ، والتي يمكن استخدامها لتعريف الجهاز بشكل فريد عبر مسار الجهاز. إذاً ، معرف التنبيه الدخان + المشترك "RTMTKxs..." يعني أنه يمكنك تحميل طراز جهاز الإنذار الدخان + المشترك على devices/smoke_co_alarms/RTMTKxs... عبر واجهة برمجة التطبيقات.

عند توصيل جهاز بمنتجات متعددة ، سيرى كل مطور معرفًا مختلفًا لهذا الجهاز. بالنسبة للجهاز الذي قام بتثبيت العديد من المنتجات من نفس المطور ، سيرى المطور نفس المعرّف.

اسم

يتم توفير سمتين اسم. يتم عرض سمة name الأقصر في تسميات واجهة المستخدم ، بينما يتم استخدام name_long في نص طويل.

name

في هذا المثال ، name هو "Nest Protect".

اسم

name_long

في هذا المثال ، name_long هو "Basement Nest Protect".

اسم طويل

أين

where_id

  • معرّف فريد من نوعه يتم إنشاؤه بواسطة Nest يمثل name
  • where_id للقراءة فقط ، ويتم إنشاؤه تلقائيًا في المكالمة لإنشاء name مخصص

تعرف على مزيد من المعلومات حول مكان أسماء Nest Thermostats و Nest Protects و Nest Cams .

where_name

عندما تختار إذن قراءة Smoke + CO ، يمكنك الوصول إلى الجهاز حيث where_name من كائن الجهاز ( devices/smoke_co_alarms ).

البيانات الوصفية الأخرى

جميع قيم البيانات للقراءة فقط ، ما لم ينص على خلاف ذلك.

قيمة البيانات وصف
locale اللغة ورمز البلد المخصص لهذا الجهاز
software_version سلسلة تمثل البرامج الثابتة المثبتة حاليًا على الجهاز
structure_id سلسلة تمثل هذه البنية بشكل فريد ؛ هذا هو الهيكل الذي يتم إقران الجهاز به
last_connection الطابع الزمني لآخر اتصال ناجح بخدمة Nest
is_online الموجودين. يتم تحديد ذلك بواسطة Nest باستخدام وقت last_connection ونافذة إعادة الاتصال المتوقعة الخاصة بالجهاز.

ميزات الدخان + CO

صحة البطارية

استخدم الحقل battery_health لعرض حالة صحة البطارية.

القيمة وصف
ok مستوى البطارية طيب
replace مستوى البطارية منخفض ، يجب استبداله

إنذار أول أكسيد الكربون

استخدم الحقل co_alarm_state لعرض حالة الإنذار CO.

القيمة وصف
ok عملية عادية
warning الكشف عن ارتفاع مستويات أول أكسيد الكربون
emergency مستويات ثاني أكسيد الكربون مرتفعة جدًا ، يجب على المستخدم الخروج من المنزل

جهاز انذار الدخان

استخدم حقل smoke_alarm_state لعرض حالة إنذار الدخان.

القيمة وصف
ok عملية عادية
warning الكشف عن ارتفاع مستويات الدخان
emergency مستويات الدخان مرتفعة للغاية ، يجب على المستخدم الخروج من المنزل

اختبار يدوي

استخدم هذه الحقول للتحقق مما إذا كان اختبار الدخان أو أول أكسيد الكربون نشطًا حاليًا ، وآخر مرة تم فيها اختبار الدخان أو أول أكسيد الكربون بنجاح.

حالة لون واجهة المستخدم

لتسهيل تصميم واجهة مستخدم متناسقة عبر المنتجات ، قدمنا ​​حقل ui_color_state ، والذي يعطي إشارة عالية المستوى للحالة العامة لـ Nest Protect. وهو مستمد من is_online ، battery_health ، co_alarm_state ، و smoke_alarm_state ، وتوفير حالة المجمعة التي تعكس مؤشرات لون الفعلية التي يتم عرضها في التطبيق عش .

رسائل خاطئة

للحصول على معلومات حول معنى أخطاء مكالمات API وكيفية معالجتها ، راجع رسائل الخطأ .