"""Support for Canary camera.""" from __future__ import annotations from datetime import timedelta from typing import Final from aiohttp.web import Request, StreamResponse from canary.api import Device, Location from canary.live_stream_api import LiveStreamSession from haffmpeg.camera import CameraMjpeg import voluptuous as vol from homeassistant.components import ffmpeg from homeassistant.components.camera import ( PLATFORM_SCHEMA as PARENT_PLATFORM_SCHEMA, Camera, ) from homeassistant.components.ffmpeg import DATA_FFMPEG, FFmpegManager from homeassistant.config_entries import ConfigEntry from homeassistant.core import HomeAssistant from homeassistant.helpers import config_validation as cv from homeassistant.helpers.aiohttp_client import async_aiohttp_proxy_stream from homeassistant.helpers.entity import DeviceInfo from homeassistant.helpers.entity_platform import AddEntitiesCallback from homeassistant.helpers.update_coordinator import CoordinatorEntity from homeassistant.util import Throttle from .const import ( CONF_FFMPEG_ARGUMENTS, DATA_COORDINATOR, DEFAULT_FFMPEG_ARGUMENTS, DOMAIN, MANUFACTURER, ) from .coordinator import CanaryDataUpdateCoordinator MIN_TIME_BETWEEN_SESSION_RENEW: Final = timedelta(seconds=90) PLATFORM_SCHEMA: Final = vol.All( cv.deprecated(CONF_FFMPEG_ARGUMENTS), PARENT_PLATFORM_SCHEMA.extend( { vol.Optional( CONF_FFMPEG_ARGUMENTS, default=DEFAULT_FFMPEG_ARGUMENTS ): cv.string } ), ) async def async_setup_entry( hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback, ) -> None: """Set up Canary sensors based on a config entry.""" coordinator: CanaryDataUpdateCoordinator = hass.data[DOMAIN][entry.entry_id][ DATA_COORDINATOR ] ffmpeg_arguments: str = entry.options.get( CONF_FFMPEG_ARGUMENTS, DEFAULT_FFMPEG_ARGUMENTS ) cameras: list[CanaryCamera] = [] for location_id, location in coordinator.data["locations"].items(): for device in location.devices: if device.is_online: cameras.append( CanaryCamera( hass, coordinator, location_id, device, ffmpeg_arguments, ) ) async_add_entities(cameras, True) class CanaryCamera(CoordinatorEntity, Camera): """An implementation of a Canary security camera.""" coordinator: CanaryDataUpdateCoordinator def __init__( self, hass: HomeAssistant, coordinator: CanaryDataUpdateCoordinator, location_id: str, device: Device, ffmpeg_args: str, ) -> None: """Initialize a Canary security camera.""" super().__init__(coordinator) Camera.__init__(self) self._ffmpeg: FFmpegManager = hass.data[DATA_FFMPEG] self._ffmpeg_arguments = ffmpeg_args self._location_id = location_id self._device = device self._live_stream_session: LiveStreamSession | None = None self._attr_name = device.name self._attr_unique_id = str(device.device_id) self._attr_device_info = DeviceInfo( identifiers={(DOMAIN, str(device.device_id))}, manufacturer=MANUFACTURER, model=device.device_type["name"], name=device.name, ) @property def location(self) -> Location: """Return information about the location.""" return self.coordinator.data["locations"][self._location_id] @property def is_recording(self) -> bool: """Return true if the device is recording.""" return self.location.is_recording # type: ignore[no-any-return] @property def motion_detection_enabled(self) -> bool: """Return the camera motion detection status.""" return not self.location.is_recording async def async_camera_image( self, width: int | None = None, height: int | None = None ) -> bytes | None: """Return a still image response from the camera.""" await self.hass.async_add_executor_job(self.renew_live_stream_session) live_stream_url = await self.hass.async_add_executor_job( getattr, self._live_stream_session, "live_stream_url" ) return await ffmpeg.async_get_image( self.hass, live_stream_url, extra_cmd=self._ffmpeg_arguments, width=width, height=height, ) async def handle_async_mjpeg_stream( self, request: Request ) -> StreamResponse | None: """Generate an HTTP MJPEG stream from the camera.""" if self._live_stream_session is None: return None stream = CameraMjpeg(self._ffmpeg.binary) await stream.open_camera( self._live_stream_session.live_stream_url, extra_cmd=self._ffmpeg_arguments ) try: stream_reader = await stream.get_reader() return await async_aiohttp_proxy_stream( self.hass, request, stream_reader, self._ffmpeg.ffmpeg_stream_content_type, ) finally: await stream.close() @Throttle(MIN_TIME_BETWEEN_SESSION_RENEW) def renew_live_stream_session(self) -> None: """Renew live stream session.""" self._live_stream_session = self.coordinator.canary.get_live_stream_session( self._device )