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

Kamera

Nest-Kamera

Cam Nest ™ ist ein Internet-verbundene Gerät , das intuitiv und einfach zu bedienen. Es lernt kontinuierlich die Nutzungsmuster im Haushalt, um Energie zu sparen und Sicherheit und Komfort zu optimieren. Nutzer können Nest Cam von überall aus steuern, wo sie Zugang zu einer Internetverbindung haben.

Das Nest API bietet Zugriff auf die folgenden Daten auf Nest Cam, abhängig von der Höhe der Berechtigungen erteilt:

  • Strukturname und Gerät "wo name" (Ort in der Wohnung)
  • Kamera-Online-Status oder Mikrofonstatus
  • Streaming-Status (Videostreaming ein-/ausschalten)
  • Gerätename und wo-Kennung
  • Letzte Online-Statusänderung (letzte Online-/Offline-Änderung)
  • Nest Aware Abonnementstatus (eingeschrieben / nicht eingeschrieben)
  • Deep - Links zu dem Live - Kamerabild im Nest App (iOS, Android) oder im Internet unter home.nest.com
  • Inhalte im Zusammenhang mit dem letzten Ereignis, das eine Benachrichtigung ausgelöst hat, einschließlich:
    • Geräusch- oder Bewegungsereignis erkannt
    • Start-/Stoppzeiten der Veranstaltung
    • Deeplinks zu Bild- und Gif-Dateien
  • Bildschnappschüsse auf Abruf
  • Freigabestatus und öffentliche Aktien URL
  • Aktivitätszone Namen, und wenn es ein Bewegungsereignis ist, die Ide , wo die Bewegung aufgetreten ist (Voraussetzung : Nest Aware )

Kameratypen

Die Nest API unterstützt verschiedene Kameratypen:

  • Nest Cam Indoor – die ursprüngliche Nest-Kamera für den Innenbereich
  • Nest Cam Outdoor – die ursprüngliche Nest-Außenkamera
  • Nest Cam IQ Indoor – Nest-Kamera für den Innenbereich mit zusätzlicher Rechenleistung, die ausgefeilte Erkennungs-, Lautsprecher- und Schnappschussfunktionen ermöglicht
  • Nest Cam IQ Outdoor – Nest-Außenkamera mit zusätzlicher Rechenleistung, die ausgeklügelte Erkennungs-, Lautsprecher- und Schnappschussfunktionen ermöglicht
  • Nest Hello – eine Kamera, die als Video-Türklingel fungiert

Beachten Sie, dass alle Nest-Kameras in der API auf die gleiche Weise angezeigt werden. Bei Nest Hello wird nur der Kamerateil des Geräts in der Nest API angezeigt. Die Türklingelfunktionalität über die Kamera hinaus ist in der API nicht verfügbar.

Kameraberechtigungen

Die folgenden Zugriffsberechtigungsstufen sind für Nest Cam verfügbar:



Zugriff
Berechtigungen
Kamera lesen

Kamera lesen/schreiben

Kamera lesen + Bilder

Kamera lesen/schreiben + Bilder
Kann alle Werte lesen, ohne:
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
Ja Ja
Kann alle Werte lesen Ja Ja
Schreiben kann is_streaming (Kamera on / off)
• Diese Statusänderung bedarf der ausdrücklichen Nutzungsvertrag
Ja Ja

Für mehr Informationen, die sehen Berechtigungen Übersicht .

Kamerakennungen

Gerät

Nest-Geräte werden nach Typ als Array von IDs aufgelistet, mit denen ein Gerät über den Gerätepfad eindeutig identifiziert werden kann. So eine Kamera - ID "awJo6rH..." bedeutet , dass Sie die Kameras Gerätemodell bei laden können devices/cameras/awJo6rH... über die API.

Wenn ein Gerät mit mehreren Produkten verbunden ist, sieht jeder Entwickler eine andere ID für dieses Gerät. Bei einem Gerät, auf dem mehrere Produkte desselben Entwicklers installiert sind, wird dem Entwickler dieselbe ID angezeigt.

Name

Der Name einer Struktur lautet standardmäßig "Home", kann jedoch eine beliebige Zeichenfolge sein, die der Benutzer wählt.

name

In diesen Beispielen name ist „Unten“ oder „Unten (Vordertür)“.

NamensverwendungNamensverwendung

name_long

Der längere Anzeigename für ein Gerät. In diesem Beispiel name_long ist "Office (Upstairs)".

name_long in einer Nachricht

Wo

where_id

  • Ein einzigartiger, Nest-generierten Identifikator, der darstellt , name
  • where_id ist schreibgeschützt und wird automatisch in dem Aufruf erstellt , um eine benutzerdefinierte zu erstellen , in dem name

Erfahren Sie mehr darüber , wo Namen für Nest Thermostats , Nest schützt und Nest Cams .

where_name

Wenn Sie sich für die Kamera Leseberechtigung können Sie das Gerät zugreifen where_name aus dem Geräteobjekt ( devices/cameras ).

Kamerafunktionen

Videostream

Liveübertragung

Verwenden Sie diese URLs, um über das Web oder eine App auf die Livestream-Seite zuzugreifen:

Streaming ein-/ausschalten

Verwenden Sie das is_streaming Feld die Kamera ein- oder auszuschalten.

  • Je nach Heimnetzwerk des Benutzers und Ihrer Implementierung kann es zu Verzögerungen bei der Reaktionszeit kommen
  • Sie müssen den Benutzer um Erlaubnis bitten, den Streaming-Status zu ändern (Kamera ein-/ausschalten).

Letzte Veranstaltung

Das last_event Objekt wird verwendet , um Deep - Links zu dem letzten erkannten Ton, Bewegung, oder einer Person Ereignisse und den Zugang der zugehörige Bild oder GIF - Datei.

Typische Anwendungsfälle für das last_event/has_person Feld sind Trigger - Leuchten, oder die Wäsche zu einem ruhigen Zyklus gesetzt.

Sicherheit

Unter Verwendung des last_event Objekt und die Struktur away Zustand, der Struktur wwn_security_state Wert kann von eskalieren ok zu deter , die anderen Geräten auslösen können. Siehe die Sicherheitsleitfaden für Abschreckung Funktionen.

Wird verwendet, um das letzte aufgezeichnete Ereignis anzuzeigen, und erfordert, dass der Benutzer beim Konto angemeldet ist.

Bild- oder GIF-Dateien

Katze im Korb

Damit Ihr Produkt des letzte Ereignis URLs zugreifen, muss der Benutzer ein aktives hat Nest Aware Abonnement, und Sie müssen eine der Kamera „+ Bilder“ Berechtigungen für Ihre Kunden auswählen.

Wenn Sie einen Anruf für machen image_url oder animated_image_url , erhalten Sie eine URL in diesem Format erhalten:

"STRING1/device_id/STRING2?auth=camera_token"

Verwenden Sie diese URL, um ein Bild oder GIF anzuzeigen.

Beachten Sie, dass die STRING-Werte nur für die interne Verwendung von Nest bestimmt sind. Ändern Sie die STRING-Werte nicht, sonst schlägt der Aufruf fehl.

Schnappschuss auf Anfrage

Verwenden Sie dieses Feld, um einen Schnappschuss aus dem Live-Videostream zu erhalten.

  • snapshot_url - gibt die URL eines Bildes aus dem Live - Video - Stream erfasst
  • Erfordert, dass die Kamera eingeschaltet ist und aktiv streamt

Die Snapshot-Qualität der API beträgt nur 1080p-Durchsatz, wenn Sie:

  • aktiv Betrachten der Kamera - Stream in der Anwendung ( web_url )
  • aktiv den öffentlichen Stream sehen ( app_url )
  • Nest Aware abonniert

Wenn du den Stream nicht aktiv ansiehst oder kein Nest Aware-Abo hast, hat die API keine 1080p-Quelle, um einen Schnappschuss mit dieser Auflösung abzurufen, und erzeugt ein Bild mit geringerer Qualität. Außerdem kann eine niedrige lokale Netzwerkbandbreite dazu führen, dass die API-Snapshot-Auflösung unter 1080p sinkt, wenn Nest Aware vorhanden ist.

Erfahren Sie mehr über die Bandbreitenanforderungen für Nest Kameras .

Begrenzung der Snapshot-Rate

Wenn Sie einen Anruf tätigen , die bekommen snapshot_url , wenden wir diese Rate Grenzen:

  • 2/Minute für Kameras ohne Nest Aware-Abo
  • 10 Minuten für Kameras mit Nest Aware-Abo

Aktivitätszonen

Damit Ihr Produkt Zugang Activity Zone Informationen, muss der Benutzer ein aktives hat Nest Aware Abonnement (es sei denn , es ist ein Nest Cam IQ ist), und Sie müssen eine der Kamera „+ Bilder“ Berechtigungen für Ihre Kunden auswählen.

Wenn ein Bewegungsereignis auftritt, können Sie die Aktivitätszonen-IDs lesen, in denen die Bewegung aufgetreten ist.

  • activity_zones -Liste alle Zonennamen, einschließlich benutzerdefiniert und automatisch generierten Name (n)
    • Beispielantwort: "activity_zones": [ {"name": "Porch", "id": 244083}, {"name": "Walkway", "id": 237084} ... ]
    • In diesem Beispiel hat der Benutzer die Standardeinstellung "Zone 1" in "Veranda" und "Zone 2" in "Walkway" geändert.
  • last_event/activity_zone_ids -Liste des Zone - IDs , die Bewegung während des letzten Ereignisses detektiert
    • Beispielantwort: "activity_zone_ids" : [ "237084", "244083" ]

Öffentliche Freigabe-URL

Verwenden Sie diese beiden Felder zusammen, um zu überprüfen, ob der Benutzer den Videostream öffentlich gemacht hat, und greifen Sie in diesem Fall auf diese URL zu.

Backlink-Banner

Wenn Sie eine App für iOS 8 oder höher erstellen, müssen Sie Backlinks hinzufügen, wenn Sie die Kamera-API verwenden.

Parameter

Name Art Erforderlich Beschreibung
CUSTOM_SCHEME Schnur Ja • Benutzerdefiniertes URL-Schema für Ihre App
mehr über URI - Systeme lernen
APPNAME Schnur Ja • Name Ihrer App
• Wird im Rücksendebanner angezeigt
• Lokalisierbar
BACKLINK_PATH Schnur Ja • Pfad zurück zu Ihrer App
mehr über Backlinks Lernen

Machen Sie den Anruf

Wenn Sie einen Flow erstellen, in dem Ihr Benutzer den Live-Videostream oder ein Ereignis anzeigt, fügen Sie den Backlink-Pfad hinzu:

  1. Erhalten Sie den app_url aus dem Nest API. Es sollte wie folgt aussehen: "nestmobile://cameras/CjZHZ….7IYIm?auth=c.QbpCljxi5...Ny4gh&"
  2. Fügen Sie Ihre Parameter an der app_url in diesem Query - String - Format :
    "nestmobile://cameras/CjZHZ….7IYIm?auth=c.QbpCljxi5...Ny4gh&appname=APPNAME&backlink=CUSTOM_SCHEME://BACKLINK_PATH"

Fehlermeldungen

Für Informationen darüber , was API - Aufruf Fehler bedeuten und wie sie zu behandeln, siehe Fehlermeldungen .