Google is committed to advancing racial equity for Black communities. See how.

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

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

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

و API عش يوفر الوصول إلى البيانات التالية على عش حماية:

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

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

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

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

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

جهاز

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

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

اسم

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

name

في هذا المثال، name هو "عش حماية".

اسم

name_long

في هذا المثال، name_long هو "بدروم عش حماية".

الاسم طويل

أين

where_id

  • فريد، معرف ولدت عش التي تمثل name
  • where_id للقراءة فقط، ويتم إنشاؤه تلقائيا في الدعوة إلى خلق العرف حيث name

تعلم المزيد عن أسماء حيث الحرارة عش ،عش يحمي و عش الحدب .

where_name

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

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

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

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

ميزات الدخان + ثاني أكسيد الكربون

صحة البطارية

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

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

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

استخدام co_alarm_state الحقل لعرض حالة CO التنبيه.

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

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

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

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

الاختبار اليدوي

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

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

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

رسائل خاطئة

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