Add Room Audio Control to Control4 Integration (home-assistant#87821)

* Add control4 room based media player (#13)

* update attribute names (#14)

* change to data class and set off to idle (#15)

Co-authored-by: nalin29 <nalin29@github.com>

---------

Co-authored-by: nalin29 <nalin29@github.com>

.coveragerc

@@ -202,6 +202,7 @@ omit =
     homeassistant/components/control4/__init__.py
     homeassistant/components/control4/director_utils.py
     homeassistant/components/control4/light.py
+    homeassistant/components/control4/media_player.py
     homeassistant/components/coolmaster/coordinator.py
     homeassistant/components/cppm_tracker/device_tracker.py
     homeassistant/components/crownstone/__init__.py

homeassistant/components/control4/__init__.py

@@ -4,6 +4,7 @@
 
 import json
 import logging
+from typing import Any
 
 from aiohttp import client_exceptions
 from pyControl4.account import C4Account
@@ -36,13 +37,14 @@
     CONF_DIRECTOR_ALL_ITEMS,
     CONF_DIRECTOR_MODEL,
     CONF_DIRECTOR_SW_VERSION,
+    CONF_UI_CONFIGURATION,
     DEFAULT_SCAN_INTERVAL,
     DOMAIN,
 )
 
 _LOGGER = logging.getLogger(__name__)
 
-PLATFORMS = [Platform.LIGHT]
+PLATFORMS = [Platform.LIGHT, Platform.MEDIA_PLAYER]
 
 
 async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
@@ -105,6 +107,8 @@ async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
     director_all_items = json.loads(director_all_items)
     entry_data[CONF_DIRECTOR_ALL_ITEMS] = director_all_items
 
+    entry_data[CONF_UI_CONFIGURATION] = json.loads(await director.getUiConfiguration())
+
     # Load options from config entry
     entry_data[CONF_SCAN_INTERVAL] = entry.options.get(
         CONF_SCAN_INTERVAL, DEFAULT_SCAN_INTERVAL
@@ -145,14 +149,14 @@ async def get_items_of_category(hass: HomeAssistant, entry: ConfigEntry, categor
     ]
 
 
-class Control4Entity(CoordinatorEntity):
+class Control4Entity(CoordinatorEntity[Any]):
     """Base entity for Control4."""
 
     def __init__(
         self,
         entry_data: dict,
-        coordinator: DataUpdateCoordinator,
-        name: str,
+        coordinator: DataUpdateCoordinator[Any],
+        name: str | None,
         idx: int,
         device_name: str | None,
         device_manufacturer: str | None,

homeassistant/components/control4/const.py

@@ -10,6 +10,7 @@
 CONF_DIRECTOR_SW_VERSION = "director_sw_version"
 CONF_DIRECTOR_MODEL = "director_model"
 CONF_DIRECTOR_ALL_ITEMS = "director_all_items"
+CONF_UI_CONFIGURATION = "ui_configuration"
 CONF_CONTROLLER_UNIQUE_ID = "controller_unique_id"
 
 CONF_CONFIG_LISTENER = "config_listener"

homeassistant/components/control4/light.py

@@ -45,7 +45,7 @@ async def async_setup_entry(
         scan_interval,
     )
 
-    async def async_update_data_non_dimmer():
+    async def async_update_data_non_dimmer() -> dict[int, dict[str, Any]]:
         """Fetch data from Control4 director for non-dimmer lights."""
         try:
             return await update_variables_for_config_entry(
@@ -54,7 +54,7 @@ async def async_update_data_non_dimmer():
         except C4Exception as err:
             raise UpdateFailed(f"Error communicating with API: {err}") from err
 
-    async def async_update_data_dimmer():
+    async def async_update_data_dimmer() -> dict[int, dict[str, Any]]:
         """Fetch data from Control4 director for dimmer lights."""
         try:
             return await update_variables_for_config_entry(
@@ -63,14 +63,14 @@ async def async_update_data_dimmer():
         except C4Exception as err:
             raise UpdateFailed(f"Error communicating with API: {err}") from err
 
-    non_dimmer_coordinator = DataUpdateCoordinator(
+    non_dimmer_coordinator = DataUpdateCoordinator[dict[int, dict[str, Any]]](
         hass,
         _LOGGER,
         name="light",
         update_method=async_update_data_non_dimmer,
         update_interval=timedelta(seconds=scan_interval),
     )
-    dimmer_coordinator = DataUpdateCoordinator(
+    dimmer_coordinator = DataUpdateCoordinator[dict[int, dict[str, Any]]](
         hass,
         _LOGGER,
         name="light",
@@ -149,10 +149,12 @@ async def async_update_data_dimmer():
 class Control4Light(Control4Entity, LightEntity):
     """Control4 light entity."""
 
+    _attr_has_entity_name = True
+
     def __init__(
         self,
         entry_data: dict,
-        coordinator: DataUpdateCoordinator,
+        coordinator: DataUpdateCoordinator[dict[int, dict[str, Any]]],
         name: str,
         idx: int,
         device_name: str | None,