camera.py

Go to the documentation of this file.

"""Support for Ubiquiti's UniFi Protect NVR."""
 
from __future__ import annotations
 
from collections.abc import Generator
import logging
 
from uiprotect.data import (
    Camera as UFPCamera,
    CameraChannel,
    ProtectAdoptableDeviceModel,
    StateType,
)
 
from homeassistant.components.camera import Camera, CameraEntityFeature
from homeassistant.core import HomeAssistant, callback
from homeassistant.helpers import issue_registry as ir
from homeassistant.helpers.dispatcher import async_dispatcher_connect
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.helpers.issue_registry import IssueSeverity
 
from .const import (
    ATTR_BITRATE,
    ATTR_CHANNEL_ID,
    ATTR_FPS,
    ATTR_HEIGHT,
    ATTR_WIDTH,
    DOMAIN,
)
from .data import ProtectData, ProtectDeviceType, UFPConfigEntry
from .entity import ProtectDeviceEntity
from .utils import get_camera_base_name
 
_LOGGER = logging.getLogger(__name__)
 
 
@callback
def _create_rtsp_repair(
    hass: HomeAssistant, entry: UFPConfigEntry, data: ProtectData, camera: UFPCamera
) -> None:
    edit_key = "readonly"
    if camera.can_write(data.api.bootstrap.auth_user):
        edit_key = "writable"
 
    translation_key = f"rtsp_disabled_{edit_key}"
    issue_key = f"rtsp_disabled_{camera.id}"
 
    ir.async_create_issue(
        hass,
        DOMAIN,
        issue_key,
        is_fixable=True,
        is_persistent=False,
        learn_more_url="https://www.home-assistant.io/integrations/unifiprotect/#camera-streams",
        severity=IssueSeverity.WARNING,
        translation_key=translation_key,
        translation_placeholders={"camera": camera.display_name},
        data={"entry_id": entry.entry_id, "camera_id": camera.id},
    )
 
 
@callback
def _get_camera_channels(
    hass: HomeAssistant,
    entry: UFPConfigEntry,
    data: ProtectData,
    ufp_device: UFPCamera | None = None,
) -> Generator[tuple[UFPCamera, CameraChannel, bool]]:
    """Get all the camera channels."""
 
    cameras = data.get_cameras() if ufp_device is None else [ufp_device]
    for camera in cameras:
        if not camera.channels:
            if ufp_device is None:
                # only warn on startup
                _LOGGER.warning(
                    "Camera does not have any channels: %s (id: %s)",
                    camera.display_name,
                    camera.id,
                )
            data.async_add_pending_camera_id(camera.id)
            continue
 
        is_default = True
        for channel in camera.channels:
            if channel.is_package:
                yield camera, channel, True
            elif channel.is_rtsp_enabled:
                yield camera, channel, is_default
                is_default = False
 
        # no RTSP enabled use first channel with no stream
        if is_default and not camera.is_third_party_camera:
            _create_rtsp_repair(hass, entry, data, camera)
            yield camera, camera.channels[0], True
        else:
            ir.async_delete_issue(hass, DOMAIN, f"rtsp_disabled_{camera.id}")
 
 
def _async_camera_entities(
    hass: HomeAssistant,
    entry: UFPConfigEntry,
    data: ProtectData,
    ufp_device: UFPCamera | None = None,
) -> list[ProtectDeviceEntity]:
    disable_stream = data.disable_stream
    entities: list[ProtectDeviceEntity] = []
    for camera, channel, is_default in _get_camera_channels(
        hass, entry, data, ufp_device
    ):
        # do not enable streaming for package camera
        # 2 FPS causes a lot of buferring
        entities.append(
            ProtectCamera(
                data,
                camera,
                channel,
                is_default,
                True,
                disable_stream or channel.is_package,
            )
        )
 
        if channel.is_rtsp_enabled and not channel.is_package:
            entities.append(
                ProtectCamera(
                    data,
                    camera,
                    channel,
                    is_default,
                    False,
                    disable_stream,
                )
            )
    return entities
 
 
async def async_setup_entry(
    hass: HomeAssistant,
    entry: UFPConfigEntry,
    async_add_entities: AddEntitiesCallback,
) -> None:
    """Discover cameras on a UniFi Protect NVR."""
    data = entry.runtime_data
 
    @callback
    def _add_new_device(device: ProtectAdoptableDeviceModel) -> None:
        if not isinstance(device, UFPCamera):
            return
        async_add_entities(_async_camera_entities(hass, entry, data, ufp_device=device))
 
    data.async_subscribe_adopt(_add_new_device)
    entry.async_on_unload(
        async_dispatcher_connect(hass, data.channels_signal, _add_new_device)
    )
    async_add_entities(_async_camera_entities(hass, entry, data))
 
 
_DISABLE_FEATURE = CameraEntityFeature(0)
_ENABLE_FEATURE = CameraEntityFeature.STREAM
 
 
class ProtectCamera(ProtectDeviceEntity, Camera):
    """A Ubiquiti UniFi Protect Camera."""
 
    device: UFPCamera
    _state_attrs = (
        "_attr_available",
        "_attr_is_recording",
        "_attr_motion_detection_enabled",
    )
 
    def __init__(
        self,
        data: ProtectData,
        camera: UFPCamera,
        channel: CameraChannel,
        is_default: bool,
        secure: bool,
        disable_stream: bool,
    ) -> None:
        """Initialize an UniFi camera."""
        self.channelchannel = channel
        self._secure_secure = secure
        self._disable_stream_disable_stream = disable_stream
        self._last_image_last_image: bytes | None = None
        super().__init__(data, camera)
        device = self.devicedevice
 
        camera_name = get_camera_base_name(channel)
        if self._secure_secure:
            self._attr_unique_id_attr_unique_id_attr_unique_id = f"{device.mac}_{channel.id}"
            self._attr_name_attr_name_attr_name = camera_name
        else:
            self._attr_unique_id_attr_unique_id_attr_unique_id = f"{device.mac}_{channel.id}_insecure"
            self._attr_name_attr_name_attr_name = f"{camera_name} (insecure)"
        # only the default (first) channel is enabled by default
        self._attr_entity_registry_enabled_default_attr_entity_registry_enabled_default = is_default and secure
        # Set the stream source before finishing the init
        # because async_added_to_hass is too late and camera
        # integration uses async_internal_added_to_hass to access
        # the stream source which is called before async_added_to_hass
        self._async_set_stream_source_async_set_stream_source()
 
    @callback
    def _async_set_stream_source(self) -> None:
        channel = self.channelchannel
        enable_stream = not self._disable_stream_disable_stream and channel.is_rtsp_enabled
        # SRTP disabled because go2rtc does not support it
        # https://github.com/AlexxIT/go2rtc/#source-rtsp
        rtsp_url = channel.rtsps_no_srtp_url if self._secure_secure else channel.rtsp_url
        source = rtsp_url if enable_stream else None
        self._attr_supported_features_attr_supported_features = _ENABLE_FEATURE if source else _DISABLE_FEATURE
        self._stream_source_stream_source = source
 
    @callback
    def _async_update_device_from_protect(self, device: ProtectDeviceType) -> None:
        super()._async_update_device_from_protect(device)
        updated_device = self.devicedevice
        channel = updated_device.channels[self.channelchannel.id]
        self.channelchannel = channel
        motion_enabled = updated_device.recording_settings.enable_motion_detection
        self._attr_motion_detection_enabled_attr_motion_detection_enabled = (
            motion_enabled if motion_enabled is not None else True
        )
        state_type_is_connected = updated_device.state is StateType.CONNECTED
        self._attr_is_recording_attr_is_recording = (
            state_type_is_connected and updated_device.is_recording
        )
        is_connected = self.datadata.last_update_success and state_type_is_connected
        # some cameras have detachable lens that could cause the camera to be offline
        self._attr_available_attr_available_attr_available = is_connected and updated_device.is_video_ready
 
        self._async_set_stream_source_async_set_stream_source()
        self._attr_extra_state_attributes_attr_extra_state_attributes = {
            ATTR_WIDTH: channel.width,
            ATTR_HEIGHT: channel.height,
            ATTR_FPS: channel.fps,
            ATTR_BITRATE: channel.bitrate,
            ATTR_CHANNEL_ID: channel.id,
        }
 
    async def async_camera_image(
        self, width: int | None = None, height: int | None = None
    ) -> bytes | None:
        """Return the Camera Image."""
        if self.channelchannel.is_package:
            last_image = await self.devicedevice.get_package_snapshot(width, height)
        else:
            last_image = await self.devicedevice.get_snapshot(width, height)
        self._last_image_last_image = last_image
        return self._last_image_last_image
 
    async def stream_source(self) -> str | None:
        """Return the Stream Source."""
        return self._stream_source_stream_source
 
    async def async_enable_motion_detection(self) -> None:
        """Call the job and enable motion detection."""
        await self.devicedevice.set_motion_detection(True)
 
    async def async_disable_motion_detection(self) -> None:
        """Call the job and disable motion detection."""
        await self.devicedevice.set_motion_detection(False)