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

Kamera

yuva kamerası

Nest Cam ™ kullanımı kolay sezgisel ve bir Internet bağlantılı bir cihazdır. Enerji tasarrufu yapmak, güvenlik ve konforu optimize etmek için evdeki kullanım kalıplarını sürekli öğrenir. Kullanıcılar, Nest Cam'i İnternet bağlantısına sahip oldukları her yerden kontrol edebilirler.

Nest API , izin düzeyine bağlıdır verilmiş, Nest Cam aşağıdaki verilere erişim sağlar:

  • Yapı adı ve cihaz "nerede adı" (evdeki konum)
  • Kamera çevrimiçi durumu veya mikrofon durumu
  • Akış durumu (video akışını aç/kapat)
  • Cihaz adı ve nerede tanımlayıcı
  • Son çevrimiçi durum değişikliği (son çevrimiçi/çevrimdışı değişiklik)
  • Nest Aware abonelik durumu (değil / kayıtlı kayıtlı)
  • Canlı kamera beslemesine Derin bağlantılar Nest uygulamasından (iOS, Android) veya web üzerinde home.nest.com
  • Aşağıdakiler dahil olmak üzere bir bildirimi tetikleyen son olayla ilgili içerik:
    • Ses veya hareket olayı algılandı
    • Etkinlik başlama/durma saatleri
    • Resim ve gif dosyalarına derin bağlantılar
  • Talep üzerine anlık görüntüler
  • Paylaşım durumu ve kamu payı URL
  • Etkinlik bölgesi bir hareket olayı olduğunda adları ve hareket meydana kimlikleri (gerektirir Yuvası farkında )

Kamera türleri

Nest API, birkaç kamera türünü destekler:

  • Nest Cam İç Mekan — orijinal iç mekan Nest kamerası
  • Nest Cam Outdoor — orijinal dış mekan Nest kamerası
  • Nest Cam IQ İç Mekan — gelişmiş tanıma, hoparlör ve anlık görüntü özellikleri sağlayan ek işlem gücüne sahip iç mekan Nest kamerası
  • Nest Cam IQ Outdoor — gelişmiş tanıma, hoparlör ve anlık görüntü özellikleri sağlayan ek işlem gücüne sahip dış mekan Nest kamerası
  • Nest Hello — görüntülü kapı zili işlevi gören bir kamera

Tüm Nest kameraların API'de aynı şekilde göründüğünü unutmayın. Nest Hello durumunda, Nest API'sinde cihazın yalnızca kamera kısmı görünür. Kameranın ötesindeki kapı zili işlevi API'de mevcut değildir.

Kamera izinleri

Nest Cam için aşağıdaki erişim izni seviyeleri mevcuttur:



Giriş
izinler
kamera okuma

Kamera okuma/yazma

Kamera okuması + görüntüler

Kamera okuma/yazma + görüntüler
Hariç tüm değerleri okuyabilir:
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
Evet Evet
Tüm değerleri okuyabilir Evet Evet
Yazabilir is_streaming (kamera açma / kapama)
• Bu durum değişikliği açık kullanıcı sözleşmesini gerektirir
Evet Evet

Daha fazla bilgi için, bkz izinler Genel Bakış .

Kamera tanımlayıcıları

cihaz

Yuva cihazları, cihaz yolu aracılığıyla bir cihazı benzersiz bir şekilde tanımlamak için kullanılabilen bir kimlik dizisi olarak türe göre listelenir. Bir kamera kimliği Yani "awJo6rH..." En kameralar cihaz modeli yükleyebilmesini yollarla devices/cameras/awJo6rH... API üzerinden.

Bir cihaz birden fazla ürüne bağlandığında, her geliştirici o cihaz için farklı bir kimlik görür. Aynı geliştiriciden birden fazla ürün yükleyen bir cihaz için geliştirici aynı kimliği görür.

isim

Bir yapının adı varsayılan olarak "Ev"dir, ancak kullanıcının seçtiği herhangi bir dize olabilir.

name

Bu örneklerde, name "Aşağı" veya "Alt katta (Ön Kapı)" dir.

isim kullanımıisim kullanımı

name_long

Bir aygıtın daha uzun görünen adı. Bu örnekte, name_long "Ofisi (Üst katta)" dir.

bir mesajda name_long

Nerede

where_id

  • Temsil eden bir tek, Yuva oluşturulan tanımlayıcı name
  • where_id , salt okunur ve nerede bir özel oluşturmak için çağrıda otomatik olarak oluşturulur name

Daha fazla bilgi için isimleri nerede öğrenin Nest Termostatlar ,Nest korur ve Yuvası Kameralar .

where_name

SeçtiğinizdeYeni Kamera okuma izni , cihazı erişebilirsiniz where_name aygıt nesnesi (gelen devices/cameras ).

Kamera özellikleri

Video akışı

Canlı yayın

Web'den veya bir uygulamadan canlı akış sayfasına erişmek için bu URL'leri kullanın:

Akışı aç/kapat

Kullanın is_streaming veya kapatmak kamerayı açmak için alan.

  • Kullanıcının ev ağına ve uygulamanıza bağlı olarak yanıt süresinde bir gecikme olabilir
  • Akış durumunu değiştirmek için kullanıcıdan izin istemeniz gerekir (kamerayı açın/kapatın)

Son olay

last_event nesne son tespit edilen ses, hareket, ya da kişi olay ve erişim ilgili görüntü veya GIF dosyası derin bağlantılarını almak için kullanılır.

İçin tipik kullanım durumları last_event/has_person alanına tetik ışıklarına, ya sakin döngüsüne çamaşırları ayarlayın.

Güvenlik

Kullanılması last_event nesne ve yapının away durumunu, yapının wwn_security_state değeri dan iletebilmemiz ok için deter diğer aygıtları tetikleyebileceğini. Bkz Güvenlik Kılavuzu'na önleyici özellikler sunan.

Son kaydedilen olayı görüntülemek için kullanılır ve kullanıcının hesapta oturum açmasını gerektirir.

Resim veya GIF dosyaları

Sepet içinde kedi

Erişim son olay URL'ler için ürününüzün amacıyla, kullanıcı aktif olmalıdır Nest Aware abonelik ve Kamera "+ görüntüleri" müşteriniz için izinler biri seçmelisiniz.

Eğer arama için zaman image_url veya animated_image_url , şu biçimde bir URL alırsınız:

"STRING1/device_id/STRING2?auth=camera_token"

Bir resmi veya GIF'i görüntülemek için bu URL'yi kullanın.

STRING değerlerinin yalnızca dahili Nest kullanımı için olduğunu unutmayın. STRING değerlerini değiştirmeyin, aksi takdirde arama başarısız olur.

Talep üzerine anlık görüntü

Canlı video akışından bir anlık görüntü almak için bu alanı kullanın.

  • snapshot_url - canlı video akışı yakalanan bir resmin URL'sini döndürür
  • Kameranın açık olmasını ve aktif olarak akışını gerektirir

Aşağıdaki durumlarda API'den alınan anlık görüntü kalitesi yalnızca 1080p çıktıdır:

  • aktif uygulamada kamera akışını inceleyen ( web_url )
  • aktif kamu akışını inceleyen ( app_url )
  • Nest Aware'e abone olun

Akışı aktif olarak görüntülemiyorsanız veya Nest Aware aboneliğiniz yoksa API'nin bu çözünürlükte anlık görüntü alabileceği 1080p kaynağı yoktur ve daha düşük kaliteli bir görüntü oluşturur. Ayrıca, düşük yerel ağ bant genişliği, Nest Aware mevcutken API anlık görüntü çözünürlüğünün 1080p'nin altına düşmesine neden olabilir.

Hakkında daha fazla bilgi Nest Kameralar için bant genişliği gereksinimleri .

Anlık görüntü oranı sınırları

Eğer almak için bir arama yaptığınızda snapshot_url , bu oran sınırlarını geçerlidir:

  • Nest Aware aboneliği olmayan kameralar için 2/dakika
  • Nest Aware aboneliği olan kameralar için 10/dakika

Faaliyet Alanları

Erişim için ürününüzün amacıyla Etkinlik Bölge bilgiler, kullanıcı aktif olmalıdır Nest Aware (bir Nest Cam IQ olmadığı sürece) abonelik ve Kamera müşteriniz için "+ görüntüleri" izinleri biri seçmelisiniz.

Bir hareket olayı olduğunda, hareketin meydana geldiği etkinlik bölgesi kimliklerini okuyabilirsiniz.

  • activity_zones -list tüm bölge isimleri, kullanıcı tanımlı ve otomatik olarak üretilen adı dahil (lar)
    • Örnek yanıt: "activity_zones": [ {"name": "Porch", "id": 244083}, {"name": "Walkway", "id": 237084} ... ]
    • Bu örnekte, kullanıcı varsayılan "Bölge 1"i "Sundurma" olarak ve "Bölge 2"yi "Yol" olarak değiştirmiştir.
  • last_event/activity_zone_ids -list son olay sırasında hareket tespit bölgesi kimlikleri
    • Örnek tepkisi: "activity_zone_ids" : [ "237084", "244083" ]

Herkese açık paylaşım URL'si

Kullanıcının video akışını herkese açık yapıp yapmadığını kontrol etmek için bu iki alanı birlikte kullanın ve öyleyse bu URL'ye erişin.

geri bağlantı afişi

iOS 8 veya üstü için bir uygulama oluşturuyorsanız, Kamera API'sini kullanırken geri bağlantılar eklemeniz gerekir.

parametreler

isim Tür gereklidir Açıklama
CUSTOM_SCHEME dize Evet • Uygulamanız için özel URL şeması
hakkında daha URI şemaları bilgi
APPNAME dize Evet • Uygulamanızın adı
• İade başlığında görüntülenir
• Yerelleştirilebilir
BACKLINK_PATH dize Evet • Uygulamanıza geri dönüş yolu
geri hakkında daha fazla bilgi

Arama yap

Kullanıcınızın canlı video akışını veya bir olayı görüntülediği bir akış oluşturduğunuzda, geri bağlantı yolunu ekleyin:

  1. Alma app_url Nest API. Bu gibi görünmelidir: "nestmobile://cameras/CjZHZ….7IYIm?auth=c.QbpCljxi5...Ny4gh&"
  2. Parametrelerinizi ekleyin app_url bu sorgu dizesi biçimi :
    "nestmobile://cameras/CjZHZ….7IYIm?auth=c.QbpCljxi5...Ny4gh&appname=APPNAME&backlink=CUSTOM_SCHEME://BACKLINK_PATH"

Hata mesajları

API çağrısı hataları anlama ve bunların nasıl işleneceğine, gördükleri hakkında bilgi için Hata Mesajları .