Coverage for custom_components/supernotify/transports/media_player.py: 100%

1from __future__ import annotations 

2 

3import logging 

4import urllib.parse 

5from typing import TYPE_CHECKING, Any, ClassVar 

6 

7from homeassistant.const import ( 

8 ATTR_ENTITY_ID, 

9) 

10from homeassistant.helpers.typing import ConfigType 

11 

12from custom_components.supernotify.const import ( 

13 ATTR_MEDIA, 

14 ATTR_MEDIA_SNAPSHOT_URL, 

15 RE_MEDIA_PLAYER_ENTITY_ID, 

16 TRANSPORT_MEDIA, 

17) 

18from custom_components.supernotify.model import DebugTrace, TransportConfig, TransportFeature 

19from custom_components.supernotify.options import MEDIA_OPTIONS, OPTION_TARGET_SELECT, DeliveryOption 

20from custom_components.supernotify.target import TargetEntityCategory 

21from custom_components.supernotify.transport import Transport 

22 

23if TYPE_CHECKING: 

24 from custom_components.supernotify.envelope import Envelope 

25 from custom_components.supernotify.hass_api import HomeAssistantAPI 

26 

27_LOGGER = logging.getLogger(__name__) 

28 

29 

30class MediaPlayerTransport(Transport): 

31 name = TRANSPORT_MEDIA 

32 declared_options: ClassVar[list[DeliveryOption]] = [*MEDIA_OPTIONS] 

33 

34 def __init__(self, *args: Any, **kwargs: Any) -> None: 

35 super().__init__(*args, **kwargs) 

36 

37 @property 

38 def supported_features(self) -> TransportFeature: 

39 return TransportFeature.IMAGES | TransportFeature.VIDEO | TransportFeature.SOUND | TransportFeature.SNAPSHOT_IMAGE 

40 

41 @property 

42 def default_config(self) -> TransportConfig: 

43 config = TransportConfig() 

44 config.delivery_defaults.action = "media_player.play_media" 

45 config.delivery_defaults.options = { 

46 OPTION_TARGET_SELECT: [RE_MEDIA_PLAYER_ENTITY_ID], 

47 } 

48 config.delivery_defaults.inclusion = self.inclusion_mode 

49 return config 

50 

51 @property 

52 def target_categories(self) -> list[str | TargetEntityCategory]: 

53 return [TargetEntityCategory(domain="media_player")] 

54 

55 def is_viable(self, hass_api: HomeAssistantAPI) -> bool: 

56 return bool(hass_api.entity_ids_for_domain("media_player")) 

57 

58 def build_standard_deliveries(self, hass_api: HomeAssistantAPI) -> dict[str, ConfigType]: 

59 return {self.name: {}} 

60 

61 async def _resolve_snapshot_url(self, envelope: Envelope, data: dict[str, Any]) -> str | None: 

62 """Resolve a snapshot URL for the media player to play. 

63 

64 Order of resolution: 

65 1. An explicit snapshot_url in the media block (absolutised), unprocessed. 

66 2. envelope.grab_image() - respects delivery-specific `jpeg_opts`/`png_opts`/ 

67 `reprocess` options - converted to a shareable URL via media_storage.object_url(). 

68 3. None (caller skips the delivery). 

69 """ 

70 snapshot_url = data.get(ATTR_MEDIA, {}).get(ATTR_MEDIA_SNAPSHOT_URL) 

71 if snapshot_url is None: 

72 # fallback to older idiosyncratic way for backward compatibility 

73 snapshot_url = data.get(ATTR_MEDIA_SNAPSHOT_URL) 

74 if snapshot_url is not None: 

75 # absolutize relative URL for external URl, probably preferred by Alexa Show etc 

76 return urllib.parse.urljoin(self.hass_api.external_url, snapshot_url) 

77 

78 image_path = await envelope.grab_image() 

79 if image_path is None: 

80 return None 

81 return await self.context.media_storage.object_url(image_path) 

82 

83 async def deliver(self, envelope: Envelope, debug_trace: DebugTrace | None = None) -> bool: 

84 _LOGGER.debug("SUPERNOTIFY notify_media: %s", envelope.data) 

85 

86 data: dict[str, Any] = envelope.data or {} 

87 media_players: list[str] = envelope.target.entity_ids or [] 

88 if not media_players: 

89 _LOGGER.debug("SUPERNOTIFY Skipping media show, no targets") 

90 return False 

91 

92 content_id: str | None 

93 media_type: str 

94 explicit_content_id: str | None = data.get("media_content_id") 

95 if explicit_content_id: 

96 # Generic content (audio clip, video, stream, media-source:// id) - passed through 

97 # as-is, apart from relative URLs like /local/sounds/bell.mp3 which are absolutised 

98 # so remote players (Cast, Sonos etc) can fetch them. Defaults to `music` since 

99 # that is what most media players expect for an audio file. 

100 content_id = urllib.parse.urljoin(self.hass_api.external_url, explicit_content_id) 

101 media_type = data.get("media_content_type", "music") 

102 else: 

103 content_id = await self._resolve_snapshot_url(envelope, data) 

104 media_type = data.get("media_content_type", "image") 

105 if content_id is None: 

106 _LOGGER.debug("SUPERNOTIFY Skipping media player, no media_content_id or snapshot url") 

107 return False 

108 

109 action_data: dict[str, Any] = {"media": {"media_content_id": content_id, "media_content_type": media_type}} 

110 if data and data.get("announce"): 

111 action_data["announce"] = data.get("announce") 

112 if data and data.get("enqueue"): 

113 action_data["enqueue"] = data.get("enqueue") 

114 

115 return await self.call_action(envelope, action_data=action_data, target_data={ATTR_ENTITY_ID: media_players})