Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기

카메라

네스트 캠

둥지 캠 ™ 사용하기 쉬운 직관적 인 인터넷 연결 기기입니다. 가정의 사용 패턴을 지속적으로 학습하여 에너지를 절약하고 보안과 편안함을 최적화합니다. 사용자는 인터넷에 연결할 수 있는 모든 곳에서 Nest Cam을 제어할 수 있습니다.

둥지 API는 , 권한의 수준에 따라 부여 둥지 캠에 다음과 같은 데이터에 대한 액세스를 제공합니다 :

  • 구조 이름 및 장치 "where name"(집 내 위치)
  • 카메라 온라인 상태 또는 마이크 상태
  • 스트리밍 상태(비디오 스트리밍 켜기/끄기)
  • 장치 이름 및 위치 식별자
  • 마지막 온라인 상태 변경(최근 온라인/오프라인 변경)
  • 둥지 인식 가입 상태가 (안 / 등록 등록)
  • 에 라이브 카메라 피드 딥 링크 둥지 응용 프로그램 (아이폰 OS, 안드로이드) 또는 웹 home.nest.com
  • 다음을 포함하여 알림을 트리거한 마지막 이벤트와 관련된 콘텐츠:
    • 소리 또는 움직임이 감지됨
    • 이벤트 시작/중지 시간
    • 이미지 및 gif 파일에 대한 딥 링크
  • 요청 시 이미지 스냅샷
  • 공유 상태 및 공공 공유 URL
  • 활동 영역 모션 이벤트있을 때 이름, 그리고, 모션이 발생한 ID는 (필요 둥지 인식 )

카메라 유형

Nest API는 다음과 같은 여러 카메라 유형을 지원합니다.

  • Nest Cam Indoor — 최초의 실내 Nest 카메라
  • Nest Cam Outdoor — 오리지널 야외 Nest 카메라
  • Nest Cam IQ 실내 — 정교한 인식, 스피커 및 스냅샷 기능을 지원하는 추가 처리 능력을 갖춘 실내 Nest 카메라
  • Nest Cam IQ Outdoor — 정교한 인식, 스피커 및 스냅샷 기능을 지원하는 추가 처리 능력을 갖춘 실외 Nest 카메라
  • Nest Hello — 비디오 초인종 역할을 하는 카메라

모든 Nest 카메라는 API에 동일한 방식으로 표시됩니다. Nest Hello의 경우 Nest API에는 기기의 카메라 부분만 나타납니다. 카메라 이외의 초인종 기능은 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 기기는 기기 경로를 통해 기기를 고유하게 식별하는 데 사용할 수 있는 ID 배열로 유형별로 나열됩니다. 의 카메라 ID 그래서 "awJo6rH..." 당신의 카메라 장치 모델로드 할 수 있다는 것을 의미합니다 devices/cameras/awJo6rH... API를 통해.

기기가 여러 제품에 연결되면 각 개발자는 해당 기기에 대해 다른 ID를 보게 됩니다. 동일한 개발자의 여러 제품을 설치한 기기의 경우 개발자에게 동일한 ID가 표시됩니다.

이름

구조의 이름은 기본적으로 "Home"으로 지정되지만 사용자가 선택한 모든 문자열이 될 수 있습니다.

name

이러한 예에서, name "아래층"또는 "아래층 (전면 도어)"입니다.

이름 사용이름 사용

name_long

장치의 더 긴 표시 이름입니다. 이 예에서 name_long "사무소 (위층)"입니다.

메시지의 name_long

어디

where_id

  • 나타내는 고유 식별자 생성 둥지 name
  • where_id , 읽기 전용이며 어디에서 사용자 정의 만들 호출에 자동으로 생성되는 name

더의 이름 위치에 대해 알아 둥지 온도 조절 장치는 , 둥지를 보호 하고 둥지 캠 .

where_name

당신이 선택하면 카메라 읽기 권한을 해당 장치에 액세스 할 수 있습니다 where_name 장치 개체 (에서 devices/cameras ).

카메라 기능

비디오 스트림

라이브 스트림

웹 또는 앱에서 라이브 스트림 페이지에 액세스하려면 다음 URL을 사용하세요.

스트리밍 켜기/끄기

사용 is_streaming 끄거나 카메라를 설정하는 필드.

  • 사용자의 홈 네트워크 및 구현에 따라 응답 시간이 지연될 수 있습니다.
  • 스트리밍 상태를 변경하려면 사용자에게 권한을 요청해야 합니다(카메라 켜기/끄기).

마지막 이벤트

last_event 개체가 마지막 검출 소리, 움직임, 또는 개인 이벤트 및 액세스 관련 이미지 나 GIF 파일에 깊은 링크를 가져 오는 데 사용됩니다.

에 대한 일반적인 사용 사례 last_event/has_person 필드는 트리거 조명에, 또는 조용한주기에 세탁을 설정합니다.

보안

은 Using last_event 목적 및 구조물의 away 상태, 구조물의 wwn_security_state 값은 이관 수 ok 하는 deter 다른 장치를 트리거 할 수있다. 참고 항목 보안 가이드를 억지 기능을.

마지막으로 녹화된 이벤트를 표시하는 데 사용되며 사용자가 계정에 로그인해야 합니다.

이미지 또는 GIF 파일

바구니에 고양이

액세스 마지막 이벤트 URL을 귀하의 제품에 대한 위해, 사용자는 활성이 있어야 둥지 인식 구독을, 당신은 카메라 "+ 이미지"클라이언트에 대한 권한 중 하나를 선택해야합니다.

당신이 전화 할 때 image_url 또는 animated_image_url ,이 형식의 URL을 얻을 것이다 :

"STRING1/device_id/STRING2?auth=camera_token"

이 URL을 사용하여 이미지 또는 GIF를 봅니다.

STRING 값은 내부 Nest 전용입니다. STRING 값을 변경하지 마십시오. 그렇지 않으면 호출이 실패합니다.

주문형 스냅샷

이 필드를 사용하여 라이브 비디오 스트림에서 스냅샷을 가져옵니다.

  • snapshot_url - 라이브 비디오 스트림에서 캡처 한 이미지의 URL을 반환
  • 카메라가 켜져 있고 활발하게 스트리밍 중이어야 합니다.

API의 스냅샷 품질은 다음과 같은 경우에만 1080p 처리량입니다.

  • 적극적 프로그램의 카메라 스트림을 볼 ( web_url )
  • 적극적 공개 스트림을 볼 ( app_url )
  • Nest Aware 구독

스트림을 적극적으로 보고 있지 않거나 Nest Aware 구독이 없는 경우 API에는 해당 해상도에서 스냅샷을 검색하고 더 낮은 품질의 이미지를 생성할 1080p 소스가 없습니다. 또한 로컬 네트워크 대역폭이 낮으면 Nest Aware가 있는 상태에서 API 스냅샷 해상도가 1080p 아래로 떨어질 수 있습니다.

에 대해 자세히 알아 둥지 카메라에 대한 대역폭 요구 사항 .

스냅샷 속도 제한

당신이 얻을 전화를 걸 때 snapshot_url , 우리는이 속도 제한을 적용

  • Nest Aware에 가입하지 않은 카메라의 경우 2분
  • Nest Aware 구독이 있는 카메라의 경우 10분/분

활동 구역

액세스 제품에 대한 위해 활동 영역 정보, 사용자는 활성이 있어야 둥지 인식 (가 둥지 캠 IQ가 아닌 경우) 가입을, 당신은 카메라 고객을위한 "+ 이미지"권한 중 하나를 선택해야합니다.

모션 이벤트가 발생하면 모션이 발생한 액티비티 존 ID를 읽을 수 있습니다.

  • activity_zones -list 모든 영역 이름, 사용자 정의 및 자동 생성 된 이름을 포함 (들)
    • 응답 예 : "activity_zones": [ {"name": "Porch", "id": 244083}, {"name": "Walkway", "id": 237084} ... ]
    • 이 예에서 사용자는 기본 "Zone 1"을 "Porch"로, "Zone 2"를 "Walkway"로 변경했습니다.
  • last_event/activity_zone_ids -list 마지막 이벤트 동안에 움직임을 감지 영역 ID의
    • 응답 예 : "activity_zone_ids" : [ "237084", "244083" ]

공개 공유 URL

이 두 필드를 함께 사용하여 사용자가 비디오 스트림을 공개로 설정했는지 확인하고 그렇다면 해당 URL에 액세스하십시오.

백링크 배너

iOS 8 이상용 앱을 빌드하는 경우 Camera API를 사용할 때 백링크를 추가해야 합니다.

매개변수

이름 유형 필수 기술
CUSTOM_SCHEME • 앱의 맞춤 URL 구성표
대한 자세한 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 호출 오류의 의미와이를 처리하는 방법, 무엇을보고에 대한 자세한 내용은 오류 메시지 .