Display the banner

val banner = UsercentricsBanner(<Context>)
banner.showFirstLayer() { userResponse ->
    // Handle userResponse
}

Use a valid Context

We are using the Dialog Android API for the Banner implementation. It is recommended to use a Context that is an Activity or derived/wrapper from it. Note that the Activity has to be alive for the dialog to be displayed.

final userResponse = await Usercentrics.showFirstLayer();
// Handle userResponse

const userResponse = await Usercentrics.showFirstLayer();
// Handle userResponse

Usercentrics.Instance.ShowFirstLayer(<UsercentricsLayout>, (userResponse) => {
    // Handle userResponse
});

val banner = UsercentricsBanner(<Context>)
banner.showSecondLayer() { userResponse ->
    // Handle userResponse
}

Use a valid Context

We are using the Dialog Android API for the Banner implementation. It is recommended to use a Context that is an Activity or derived/wrapper from it. Note that the Activity has to be alive for the dialog to be displayed.

Restoring unsaved choices after a configuration change (optional)

A configuration change (e.g. toggling dark mode) can recreate the hosting Activity while the Second Layer is open, closing the banner before any unsaved choice is saved. To preserve that in-progress state, pass an onSecondLayerStateSnapshot callback to capture it, and hold the result somewhere that survives recreation (e.g. a ViewModel):

banner.showSecondLayer(
    initialState = pendingSecondLayerState, // null on a fresh show
    onSecondLayerStateSnapshot = { pendingSecondLayerState = it },
) { userResponse ->
    // Handle userResponse
}

Then, when your Activity is recreated, pass the stored state back in as initialState to reopen the banner exactly as the user left it. This is entirely optional — the existing showSecondLayer { } call keeps working unchanged if you don't need it.

final userResponse = await Usercentrics.showSecondLayer();
// Handle userResponse

const userResponse = await Usercentrics.showSecondLayer();
// Handle userResponse

Usercentrics.Instance.ShowSecondLayer(<showCloseButton>, (userResponse) => {
    // Handle userResponse
});

import com.usercentrics.sdk.models.settings.SecondLayerTab

val banner = UsercentricsBanner(<Context>)
banner.showSecondLayer(SecondLayerTab.SERVICES) { userResponse ->
    // Handle userResponse
}

final userResponse = await Usercentrics.showSecondLayer(tab: SecondLayerTab.services);
// Handle userResponse

tab can be combined with settings (BannerSettings): Usercentrics.showSecondLayer(settings: <BannerSettings>, tab: SecondLayerTab.partners).

import {Usercentrics, SecondLayerTab} from '@usercentrics/react-native-sdk';

const userResponse = await Usercentrics.showSecondLayer(undefined, SecondLayerTab.services);
// Handle userResponse

The tab is the second argument, after the optional BannerSettings.

Usercentrics.Instance.ShowSecondLayer(null, SecondLayerTab.Services, (userResponse) => {
    // Handle userResponse
});

The first argument is the optional BannerSettings (pass null for the defaults). Works on Android and iOS builds.