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

Камера

Nest Cam

Гнездо Cam ™ представляет собой интернет-подключенное устройство , которое является интуитивно понятным и простым в использовании. Он постоянно узнает о моделях использования в доме, чтобы экономить энергию и оптимизировать безопасность и комфорт. Пользователи могут управлять Nest Cam из любого места, где у них есть доступ к Интернету.

Nest API предоставляет доступ к следующим данным о Nest Cam, в зависимости от уровня доступа предоставляется:

  • Название структуры и устройство «где имя» (местонахождение в доме)
  • Статус камеры онлайн или статус микрофона
  • Статус потоковой передачи (включение / выключение потоковой передачи видео)
  • Имя устройства и где идентификатор
  • Последнее изменение сетевого статуса (последнее изменение онлайн / офлайн)
  • Nest Aware статус подписки (зачислен / не поступил)
  • Глубокие ссылки на корм живой камеры в приложении Nest (IOS, Android) или в Интернете по адресу home.nest.com
  • Контент, связанный с последним событием, вызвавшим уведомление, в том числе:
    • Обнаружен звук или движение
    • Время начала / окончания события
    • Ссылки на файлы изображений и GIF
  • Снимки изображений по запросу
  • Совместное использование статуса и доли URL общественности
  • Зона Активность имена, и когда есть событие движения, идентификаторы , где имело место движения (Требует Nest Aware )

Типы камер

Nest API поддерживает несколько типов камер:

  • Nest Cam Indoor - оригинальная комнатная камера Nest
  • Nest Cam Outdoor - оригинальная уличная камера Nest
  • Nest Cam IQ Indoor - домашняя камера 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 (камера включения / выключения)
• Это изменение статуса требует явного пользовательского соглашения
да да

Для получения дополнительной информации см Обзор разрешений .

Идентификаторы камеры

Устройство

Вложенные устройства перечислены по типу в виде массива идентификаторов, которые можно использовать для однозначной идентификации устройства по пути к устройству. Так камерой ИД "awJo6rH..." означает , что вы можете загрузить модель камеры устройства на devices/cameras/awJo6rH... через API.

Когда устройство подключено к нескольким продуктам, каждый разработчик будет видеть свой идентификатор для этого устройства. Для устройства, на котором установлено несколько продуктов от одного разработчика, разработчик увидит один и тот же идентификатор.

Имя

Имя структуры по умолчанию «Домашняя», но может быть любой строкой по выбору пользователя.

name

В этих примерах name является « На первом этаже» или « На первом этаже (передняя дверь)».

использование именииспользование имени

name_long

Более длинное отображаемое имя устройства. В этом примере, name_long является «Офис (Наверху)».

name_long в сообщении

Где

where_id

  • Уникальный, гнездо сгенерированный идентификатор , который представляет собой name
  • where_id только для чтения, и создается автоматически при вызове , чтобы создать пользовательские где name

Узнайте больше о том, где названия Nest термостатов , гнездо защищает и гнездо Cams .

where_name

Когда вы выбираете разрешение на where_name devices/cameras чтение камеры , вы можете получить доступ к устройству where_name от устройства объекта ( devices/cameras ).

Особенности камеры

Видеопоток

Прямая трансляция

Используйте эти URL-адреса для доступа к странице прямой трансляции из Интернета или в приложении:

Включение / выключение потоковой передачи

Используйте is_streaming поле для включения или выключения камеры.

  • В зависимости от домашней сети пользователя и вашей реализации может возникнуть задержка во времени ответа.
  • Вы должны спросить у пользователя разрешение на изменение статуса потоковой передачи (включение / выключение камеры).

Последнее мероприятие

last_event объект используется , чтобы получить глубокие ссылки на последний обнаруженный звук, движение, или лицо, событие и доступ взаимосвязанного изображения или GIF файлы.

Типичные случаи использования для last_event/has_person полей являются триггерными огнями, или установить белье в тихом цикл.

Безопасность

Использование last_event объекта и структуры в away состояние, в структуре wwn_security_state значение может возрастать от ok , чтобы deter , которые могут вызвать другие устройства. Смотрите Руководство по безопасности для функций сдерживания.

Используется для отображения последнего записанного события и требует, чтобы пользователь вошел в учетную запись.

Файлы изображений или GIF

Кот в корзине

Для того , чтобы ваш продукт последнего доступа к URL - событий, пользователь должен иметь активную Nest Aware подписку, и вы должны выбрать один из камеры «+ изображений» разрешения для клиента.

Когда вы делаете вызов для 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, из которого можно получить снимок с таким разрешением, и создается изображение более низкого качества. Кроме того, низкая пропускная способность локальной сети может привести к тому, что разрешение снимка API упадет ниже 1080p при наличии Nest Aware.

Подробнее о требованиях к пропускной способности для Nest камер .

Пределы частоты снимков

Когда вы делаете вызов , чтобы получить snapshot_url , мы применяем эти ограничения скорости:

  • 2 в минуту для камер без подписки Nest Aware
  • 10 в минуту для камер с подпиской Nest Aware

Зоны активности

Для того , чтобы ваш продукт доступ активности зона информации, пользователь должен иметь активный Nest 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" ]

Общедоступный URL-адрес

Используйте эти два поля вместе, чтобы проверить, сделал ли пользователь общедоступный видеопоток, и если да, то получить доступ к этому URL-адресу.

  • is_public_share_enabled -boolean, возвращается true , если видеопоток является публичным, false , если частное
  • public_share_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 вызова и как обращаться с ними, увидеть сообщения об ошибках .