mirror of
https://github.com/home-assistant/core.git
synced 2026-08-14 09:13:06 +01:00
125 lines
4.0 KiB
Python
125 lines
4.0 KiB
Python
"""Support for Imou camera entities."""
|
|
|
|
from dataclasses import dataclass
|
|
from typing import override
|
|
|
|
from pyimouapi.const import PARAM_HD, PARAM_MOTION_DETECT, PARAM_STATE
|
|
from pyimouapi.exceptions import ImouException
|
|
from pyimouapi.ha_device import ImouHaDevice
|
|
|
|
from homeassistant.components.camera import (
|
|
Camera,
|
|
CameraEntityDescription,
|
|
CameraEntityFeature,
|
|
)
|
|
from homeassistant.core import HomeAssistant
|
|
from homeassistant.exceptions import HomeAssistantError
|
|
from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback
|
|
|
|
from .const import PARAM_HEADER_DETECT, imou_device_identifier
|
|
from .coordinator import ImouConfigEntry, ImouDataUpdateCoordinator
|
|
from .entity import ImouEntity
|
|
|
|
PARALLEL_UPDATES = 0
|
|
|
|
CAMERA_STREAM_RESOLUTION_SD = "SD"
|
|
|
|
# Defaults for pyimouapi ImouHaDeviceManager APIs (async_get_device_stream / async_get_device_image).
|
|
PYIMOUAPI_LIVE_PROTOCOL = "https"
|
|
PYIMOUAPI_SNAPSHOT_WAIT_SECONDS = 3
|
|
|
|
|
|
@dataclass(frozen=True, kw_only=True)
|
|
class ImouCameraEntityDescription(CameraEntityDescription):
|
|
"""Describes an Imou camera entity."""
|
|
|
|
resolution: str
|
|
|
|
|
|
CAMERA_TYPES: tuple[ImouCameraEntityDescription, ...] = (
|
|
ImouCameraEntityDescription(
|
|
key="camera_sd",
|
|
translation_key="camera_sd",
|
|
resolution=CAMERA_STREAM_RESOLUTION_SD,
|
|
),
|
|
ImouCameraEntityDescription(
|
|
key="camera_hd",
|
|
translation_key="camera_hd",
|
|
resolution=PARAM_HD,
|
|
),
|
|
)
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant,
|
|
entry: ImouConfigEntry,
|
|
async_add_entities: AddConfigEntryEntitiesCallback,
|
|
) -> None:
|
|
"""Set up Imou camera entities."""
|
|
coordinator = entry.runtime_data
|
|
|
|
def _add_cameras(new_devices: list[ImouHaDevice]) -> None:
|
|
device_keys = {imou_device_identifier(device) for device in new_devices}
|
|
async_add_entities(
|
|
ImouCamera(coordinator, description, device)
|
|
for device in coordinator.devices
|
|
if device.channel_id is not None
|
|
if imou_device_identifier(device) in device_keys
|
|
for description in CAMERA_TYPES
|
|
)
|
|
|
|
entry.async_on_unload(coordinator.register_new_device_callback(_add_cameras))
|
|
_add_cameras(coordinator.devices)
|
|
|
|
|
|
class ImouCamera(ImouEntity, Camera):
|
|
"""Representation of an Imou camera stream."""
|
|
|
|
entity_description: ImouCameraEntityDescription
|
|
_attr_supported_features = CameraEntityFeature.STREAM
|
|
|
|
def __init__(
|
|
self,
|
|
coordinator: ImouDataUpdateCoordinator,
|
|
description: ImouCameraEntityDescription,
|
|
device: ImouHaDevice,
|
|
) -> None:
|
|
"""Initialize the camera entity."""
|
|
Camera.__init__(self)
|
|
super().__init__(coordinator, description, device)
|
|
|
|
@override
|
|
async def stream_source(self) -> str | None:
|
|
"""Return the live stream URL from the Imou cloud."""
|
|
try:
|
|
return await self.coordinator.device_manager.async_get_device_stream(
|
|
self.device,
|
|
self.entity_description.resolution,
|
|
PYIMOUAPI_LIVE_PROTOCOL,
|
|
)
|
|
except ImouException as err:
|
|
raise HomeAssistantError(str(err)) from err
|
|
|
|
@override
|
|
async def async_camera_image(
|
|
self, width: int | None = None, height: int | None = None
|
|
) -> bytes | None:
|
|
"""Return bytes of camera image."""
|
|
try:
|
|
return await self.coordinator.device_manager.async_get_device_image(
|
|
self.device,
|
|
PYIMOUAPI_SNAPSHOT_WAIT_SECONDS,
|
|
)
|
|
except ImouException as err:
|
|
raise HomeAssistantError(str(err)) from err
|
|
|
|
@property
|
|
@override
|
|
def motion_detection_enabled(self) -> bool:
|
|
"""Return True when human and/or motion detection switch is on."""
|
|
header = self.device.switches.get(PARAM_HEADER_DETECT)
|
|
motion = self.device.switches.get(PARAM_MOTION_DETECT)
|
|
header_on = bool(header[PARAM_STATE]) if header else False
|
|
motion_on = bool(motion[PARAM_STATE]) if motion else False
|
|
return header_on or motion_on
|