camera.py

Go to the documentation of this file.

"""Support for Canary camera."""
 
from __future__ import annotations
 
from datetime import timedelta
import logging
from typing import Final
 
from aiohttp.web import Request, StreamResponse
from canary.live_stream_api import LiveStreamSession
from canary.model import Device, Location
from haffmpeg.camera import CameraMjpeg
import voluptuous as vol
 
from homeassistant.components import ffmpeg
from homeassistant.components.camera import (
    PLATFORM_SCHEMA as CAMERA_PLATFORM_SCHEMA,
    Camera,
)
from homeassistant.components.ffmpeg import FFmpegManager, get_ffmpeg_manager
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.device_registry import DeviceInfo
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.helpers.update_coordinator import CoordinatorEntity
from homeassistant.util import dt as dt_util
 
from .const import (
    CONF_FFMPEG_ARGUMENTS,
    DATA_COORDINATOR,
    DEFAULT_FFMPEG_ARGUMENTS,
    DOMAIN,
    MANUFACTURER,
)
from .coordinator import CanaryDataUpdateCoordinator
 
FORCE_CAMERA_REFRESH_INTERVAL: Final = timedelta(minutes=15)
 
PLATFORM_SCHEMA: Final = vol.All(
    cv.deprecated(CONF_FFMPEG_ARGUMENTS),
    CAMERA_PLATFORM_SCHEMA.extend(
        {
            vol.Optional(
                CONF_FFMPEG_ARGUMENTS, default=DEFAULT_FFMPEG_ARGUMENTS
            ): cv.string
        }
    ),
)
 
_LOGGER = logging.getLogger(__name__)
 
 
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
    )
 
    async_add_entities(
        (
            CanaryCamera(
                hass,
                coordinator,
                location_id,
                device,
                ffmpeg_arguments,
            )
            for location_id, location in coordinator.data["locations"].items()
            for device in location.devices
            if device.is_online
        ),
        True,
    )
 
 
class CanaryCamera(CoordinatorEntity[CanaryDataUpdateCoordinator], Camera):
    """An implementation of a Canary security camera."""
 
    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 = get_ffmpeg_manager(hass)
        self._ffmpeg_arguments_ffmpeg_arguments = ffmpeg_args
        self._location_id_location_id = location_id
        self._device_device = device
        self._live_stream_session_live_stream_session: LiveStreamSession | None = None
        self._attr_name_attr_name = device.name
        self._attr_unique_id_attr_unique_id = str(device.device_id)
        self._attr_device_info_attr_device_info = DeviceInfo(
            identifiers={(DOMAIN, str(device.device_id))},
            manufacturer=MANUFACTURER,
            model=device.device_type["name"],
            name=device.name,
        )
        self._image_image: bytes | None = None
        self._expires_at_expires_at = dt_util.utcnow()
        _LOGGER.debug(
            "%s %s has been initialized", self.namenamename, device.device_type["name"]
        )
 
    @property
    def location(self) -> Location:
        """Return information about the location."""
        return self.coordinator.data["locations"][self._location_id_location_id]
 
    @property
    def is_recording(self) -> bool:
        """Return true if the device is recording."""
        return self.locationlocation.is_recording  # type: ignore[no-any-return]
 
    @property
    def motion_detection_enabled(self) -> bool:
        """Return the camera motion detection status."""
        return not self.locationlocation.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."""
        utcnow = dt_util.utcnow()
        if self._expires_at_expires_at <= utcnow:
            _LOGGER.debug("Grabbing a live view image from %s", self.namenamename)
            await self.hasshasshass.async_add_executor_job(self.renew_live_stream_sessionrenew_live_stream_session)
 
            if (live_stream_session := self._live_stream_session_live_stream_session) is None:
                return None
 
            if not (live_stream_url := live_stream_session.live_stream_url):
                return None
 
            image = await ffmpeg.async_get_image(
                self.hasshasshass,
                live_stream_url,
                extra_cmd=self._ffmpeg_arguments_ffmpeg_arguments,
                width=width,
                height=height,
            )
 
            if image:
                self._image_image = image
                self._expires_at_expires_at = FORCE_CAMERA_REFRESH_INTERVAL + utcnow
                _LOGGER.debug("Grabbed a live view image from %s", self.namenamename)
            await self.hasshasshass.async_add_executor_job(live_stream_session.stop_session)
            _LOGGER.debug("Stopped live session from %s", self.namenamename)
 
        return self._image_image
 
    async def handle_async_mjpeg_stream(
        self, request: Request
    ) -> StreamResponse | None:
        """Generate an HTTP MJPEG stream from the camera."""
        if self._live_stream_session_live_stream_session is None:
            return None
 
        live_stream_url = await self.hasshasshass.async_add_executor_job(
            getattr, self._live_stream_session_live_stream_session, "live_stream_url"
        )
        stream = CameraMjpeg(self._ffmpeg.binary)
        await stream.open_camera(live_stream_url, extra_cmd=self._ffmpeg_arguments_ffmpeg_arguments)
 
        try:
            stream_reader = await stream.get_reader()
            return await async_aiohttp_proxy_stream(
                self.hasshasshass,
                request,
                stream_reader,
                self._ffmpeg.ffmpeg_stream_content_type,
            )
        finally:
            await stream.close()
 
    def renew_live_stream_session(self) -> None:
        """Renew live stream session."""
        self._live_stream_session_live_stream_session = self.coordinator.canary.get_live_stream_session(
            self._device_device
        )
 
        _LOGGER.debug(
            "Live Stream URL for %s is %s",
            self.namenamename,
            self._live_stream_session_live_stream_session.live_stream_url,
        )