MyFavMirrors/owntone-server
1
0
Fork 0
mirror of https://github.com/owntone/owntone-server.git synced 2025-02-28 05:49:18 -05:00
Code Issues Packages Projects Releases Wiki Activity

[player] Remove outdated comment

Browse Source
This commit is contained in:
ejurgensen 2020-05-05 16:04:39 +02:00
parent 77165d834c
commit b10434627a
1 changed files with 5 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
src/outputs.h
View File

@ -20,33 +20,11 @@
* When a device is started the output backend will typically create a session.
* This session is only passed around as an opaque object in this interface.
*
* Here is the sequence of commands from the player to the outputs, and the
* callback from the output once the command has been executed. Commands marked
* with * may make multiple callbacks if multiple sessions are affected.
*
* PLAYER OUTPUT PLAYER CB
* speaker_activate -> device_start -> device_activate_cb
* -> (if playback) -> playback_start -> device_streaming_cb* (or no cb)
* -> (else if playback not active) -> device_streaming_cb
* -> (fail) -> device_stop -> device_lost_cb
* speaker_activate -> device_probe -> device_probe_cb
* speaker_deactivate -> device_stop -> device_shutdown_cb
* volume_set -> device_volume_set -> device_command_cb
* -> -> device_streaming_cb
* (volume_setrel/abs_speaker is the same)
* playback_start_item -> device_start -> device_restart_cb
* -> (success) -> device_streaming_cb
* -> (fail) -> device_stop -> device_lost_cb
* playback_start_bh -> playback_start -> device_streaming_cb* (or no cb)
* playback_stop -> flush -> device_command_cb*
* -> -> device_streaming_cb*
* -> -> playback_stop -> device_streaming_cb*
* playback_pause -> flush -> device_command_cb*
* -> -> device_streaming_cb*
* -> -> playback_stop -> device_streaming_cb*
* playback_abort -> playback_stop -> device_streaming_cb* (or no cb)
* device_streaming_cb -> device_streaming_cb (re-add)
*
* Many of the functions here use callbacks to the player to support async setup
* etc. The general concept is that the player initiates an action, e.g. volume
* change, and then the return value from the output function is the number of
* callbacks the player should wait for. The output backend *must* make all the
* callbacks, otherwise the player may hang.
*/
// If an output requires a specific quality (like Airplay 1 devices often