diff options
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/client-api-changes.rst | 4 | ||||
-rw-r--r-- | DOCS/man/input.rst | 17 |
2 files changed, 20 insertions, 1 deletions
diff --git a/DOCS/client-api-changes.rst b/DOCS/client-api-changes.rst index 136e6a832e..ade0234e79 100644 --- a/DOCS/client-api-changes.rst +++ b/DOCS/client-api-changes.rst @@ -34,7 +34,9 @@ API changes --- mpv 0.33.0 --- 1.108 - Deprecate MPV_EVENT_IDLE - - add mpv_event_start_file, mpv_event_end_file.playlist_entry_id + - add mpv_event_start_file + - add the following fields to mpv_event_end_file: playlist_entry_id, + playlist_insert_id, playlist_insert_num_entries - add mpv_event_to_node() - add mpv_client_id() 1.107 - Remove the deprecated qthelper.hpp. This was obviously not part of the diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst index 3e449ba81b..c19a8fdd65 100644 --- a/DOCS/man/input.rst +++ b/DOCS/man/input.rst @@ -1358,6 +1358,23 @@ This list uses the event name field value, and the C API symbol in brackets: In the future, this ``error`` field will be unset for this specific event.) + ``playlist_insert_id`` + If loading ended, because the playlist entry to be played was for example + a playlist, and the current playlist entry is replaced with a number of + other entries. This may happen at least with MPV_END_FILE_REASON_REDIRECT + (other event types may use this for similar but different purposes in the + future). In this case, playlist_insert_id will be set to the playlist + entry ID of the first inserted entry, and playlist_insert_num_entries to + the total number of inserted playlist entries. Note this in this specific + case, the ID of the last inserted entry is playlist_insert_id+num-1. + Beware that depending on circumstances, you may observe the new playlist + entries before seeing the event (e.g. reading the "playlist" property or + getting a property change notification before receiving the event). + If this is 0 in the C API, this field isn't added. + + ``playlist_insert_num_entries`` + See playlist_insert_id. Only present if playlist_insert_id is present. + ``file-loaded`` (``MPV_EVENT_FILE_LOADED``) Happens after a file was loaded and begins playback. |