Flutter API reference

The complete API reference for the Knock Flutter SDK.

In this section, you'll find the documentation for the classes and methods available in the Flutter SDK.

`Knock`

The top-level Knock class. Create an authenticated Knock client instance for interacting with Knock.

Params

apiKeyString*The public API key for the Knock environment.

optionsKnockOptionsAny additional options to instantiate your Knock instance with

Returns

Knock

`authenticate`

Authenticates the current user.

Params

userIdString*The ID of the user to authenticate against.

userTokenStringThe signed user token, required when using enhanced security mode in the environment.

Returns

void

`logout`

Clears any user authentication and disposes of any created clients.

Returns

void

`isAuthenticated`

Returns whether or this Knock instance is authenticated. Passing true will check the presence of the userToken as well.

Returns

bool

`dispose`

Releases any connected resources used by this instance.

Returns

void

`getApnsToken`

Returns the current device's APNS token. Only relevant for iOS applications.

Returns

Future<String>

`getFcmToken`

Returns the current device's FCM token.

Returns

Future<String>

`user`

Returns the current user client.

Returns

UserClient

`preferences`

Returns the current preferences client.

Returns

PreferencesClient

`feed`

Returns a new feed client for the channel ID specified.

Params

feedChannelIdString*The channel ID from Knock for the in-app feed

optionsFeedOptionsAny additional options to instantiate your feed instance with

Returns

FeedClient

`UserClient`

Methods for interacting with the current user resource in Knock. You access this under knock.user().

`get`

Returns the current authenticated user from Knock.

Returns

Future<User>

`identify`

Upserts the current authenticated user properties in Knock.

Returns

Future<User>

`getChannelData`

Returns any channel data set for the channelId given for the current authenticated user.

channelIdStringThe channel ID from Knock

Returns

Future<ChannelData>

`setChannelData`

Updates the channel data for the current user on the channel specified with channelId.

Params

channelIdStringThe channel ID to update the channel data for

dataAnyThe data to update for the channel data

Returns

Future<ChannelData>

`registerTokenForChannel`

Registers the current device's token for the user in Knock.

Params

channelIdStringThe push channel ID from Knock

tokenStringThe device token to register

Returns

Future<ChannelData>

`deregisterTokenForChannel`

De-registers the current device's token for the user in Knock.

Params

channelIdStringThe push channel ID from Knock

tokenStringThe device token to remove

Returns

Future<ChannelData>

`PreferencesClient`

`getAll`

Returns all preference sets for the current user.

Returns

Future<List<PreferenceSet>>

`get`

Returns a single preference set for the current user.

Returns

Future<PreferenceSet>

`set`

propertiesSetPreferencesPropertiesThe preference set to upsert

Returns

Future<PreferenceSet>

`FeedClient`

feedChannelIdStringThe in-app channel ID from Knock

optionsFeedOptionsDefault options to apply to the feed instance

Returns

FeedClient

`feed`

Returns the current feed controller to be bound and used when building UI.

Returns

Stream<Feed>

`fetchNextPage`

Fetches the next page of items in the feed, as long as there are more items to fetch.

Returns

void

`on`

Binds an event listener to the feed.

Params

bindableFeedEventBindableFeedEventThe type of event to listen to

Returns

Stream<FeedEvent>