The Audio Icon can be added to Panel Editor and Layout Editor panels. When the icon is added, an Audio Source is selected from a list of audio sources. The icon can be configured to play the sound by clicking on the icon in JMRI and/or by clicking/touching the icon on the current panel displayed by the JMRI Web Server. It can also be used by LogixNG to play a sound on the current panel displayed by the JMRI Web Server.
The Audio Icon provides the connectivity between JMRI running on computer and the current panel displayed in a web browser via the JMRI Web Server.
The web browser has to have media auto play enabled. The procedure depends on the operating system and the browser. In some cases, clicking on the audio icon on the web page will allow subsequent JMRI requests without auto play being enabled.
The Audio icon options are set using the Web panels sub-menu in the Audio Icon context menu.
The three mouse options and the Play sound option provide six combinations of when and where sounds will be played. For example, to play a sound only on the web panel when the web icon is clicked, use the Local option.
| Menu Items | Icon | Sound Location |
|---|---|---|
| Global | JMRI | JMRI |
| Web | JMRI | |
| Local | JMRI | JMRI |
| Web | Web | |
| None | JMRI | None |
| Web | None | |
| Global + Play sound | JMRI | JMRI and Web |
| Web | JMRI and Web | |
| Local + Play sound | JMRI | JMRI and Web |
| Web | Web | |
| None + Play sound | JMRI | None |
| Web | None |
The Stop sound option applies to audio sources that have looping enabled or to stop long running sound files.
The LogixNG Audio action can be used to play sounds on the computer running JMRI but those sounds will not be played on a web panel. The LogixNG Audio icon on web panel action can be used to start and stop sounds on web panels using the Audio Icon. Note: The sounds are not played on the JMRI computer.
Note: The Audio icon on web panel action does not use the Web panels options.
If the icon is used to play a sound using only the LogixNG action, the option Hide when not editing might be useful if the user shouldn't see the icon. The icon plays the sound even if it's not visible.
See Audio icon on web panel in the LogixNG Reference for details about the LogixNG action.