Add AirPlay info

docs/player-support/sonos.md

@@ -6,11 +6,27 @@ Music Assistant has support for Sonos devices. There are two providers available
 
 - Sonos devices are auto detected by Music Assistant
 - Sonos devices from the same series (S1 or S2) will play in sync when grouped
-- Any physical control buttons on the device should be supported as long as [flow mode](../faq/normalization.md/#track-queueing) is not enabled. 
+- Sonos devices which support AirPlay 1 and AirPlay devices can be grouped and will play in sync via the AirPlay protocol 
+- Any physical control buttons on the device should be supported as long as [flow mode](../faq/normalization.md/#track-queueing) is not enabled
+
+### AirPlay Functionality
+
+Many Sonos devices support the AirPlay 1 protocol and this enables very useful functionality within Music Assistant.
+
+In order to use the AirPlay functionality of Sonos devices the AirPlay provider must also be added via the MA settings. This will result in AirPlay versions of the Sonos devices being created. These can then be hidden (not disabled) to remove duplicates of what will be the same player (enable `Hide in UI` in the AirPlay player settings).
+
+In the settings for the Sonos player there is an option to `Enable Airplay`.
+
+If the feature is disabled (normal Sonos playback) then the Sonos API will be used to stream audio to the Sonos speaker. The audio will be played on that speaker and any speakers that are linked to it.
+
+If the feature is enabled, then the playback command(s) will be redirected to the AirPlay player, meaning that the AirPlay protocol is used to play the audio on that Sonos speaker. Other Sonos players can be synced with this player and additionally it is possible to group any AirPlay capable speakers/players with the AirPlay-player of the Sonos speaker. This means it is possible to play the same audio in perfect sync to a combination of AirPlay and Sonos speakers.
+
+!!! note "Note"
+    You can also accomplish this by bypassing the whole Sonos integration and only use the AirPlay-equivalent of all the Sonos speakers but this is not preferable as not all Sonos speakers have AirPlay capabilities and syncing a player with the AirPlay protocol introduces a small silence due to the stream restart.
 
 ## Known Issues / Notes
 
 - Issues have been reported with the Sonos Arc and Unifi networking equipment. Ensure Multicast DNS and IGMP snooping are turned on if you have problems
 - S1 and S2 devices cannot be grouped together in the same Sync Group. S1 and S2 devices can be grouped via a Universal Group but will not play in sync
-- Using the Sonos HA Integration at the same time as the MA Sonos S1 player provider may cause problems. It is not possible to run the HA provider and Sonos S1 provider on the same host and additionally these speakers do not like too many requests from too many sources. It is therefore recommended to only use the MA Sonos S1 player provider.
-- Sonos has removed Airplay 1 support from the following models: ERA 100, ERA 300, Move 2. As such, Airplay streaming to these devices is not possible.
+- Using the Sonos HA Integration at the same time as the MA Sonos S1 player provider may cause problems. It is not possible to run the HA provider and Sonos S1 provider on the same host and additionally these speakers do not like too many requests from too many sources. It is therefore recommended to only use the MA Sonos S1 player provider
+- Sonos has removed AirPlay 1 support from the following models: ERA 100, ERA 300, Move 2. As such, AirPlay streaming to these devices is not possible