python-linkplay 0.2.2__tar.gz → 0.2.4__tar.gz

{python_linkplay-0.2.2/src/python_linkplay.egg-info → python_linkplay-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python_linkplay
-Version: 0.2.2
+Version: 0.2.4
 Summary: A Python Library for Seamless LinkPlay Device Control
 Author: Velleman Group nv
 License: MIT

python_linkplay-0.2.4/src/linkplay/__version__.py

@@ -0,0 +1 @@
+__version__ = '0.2.4'

{python_linkplay-0.2.2 → python_linkplay-0.2.4}/src/linkplay/bridge.py

@@ -1,18 +1,21 @@
 from __future__ import annotations
 
 import time
-from typing import Any
+from typing import Any, Callable
 
 from linkplay.consts import (
     INPUT_MODE_MAP,
     LOGGER,
     PLAY_MODE_SEND_MAP,
+    AudioOutputHwMode,
     ChannelType,
     DeviceAttribute,
     EqualizerMode,
     InputMode,
     LinkPlayCommand,
     LoopMode,
+    MetaInfo,
+    MetaInfoMetaData,
     MultiroomAttribute,
     MuteMode,
     PlayerAttribute,
@@ -36,6 +39,8 @@ class LinkPlayDevice:
     bridge: LinkPlayBridge
     properties: dict[DeviceAttribute, str]
 
+    controller: Callable[[], None] | None = None
+
     def __init__(self, bridge: LinkPlayBridge):
         self.bridge = bridge
         self.properties = dict.fromkeys(DeviceAttribute.__members__.values(), "")
@@ -44,6 +49,10 @@ class LinkPlayDevice:
         """Return the state of the LinkPlayDevice."""
         return {"properties": self.properties}
 
+    def set_callback(self, controller: Callable[[], None]) -> None:
+        """Sets a callback function to notify events."""
+        self.controller = controller
+
     async def update_status(self) -> None:
         """Update the device status."""
         self.properties = await self.bridge.json_request(LinkPlayCommand.DEVICE_STATUS)  # type: ignore[assignment]
@@ -122,11 +131,15 @@ class LinkPlayPlayer:
     bridge: LinkPlayBridge
     properties: dict[PlayerAttribute, str]
     custom_properties: dict[PlayerAttribute, str]
+    metainfo: dict[MetaInfo, dict[MetaInfoMetaData, str]]
+
+    previous_playing_mode: PlayingMode | None = None
 
     def __init__(self, bridge: LinkPlayBridge):
         self.bridge = bridge
         self.properties = dict.fromkeys(PlayerAttribute.__members__.values(), "")
         self.custom_properties = dict.fromkeys(PlayerAttribute.__members__.values(), "")
+        self.metainfo = dict.fromkeys(MetaInfo.__members__.values(), {})
 
     def to_dict(self):
         """Return the state of the LinkPlayPlayer."""
@@ -139,6 +152,26 @@ class LinkPlayPlayer:
         )  # type: ignore[assignment]
 
         self.properties = fixup_player_properties(properties)
+        if self.bridge.device.manufacturer == MANUFACTURER_WIIM:
+            self.metainfo: dict[
+                MetaInfo, dict[MetaInfoMetaData, str]
+            ] = await self.bridge.json_request(LinkPlayCommand.META_INFO)  # type: ignore[assignment]
+        else:
+            self.metainfo = {}
+
+        # handle multiroom changes
+        if self.bridge.device.controller is not None and (
+            (
+                self.previous_playing_mode != PlayingMode.FOLLOWER
+                and self.play_mode == PlayingMode.FOLLOWER
+            )
+            or (
+                self.previous_playing_mode == PlayingMode.FOLLOWER
+                and self.play_mode != PlayingMode.FOLLOWER
+            )
+        ):
+            self.bridge.device.controller()
+        self.previous_playing_mode = self.play_mode
 
     async def next(self) -> None:
         """Play the next song in the playlist."""
@@ -255,6 +288,14 @@ class LinkPlayPlayer:
         ):
             await self.bridge.request(LinkPlayCommand.SEEK.format(position))
 
+    async def set_audio_output_hw_mode(self, mode: AudioOutputHwMode) -> None:
+        """Set the audio hardware output."""
+        await self.bridge.request(LinkPlayCommand.AUDIO_OUTPUT_HW_MODE_SET.format(mode))
+
+    async def get_audio_output_hw_mode(self) -> None:
+        """Get the audio hardware output."""
+        await self.bridge.json_request(LinkPlayCommand.AUDIO_OUTPUT_HW_MODE)
+
     @property
     def muted(self) -> bool:
         """Returns if the player is muted."""
@@ -278,6 +319,13 @@ class LinkPlayPlayer:
         """Returns if the currently playing album."""
         return self.properties.get(PlayerAttribute.ALBUM, "")
 
+    @property
+    def album_art(self) -> str:
+        """Returns the url to the album art."""
+        return self.metainfo.get(MetaInfo.METADATA, {}).get(
+            MetaInfoMetaData.ALBUM_ART, ""
+        )
+
     @property
     def volume(self) -> int:
         """Returns the player volume, expressed in %."""

{python_linkplay-0.2.2 → python_linkplay-0.2.4}/src/linkplay/consts.py

@@ -100,6 +100,9 @@ class LinkPlayCommand(StrEnum):
     PLAY_PRESET = "MCUKeyShortClick:{}"
     TIMESYNC = "timeSync:{}"
     WIIM_EQ_LOAD = "EQLoad:{}"
+    META_INFO = "getMetaInfo"
+    AUDIO_OUTPUT_HW_MODE_SET = "setAudioOutputHardwareMode:{}"
+    AUDIO_OUTPUT_HW_MODE = "getNewAudioOutputHardwareMode"
 
 
 class LinkPlayTcpUartCommand(StrEnum):
@@ -470,3 +473,48 @@ class MultiroomAttribute(StrEnum):
 
     def __repr__(self):
         return self.value
+        
+
+class MetaInfo(StrEnum):
+
+    METADATA = "metaData"
+    
+    def __str__(self):
+        return self.value
+
+    def __repr__(self):
+        return self.value     
+        
+class MetaInfoMetaData(StrEnum):
+    """Defines the metadata within the metainfo."""
+
+    ALBUM_TITLE = "album"
+    TRACK_TITLE = "title"
+    TRACK_SUBTITLE = "subtitle"
+    ALBUM_ART = "albumArtURI"
+    SAMPLE_RATE = "sampleRate"
+    BIT_DEPTH = "bitDepth"
+    BIT_RATE = "bitRate"
+    TRACK_ID = "trackId"
+    
+    def __str__(self):
+        return self.value
+
+    def __repr__(self):
+        return self.value    
+    
+
+class AudioOutputHwMode(StrEnum):
+    """Defines a output mode for the hardware."""
+    OPTICAL = "1"
+    LINE_OUT = "2"
+    COAXIAL = "3"
+    HEADPHONES = "4"
+
+# Map between a play mode and how to activate the play mode
+AUDIO_OUTPUT_HW_MODE_MAP: dict[AudioOutputHwMode, str] = {  # case sensitive!
+    AudioOutputHwMode.OPTICAL: "optical",
+    AudioOutputHwMode.LINE_OUT: "line-out",
+    AudioOutputHwMode.COAXIAL: "co-axial",
+    AudioOutputHwMode.HEADPHONES: "headphones",
+}                                                       

{python_linkplay-0.2.2 → python_linkplay-0.2.4}/src/linkplay/controller.py

@@ -18,6 +18,16 @@ class LinkPlayController:
         self.bridges = []
         self.multirooms = []
 
+    def get_bridge_callback(self):
+        """Returns an async callback function for LinkPlayBridge."""
+
+        async def callback() -> None:
+            """Async callback function to handle events from a LinkPlayBridge."""
+            LOGGER.debug("Controller event received")
+            await self.discover_multirooms()
+
+        return callback
+
     async def discover_bridges(self) -> None:
         """Attempts to discover LinkPlay devices on the local network."""
 
@@ -46,6 +56,7 @@ class LinkPlayController:
         # Add bridge
         current_bridges = [bridge.device.uuid for bridge in self.bridges]
         if bridge_to_add.device.uuid not in current_bridges:
+            bridge_to_add.device.set_callback(self.get_bridge_callback())
             self.bridges.append(bridge_to_add)
 
     async def remove_bridge(self, bridge_to_remove: LinkPlayBridge) -> None:
@@ -80,6 +91,8 @@ class LinkPlayController:
                     multiroom.leader.multiroom = None
                     removed_multirooms.append(multiroom)
             except LinkPlayInvalidDataException as exc:
+                multiroom.leader.multiroom = None
+                removed_multirooms.append(multiroom)
                 LOGGER.exception(exc)
 
         # Create new multirooms from new bridges

{python_linkplay-0.2.2 → python_linkplay-0.2.4/src/python_linkplay.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python_linkplay
-Version: 0.2.2
+Version: 0.2.4
 Summary: A Python Library for Seamless LinkPlay Device Control
 Author: Velleman Group nv
 License: MIT

python_linkplay-0.2.2/src/linkplay/__version__.py

@@ -1 +0,0 @@
-__version__ = '0.2.2'