Deprecate services/properties over time

homeassistant/components/squeezebox/media_player.py

@@ -62,8 +62,11 @@
 
 SERVICE_CALL_METHOD = "call_method"
 SERVICE_CALL_QUERY = "call_query"
+SERVICE_SYNC = "sync"
+SERVICE_UNSYNC = "unsync"
 
 ATTR_QUERY_RESULT = "query_result"
+ATTR_SYNC_GROUP = "sync_group"
 
 SIGNAL_PLAYER_REDISCOVERED = "squeezebox_player_rediscovered"
 
@@ -78,6 +81,7 @@
 
 ATTR_TO_PROPERTY = [
     ATTR_QUERY_RESULT,
+    ATTR_SYNC_GROUP,
 ]
 
 SQUEEZEBOX_MODE = {
@@ -192,6 +196,12 @@ async def _discovered_player(player):
         },
         "async_call_query",
     )
+    platform.async_register_entity_service(
+        SERVICE_SYNC,
+        {vol.Required(ATTR_OTHER_PLAYER): cv.string},
+        "async_sync",
+    )
+    platform.async_register_entity_service(SERVICE_UNSYNC, None, "async_unsync")
 
     # Start server discovery task if not already running
     if hass.is_running:
@@ -381,6 +391,11 @@ def group_members(self):
                 sync_group.append(player_ids[player])
         return sync_group
 
+    @property
+    def sync_group(self):
+        """List players we are synced with. Deprecated."""
+        return self.group_members
+
     @property
     def query_result(self):
         """Return the result from the call_query service."""
@@ -545,10 +560,24 @@ async def async_join_players(self, group_members):
                     "Could not find player_id for %s. Not syncing", other_player
                 )
 
+    async def async_sync(self, other_player):
+        """Sync this Squeezebox player to another. Deprecated."""
+        _LOGGER.warning(
+            "Service squeezebox.sync is deprecated; use media_player.join_players instead"
+        )
+        await self.async_join_players([other_player])
+
     async def async_unjoin_player(self):
         """Unsync this Squeezebox player."""
         await self._player.async_unsync()
 
+    async def async_unsync(self):
+        """Unsync this Squeezebox player. Deprecated."""
+        _LOGGER.warning(
+            "Service squeezebox.unsync is deprecated; use media_player.unjoin_player instead"
+        )
+        await self.async_unjoin_player()
+
     async def async_browse_media(self, media_content_type=None, media_content_id=None):
         """Implement the websocket media browsing helper."""
         _LOGGER.debug(