mirror of
https://github.com/home-assistant/core.git
synced 2026-05-29 11:45:35 +01:00
Manu
124 lines
3.6 KiB
Python
124 lines
3.6 KiB
Python
"""Image platform for the Xbox integration."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from collections.abc import Callable
|
|
from dataclasses import dataclass
|
|
from enum import StrEnum
|
|
|
|
from pythonxbox.api.provider.people.models import Person
|
|
from pythonxbox.api.provider.titlehub.models import Title
|
|
|
|
from homeassistant.components.image import ImageEntity, ImageEntityDescription
|
|
from homeassistant.core import HomeAssistant, callback
|
|
from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback
|
|
from homeassistant.util import dt as dt_util
|
|
|
|
from .coordinator import XboxConfigEntry, XboxUpdateCoordinator
|
|
from .entity import XboxBaseEntity, XboxBaseEntityDescription, profile_pic
|
|
|
|
PARALLEL_UPDATES = 0
|
|
|
|
|
|
class XboxImage(StrEnum):
|
|
"""Xbox image."""
|
|
|
|
NOW_PLAYING = "now_playing"
|
|
GAMERPIC = "gamerpic"
|
|
AVATAR = "avatar"
|
|
|
|
|
|
@dataclass(kw_only=True, frozen=True)
|
|
class XboxImageEntityDescription(XboxBaseEntityDescription, ImageEntityDescription):
|
|
"""Xbox image description."""
|
|
|
|
image_url_fn: Callable[[Person, Title | None], str | None]
|
|
|
|
|
|
IMAGE_DESCRIPTIONS: tuple[XboxImageEntityDescription, ...] = (
|
|
XboxImageEntityDescription(
|
|
key=XboxImage.GAMERPIC,
|
|
translation_key=XboxImage.GAMERPIC,
|
|
image_url_fn=profile_pic,
|
|
),
|
|
XboxImageEntityDescription(
|
|
key=XboxImage.NOW_PLAYING,
|
|
translation_key=XboxImage.NOW_PLAYING,
|
|
image_url_fn=lambda _, title: title.display_image if title else None,
|
|
),
|
|
XboxImageEntityDescription(
|
|
key=XboxImage.AVATAR,
|
|
translation_key=XboxImage.AVATAR,
|
|
image_url_fn=(
|
|
lambda person,
|
|
_: f"https://avatar-ssl.xboxlive.com/avatar/{person.gamertag}/avatar-body.png"
|
|
),
|
|
),
|
|
)
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant,
|
|
config_entry: XboxConfigEntry,
|
|
async_add_entities: AddConfigEntryEntitiesCallback,
|
|
) -> None:
|
|
"""Set up Xbox images."""
|
|
|
|
coordinator = config_entry.runtime_data.status
|
|
|
|
xuids_added: set[str] = set()
|
|
|
|
@callback
|
|
def add_entities() -> None:
|
|
"""Add image entities."""
|
|
nonlocal xuids_added
|
|
|
|
current_xuids = set(coordinator.data.presence)
|
|
if new_xuids := current_xuids - xuids_added:
|
|
async_add_entities(
|
|
[
|
|
XboxImageEntity(hass, coordinator, xuid, description)
|
|
for xuid in new_xuids
|
|
for description in IMAGE_DESCRIPTIONS
|
|
]
|
|
)
|
|
xuids_added |= new_xuids
|
|
xuids_added &= current_xuids
|
|
|
|
coordinator.async_add_listener(add_entities)
|
|
add_entities()
|
|
|
|
|
|
class XboxImageEntity(XboxBaseEntity, ImageEntity):
|
|
"""An image entity."""
|
|
|
|
entity_description: XboxImageEntityDescription
|
|
|
|
def __init__(
|
|
self,
|
|
hass: HomeAssistant,
|
|
coordinator: XboxUpdateCoordinator,
|
|
xuid: str,
|
|
entity_description: XboxImageEntityDescription,
|
|
) -> None:
|
|
"""Initialize the image entity."""
|
|
super().__init__(coordinator, xuid, entity_description)
|
|
ImageEntity.__init__(self, hass)
|
|
|
|
self._attr_image_url = self.entity_description.image_url_fn(
|
|
self.data, self.title_info
|
|
)
|
|
self._attr_image_last_updated = dt_util.utcnow()
|
|
|
|
def _handle_coordinator_update(self) -> None:
|
|
"""Handle updated data from the coordinator."""
|
|
|
|
url = self.entity_description.image_url_fn(self.data, self.title_info)
|
|
|
|
if url != self._attr_image_url:
|
|
self._attr_image_url = url
|
|
self._cached_image = None
|
|
self._attr_image_last_updated = dt_util.utcnow()
|
|
|
|
super()._handle_coordinator_update()
|