steamworks.showWebOverlay()

Type Function

Return value Boolean

Revision 2017.3060

Keywords steam, steamworks, overlay, showWebOverlay

See also steamworks.canShowOverlay

steamworks.showGameOverlay()

steamworks.showUserOverlay()

steamworks.showStoreOverlay()

steamworks.*

Overview

Displays a Steam overlay on top of the application window. This overlay shows Steam's built-in web browser. You can use it to display a particular web page.

Returns true if Steam is able to display the overlay.

Gotchas

This function will return false — and the overlay will not show — in the following cases:

Invalid arguments were specified.
The steamworks.canShowOverlay property is false.
The steamworks.isLoggedOn property is false, indicating that the application is not currently connected to the Steam client.
The Steam client is not currently running.
User has disabled overlays in the Steam client's In-Game settings screen.
During the first few seconds of app startup. This is normal behavior since the Steam client needs time to bind to the application process.

Syntax

steamworks.showWebOverlay( [url] )

url _^(optional)

String. The URL to load in the overlay's web browser. If you do not provide a URL argument, the overlay will show the web browser's last displayed page.

Example

local steamworks = require( "plugin.steamworks" )

-- Attempt to show our home page within the application
local wasShown = steamworks.showWebOverlay( "https://coronalabs.com" )

if not wasShown then
    print( "Failed to display the overlay." )
end