openDeepLink

fun openDeepLink(activity: Activity, storytellerDeepLink: String, onError: (StorytellerError) -> Unit = { })

Opens content based on a Storyteller deep link. This method can handle deep links for Stories, Clips collections, categories, or sheets. If another Storyteller player is active, it is dismissed before the requested content opens. Structurally invalid links leave the active player unchanged. When multiple valid links arrive during dismissal, only the latest opens. A structurally valid Story, Page, Category, Clip Collection, or Clip link may still report StorytellerError after dismissal if its content is unavailable. An unavailable Sheet keeps the existing inline Sheet error UI. For more information on deep linking, see the Storyteller Deep Linking Documentation.

Parameters

activity

The Activity from which to open the deep link.

storytellerDeepLink

The Storyteller deep link string.

onError

Callback invoked for invalid links, replacement lifecycle/timeout failures, or unavailable Story, Page, Category, Clip Collection, or Clip content. A Sheet fetch failure is rendered in the Sheet's existing inline error UI after it opens.