Additional Methods

Static attributes

• currentUserId - current user id
• currentApiKey - current api key set by initialize(apiKey: String, onComplete: () -> Void, onError: (Error) -> Void)
• version - current SDK version
• isInitialized - check if Storyteller has been successfully initialized
• isPresentingStory - check if Story is being presented at the moment
• theme: default fallback theming style used to render story items in lists and activities launched from list

Static methods

isStorytellerDeeplink

isStorytellerDeeplink(url: URL) -> Bool

Checks if the given url is Storyteller deeplink

Parameters:

• url - Deeplink url. This usually is obtained from the AppDelegate method: application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool

openStory

openStory(id: String, onError: @escaping ((Error) -> Void))

This call opens story with given identifier. It is individual story requested per openStory call.

Parameters:

• id - story id
• onError - called when there is any issue with opening story (e.g. the requested content is no longer available)

openPage

openPage(id: String, onError: @escaping ((Error) -> Void))

This call opens story's page with given identifier. It is individual story requested per openPage call.

Parameters:

• id - page id
• onError - called when there is any issue with opening story (e.g. the requested content is no longer available)

openDeeplink

openDeeplink(url: URL, onError: ((Error) -> Void)) -> Bool

This call makes Storyteller to open provided deeplink (showing the requested Page / Story). Method returns true if the url is Storyteller deeplink.

Parameters:

• url - Deeplink url. This usually is obtained from AppDelegate method: application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool
• onError - called when there is any issue with opening deeplink (e.g. the requested content is no longer available)

dismissStoryView

dismissStoryView(animated: Bool, dismissReason: String, onComplete: (() -> Void))

The dismissStoryView() force closes the currently open story view. If no story view is open when this is called, it has no effect.

Parameters:

• animated: whether to animate the dismissing of the view or not
• dismissReason: the reason why the story pager was force closed. This will be used to populate the dismissedReason parameter of the corresponding onUserActivityOccurred callback. If this is set to null the onUserActivityOccurred callback will not be triggered
• onComplete: called when story has been dismissed or story was not presented in the first place

Methods

initialize

initialize(apiKey: String, userInput: UserInput, categoriesToPreload: [String], onComplete: VoidCompletion, onError: ErrorCompletion)

The initialize method is required to be called for Storyteller to work. It's recommended to fire this method as soon as possible in the app lifecycle.

Parameters:

• apiKey - api key provided by Storyteller team
• userInput: id of the user to be authorized
• categoriesToPreload: list of categories id to be preloaded. If array is empty the default category will be preloaded.
• onComplete - called when initialization has finish and succeeded
• onError - called when there is an issue with initialization