ScreenSoft Docs / Browser Embedded Functions

Browser Embedded Functions

Control ScreenSoft layer navigation directly from a browser-based application.

When to use these functions

Browser Embedded Functions are JavaScript functions exposed to a browser-based application running inside ScreenSoft. They let the web application navigate between the Application layer and Presentation layer without relying only on the standard kiosk UI.

onUp

Navigates one step back in the ScreenSoft navigation stack. From the browser it switches to the Presentation or Application layer depending on the defined navigation path.

window.onUp({
    request: '{}',
    onSuccess: function(response) {
        console.log(response);
    },
    onFailure: function(error_code, error_message) {
        console.log(error_message);
    }
});

request: empty object {}. Success response: null. Failure: error_code -1, message Disabled application layer. Single-app kiosk.

showLayerBottom

Switches directly from the browser to the Application layer, where applications are available in multi-app kiosk mode.

window.showLayerBottom({
    request: '{}',
    onSuccess: function(response) {
        console.log(response);
    },
    onFailure: function(error_code, error_message) {
        console.log(error_message);
    }
});

Failure: error_code -1, message Single-app kiosk.

showLayerTop

Switches directly from the browser application to the Presentation layer.

window.showLayerTop({
    request: '{}',
    onSuccess: function(response) {
        console.log(response);
    },
    onFailure: function(error_code, error_message) {
        console.log(error_message);
    }
});

Failure: error_code -1, message Presentation layer disabled.

Implementation recommendation
Always handle onFailure. Use onUp when navigation should follow context and showLayerTop when the web application explicitly needs to return to presentation content.
Didn't find what you were looking for?
Contact ScreenSoft support at support@screensoft.org