From d82679e53c741616d2a848d291304f9e5057341b Mon Sep 17 00:00:00 2001 From: WarmUpTill Date: Fri, 14 Oct 2022 22:25:18 +0200 Subject: [PATCH] Created Media condition (markdown) --- Media-condition.md | 60 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 Media-condition.md diff --git a/Media-condition.md b/Media-condition.md new file mode 100644 index 0000000..be01b2b --- /dev/null +++ b/Media-condition.md @@ -0,0 +1,60 @@ +# Media condition +The "Media" macro condition allows you to check the state and current playback time of various media source types. + +## Source selection + +Supported source types are: + +* Media Source +* VLC Video Source +* Image Slide Show + +The source to test can be selected at (1). + +![Media1](https://user-images.githubusercontent.com/19472752/195937266-b6eb175d-3d49-4361-8348-8c83603869b6.PNG) + +## State selection + +The states that can be checked for are the following: + +* Playing +* Opening +* Buffering +* Paused +* Stopped +* Ended +* Ended (Playlist) +* Any + +The state to check for can be selected at (2). + +![Media2](https://user-images.githubusercontent.com/19472752/195937297-c3d71a74-24f4-4199-92ce-7c7d3e622592.PNG) + +### Notes + +* Select "Any" if you would like to only test for conditions in the time selection. + +* The "Ended" will trigger when individual playlist items end when using VLC Video Sources. + +* The "Ended (Playlist)" state is intended to be used in combination with VLC Video Source playlists. +It is not a media state natively supported by OBS and thus comes with some drawbacks. +It works by checking if the selected media source reports the "ended" state for an extended period of time. +Thus if VLC Video Source is configured to be continuously looping this state will not trigger. + +* "Stopped" and "Ended" behave differently. +The former is trigger if the playback is manually stopped using the media controls, the latter if the playback ended on its own. + +* Prior to OBS version 28.0.2 the media state reported by the Image Slide show was very inconsistent with what the source was actually doing. (E.g. would remain in Ended state even though the playback was restarted) + +* The different source types might behave sightly differently in regard to when which state is active so you might have to [experiment](Troubleshooting#visual-indicators-of-macro-activity-and-status) a bit. + + +## Time Selection + +You will be able to check the total length of the media source and the remaining time of the current playback using the time selection at (3). + +![Media3](https://user-images.githubusercontent.com/19472752/195937331-706a5ab9-99da-473d-9d1e-940d3e475595.PNG) + +### Notes + +* Select "None" if you would like to only test for conditions in the state selection. \ No newline at end of file