> [!info] Available only on SPX Production and Broadcast license. See [Products](https://spxgraphics.com/software/) --- > [!example]- GET `/api/v1/rundown/load?file=MyFirstProject/MyFirstRundown` > Open rundown from project / file. --- > [!example]- GET `/api/v1/rundown/focusFirst` > Move focus to the first item on the rundown. --- > [!example]- GET `/api/v1/rundown/focusNext` > Move focus down to next item, will not circle back to top when end is reached. --- > [!example]- GET `/api/v1/rundown/focusPrevious` > Move focus up to previous item, will not circle back to bottom when top is reached. --- > [!example]- GET `/api/v1/rundown/focusLast` > Move focus to the last item on the rundown. --- > [!example]- GET `/api/v1/rundown/focusByID/1234567890` > Move focus by ID on the rundown. --- > [!example]- GET `/api/v1/rundown/stopAllLayers` > Animate all layers (used by the current rundown) out, but does not clear layers. --- > [!example]- GET `/api/v1/item/play` > Start focused item. --- > [!example]- GET `/api/v1/item/play/1234567890` > Start item by ID on the active rundown. --- > [!example]- GET `/api/v1/item/continue` > Issue continue command to selected item. Notice this needs support from the template itself and does not work as play or stop. --- > [!example]- GET `/api/v1/item/continue/1234567890` > Continue to item by ID on the active rundown. Notice this needs support from the template itself and does not work as play or stop. --- > [!example]- GET `/api/v1/item/stop` > Stop focused item. --- > [!example]- GET `/api/v1/item/stop/1234567890` > Stop item by ID on the active rundown. --- > [!example]- GET `/api/v1/invokeTemplateFunction?playserver=OVERLAY&playchannel=1&playlayer=19&webplayout=19&function=myCustomTemplateFunction&params=Hello%20World` > Uses an invoke handler to call a function in a template. JSON objects can be passed as params by urlEncoding stringified JSON. Search SPX Knowledge Base for more info with keyword `invoke`. --- > [!example]- GET `/api/v1/invokeExtensionFunction?function=sendCmd&params=incrementNumber` > Uses SPX's messaging system to call a function in an extension. JSON objects can be passed as params by urlEncoding stringified JSON. The extension will need to implement SPX's messaging system, search SPX Knowledge Base for more info with keyword `invokeExtensionFunction`. --- > [!example]- GET `/api/v1/rendererAudioController?command=play&file=/media/wav/whoosh.wav&fade=1000&loop=true` > Play or stop audio file playback through the renderer (browser). > > Optional `fade` duration in milliseconds can be used with play or stop. `stop` does not require file property. Optional `loop=true` property can be used with the play command. > > SPX's Application Configuration has options to choose on which renderer()s) the audio should be played. > > **Note:** Some video pipelines cannot capture audio from the browser sources. > > **Note:** Modern browsers may have the "auto-play policy" which may require user interaction on the page before any audio will play, so this setting may prevent playing back renderer audio in SPX. This cannot be handled programmatically, but Chrome browser provides command line argument to disable this: `chrome.exe --autoplay-policy=no-user-gesture-required`. This may or may not be set in embedded browsers, so test `rendererAudioController` in your production pipeline carefully. For details, see https://developer.chrome.com/blog/autoplay/#developer_switches. > > See also `serverAudioController` endpoint for an alternative workflow for playing back audio on the server's operating system instead. Also see [[Audio playout]] --- > [!example]- GET `/api/v1/serverAudioController?command=play&file=/media/wav/whoosh.wav&fade=1000&loop=true` > Play or stop audio file playback through the host computer's audio hardware and connectors. > > Optional `fade` duration in milliseconds can be used with play or stop. `stop` does not require file property. Optional `loop=true` property can be used with the play command. > > SPX's Application Configuration has options to choose on which audio output device the audio should be played. > > See also `rendererAudioController` endpoint for an alternative workflow for playing back audio on the SPX's browser output(s) instead. [[Audio playout]] --- ## Read Next - [[Server API|Server API]] - Automation endpoints - [[Common API|Common API]] - Utility endpoints - [[Documentation/Control Interfaces/REST/Overview of SPX API|API Overview]] - Complete API guide - [[Documentation/Control Interfaces/External Control|External Control]] - Hardware controller integration