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

מַצלֵמָה

מצלמת קן

קן מצלמת ™ הוא מכשיר המחובר לאינטרנט כי הוא אינטואיטיבי וקל לשימוש. זה לומד ללא הרף על דפוסי השימוש בבית כדי לחסוך באנרגיה, ולייעל את הביטחון והנוחות. משתמשים יכולים לשלוט על Nest Cam מכל מקום שיש להם גישה לחיבור לאינטרנט.

API קן מספק גישה לנתונים הבאים על מצלמת Nest, תלוי ברמת ההרשאות שניתנו:

  • שם המבנה והתקן "איפה שם" (מיקום בבית)
  • מצב מקוון של מצלמה או מצב מיקרופון
  • סטטוס סטרימינג (הפעלה / כיבוי של הזרמת וידאו)
  • שם המכשיר והיכן מזהה
  • שינוי סטטוס מקוון אחרון (שינוי מקוון / לא מקוון אחרון)
  • Nest Aware מצב המנוי (רשום / לא רשום)
  • קישורים עמוקים להאכיל מצלמת חית אפליקציית Nest (iOS, Android) או באינטרנט בכתובת home.nest.com
  • תוכן הקשור לאירוע האחרון שהפעיל התראה, כולל:
    • אירוע קול או תנועה זוהה
    • זמני התחלה / עצירה של האירוע
    • קישורים עמוקים לקבצי תמונה ו- gif
  • תמונות תמונות לפי דרישה
  • מצב שיתוף URL נתח הציבור
  • פעילות אזור שמות, וכאשר יש אירוע בתנועה, את האיד שבו התנועה התרחשה (דורש Nest Aware )

סוגי מצלמות

ה- API של Nest תומך בכמה סוגי מצלמות:

  • Nest Cam Indoor - מצלמת Nest המקורה המקורית
  • Nest Cam Outdoor - מצלמת Nest המקורית החיצונית
  • Nest Cam IQ מקורה - מצלמת Nest מקורה עם עוצמת עיבוד נוספת, המאפשרת זיהוי מתוחכם, רמקול ותכונות תמונת מצב
  • Nest Cam IQ Outdoor - מצלמת קן חיצונית עם עוצמת עיבוד נוספת, המאפשרת זיהוי מתוחכם, רמקולים ותכונות של תמונת מצב
  • Nest Hello - מצלמה שמתפקדת כפעמון וידאו

שים לב שכל מצלמות Nest מופיעות ב- API באותו אופן. במקרה של Nest Hello, רק חלק המצלמה של המכשיר מופיע בממשק ה- API של Nest. פונקציונליות של פעמון הדלת מעבר למצלמה אינה זמינה בממשק ה- API.

הרשאות מצלמה

רמות הרשאות הגישה הבאות זמינות עבור Nest Cam:



גִישָׁה
אישורים
קריאת מצלמה

מצלמה קריאה / כתיבה

תמונות קריאה + מצלמה

מצלמת קריאה / כתיבה + תמונות
האם ניתן לקרוא את כל הערכים, למעט:
activity_zones
is_public_share_enabled
public_share_url
snapshot_url
last_event/image_url
last_event/animated_image_url
last_event/activity_zone_ids
כן כן
יכול לקרוא את כל הערכים כן כן
ניתן לכתוב is_streaming (המצלמה on / off)
• שינוי מצב זה מחייב את סכם משתמשים מפורש
כן כן

למידע נוסף, ראה סקירת ההרשאות .

מזהי מצלמה

התקן

מכשירי Nest רשומים לפי סוג כמערך של מזהים, שניתן להשתמש בהם לזיהוי ייחודי של מכשיר דרך נתיב המכשיר. אז מצלמה מזהה של "awJo6rH..." כלומר, אתה יכול לטעון את דגם מכשיר מצלמות בבית devices/cameras/awJo6rH... דרך ממשק ה- API.

כאשר מכשיר מחובר למספר מוצרים, כל מפתח יראה מזהה אחר עבור אותו מכשיר. עבור מכשיר שהתקין מספר מוצרים מאותו מפתח, המפתח יראה את אותו מזהה.

שֵׁם

שם המבנה כברירת מחדל הוא "בית" אך יכול להיות כל מחרוזת שהמשתמש יבחר.

name

בדוגמאות אלה, name הוא "למטה" או "למטה (דלת קדמית)".

שימוש בשמותשימוש בשמות

name_long

שם התצוגה הארוך יותר של מכשיר. בדוגמה זו, name_long הוא "המשרד (למעלה)".

שם_מסר בהודעה

איפה

where_id

  • מזהה ייחודי, שנוצר קן שמייצג name
  • where_id הוא לקריאה בלבד, והוא נוצר אוטומטית את השיחה כדי ליצור מנהג שבו name

למידע נוסף על שם שמות תרמוסטט קן ,קן מגן ו מצלמות קן .

where_name

כאשר אתה בוחר את אישור קריאת המצלמה , אתה יכול לגשת למכשיר where_name מאובייקט המכשיר ( devices/cameras ).

תכונות מצלמה

זרם וידאו

שידור חי

השתמש בכתובות אתרים אלה כדי לגשת לדף הזרם החי מהאינטרנט או מאפליקציה:

הפעל / כבה את הסטרימינג

השתמש is_streaming השדה להפוך את המצלמה או לכבות.

  • בהתאם לרשת הביתית של המשתמש וההטמעה שלך, ייתכן שיש עיכוב בזמן התגובה
  • עליך לבקש מהמשתמש אישור לשנות את סטטוס הסטרימינג (להפעיל / לכבות את המצלמה)

אירוע אחרון

last_event האובייקט משמש כדי לקבל קישורים עמוקים לקול זוהה האחרון, תנועה, או אירוע אדם, וגישה התמונה קשורה או קובץ GIF.

במקרי שימוש טיפוסיים last_event/has_person השדה הם אורות הדק, או להגדיר את הכביסה למחזור שקט.

בִּטָחוֹן

שימוש last_event האובייקט של המבנה away המדינה, של המבנה wwn_security_state ערך יכול להסלים מ ok כדי deter , אשר יכול לגרום למכשירים אחרים. ראה מדריך האבטחה עבור תכונות הרתעה.

משמש להצגת האירוע שהוקלט האחרון ומחייב את המשתמש בכניסה לחשבון.

קבצי תמונה או GIF

חתול בסל

על מנת המוצר שלך להיכנס לכתוב האירוע האחרונות, המשתמש חייב להיות בעל פעיל Aware קן מנוי, ואתה חייב לבחור אחד המצלמה "+ תמונות" הרשאות עבור לקוח שלך.

כאשר אתה מבצע שיחה עבור image_url או animated_image_url , תקבל כתובת האתר בפורמט הזה:

"STRING1/device_id/STRING2?auth=camera_token"

השתמש בכתובת אתר זו כדי להציג תמונה או קובץ GIF.

שים לב שערכי STRING מיועדים לשימוש פנימי ב- Nest בלבד. אל תשנה את ערכי STRING, אחרת השיחה תיכשל.

תמונת מצב על פי דרישה

השתמש בשדה זה כדי לקבל תמונת מצב מזרם הווידאו החי.

  • snapshot_url - ומחזיר את כתובת האתר של התמונה שצולמה מהנחל וידאו חי
  • דורש שהמצלמה מופעלת וזורם באופן פעיל

איכות תמונת המצב מממשק ה- API היא תפוקת 1080p בלבד אם אתה:

  • הצגת זרם המצלמה באופן פעיל ביישום ( web_url )
  • הצגת הזרם הציבורי פעיל ( app_url )
  • נרשם ל- Nest Aware

אם אינך צופה בזרם פעיל או שאין לך מנוי ל- Nest Aware, ל- API אין מקור 1080p ממנו ניתן לאחזר תמונת מצב ברזולוציה זו ויוצר תמונה באיכות נמוכה יותר. כמו כן, רוחב פס של רשת מקומית נמוכה עלול לגרום לרזולוציית תמונת המצב של ה- API לרדת מתחת ל -1080 p כאשר Nest Aware קיים.

למידע נוסף על דרישות רוחב פס עבור קן מצלמות .

מגבלות קצב תצלום

כאשר אתה מבצע שיחה כדי לקבל את snapshot_url , אנחנו מיישמים גבולות השיעור הבאים:

  • 2 / דקה למצלמות שאין להן מנוי ל- Nest Aware
  • 10 / דקה למצלמות עם מנוי ל- Nest Aware

אזורי פעילות

על מנת המוצר שלך לגישת פעילות אזור מידע, המשתמש חייב להיות בעל פעיל Aware קן מנוי (אלא אם כן מדובר Nest Cam IQ), ואתה חייב לבחור אחד המצלמה "+ תמונות" הרשאות עבור לקוח שלך.

כשיש אירוע תנועה, אתה יכול לקרוא את מזהי אזור הפעילות שבהם התנועה התרחשה.

  • activity_zones -list של כול שמות האזור, כולל שם משתמש מוגדר באופן אוטומטי (ים)
    • דוגמה בתגובה: "activity_zones": [ {"name": "Porch", "id": 244083}, {"name": "Walkway", "id": 237084} ... ]
    • בדוגמה זו, המשתמש שינה את ברירת המחדל "אזור 1" ל"מרפסת ", ו"אזור 2" ל"דרך "
  • last_event/activity_zone_ids -list של מזהי אזור שזיהה תנועה במהלך האירוע האחרון
    • דוגמה בתגובה: "activity_zone_ids" : [ "237084", "244083" ]

כתובת אתר לשיתוף ציבורי

השתמש בשני השדות האלה יחד כדי לבדוק אם המשתמש הפך את זרם הווידיאו לציבורי, ואם כן, גש לכתובת אתר זו.

באנר קישור לאחור

אם אתה בונה אפליקציה עבור iOS 8 ואילך, יהיה עליך להוסיף קישורים נכנסים בעת השימוש בממשק ה- API.

פרמטרים

שֵׁם סוּג נדרש תיאור
CUSTOM_SCHEME חוּט כן • ערכת כתובות אתרים מותאמת אישית לאפליקציה שלך
למידע נוסף על תוכניות URI
APPNAME חוּט כן • שם האפליקציה שלך
• מוצג בבאנר ההחזרה
• ניתן למקם
BACKLINK_PATH חוּט כן • נתיב חזרה לאפליקציה שלך
למידע נוסף על קישורים נכנסים

בצע את השיחה

כשאתה בונה זרימה שבה המשתמש שלך צופה בזרם הווידאו החי או באירוע, כלול את נתיב הקישור לאחור:

  1. קבל את app_url מה- API קן. זה צריך להיראות בערך כך: "nestmobile://cameras/CjZHZ….7IYIm?auth=c.QbpCljxi5...Ny4gh&"
  2. להוסיף את הפרמטרים שלך אל app_url זה בפורמט מחרוזת השאילתה :
    "nestmobile://cameras/CjZHZ….7IYIm?auth=c.QbpCljxi5...Ny4gh&appname=APPNAME&backlink=CUSTOM_SCHEME://BACKLINK_PATH"

הודעות שגיאה

לקבלת מידע על מה שגיאות קריאה API אומר ואיך לטפל בהם, לראות הודעות שגיאה .