# Quick Start
This walkthrough shows how to add Storyly Moments to your Android application and forward your users to create their own stories.
Before you begin
First, declare the dependency for the Storyly Moments SDK in your app’s module Gradle file (usually
// You should add this line
Please do not forget to replace
<latest-version>. The latest version is (opens new window)
Storyly Moments SDK targets
Android API level 17 (Android 4.2, Jelly Bean) or higher.
# Import Storyly Moments
You need to import related packages to use Storyly Moments:
# Initialize Storyly Moments
Basic usage of Storyly Moments requires initialization of
StorylyMomentsManager with a
val storylyMoments = StorylyMomentsManager(context: Context, config: Config)
StorylyMomentsManager is done by
Config parameter. Initialization of
Config requires two string parameters, one of them is user payload and the other one is Storyly Moments token. You can get your Storyly Moments token from the Storyly Dashboard -> Settings -> Moments (opens new window). For more information about the user payload please check User Payload section.
val config = Config(momentsToken: String, userPayload: String)
You need to set
StorylyMomentsManager to call main functions of
var momentsManager = StorylyMomentsManager(context, Config(
# Main Functions
Storyly Moments presents two basic functions for your users. These are Create and Share Story and Open My Stories which will be explained below:
# Create and Share Story
After Storyly Moments is initialized, you are ready to direct your users to create their first story by calling the following function using your Storyly Moments instance:
fun createStory(uri: Uri)
After you call
createStory function without
uri parameter, if your users give necessary permission, they will be directed to their media library. For more information about permissions and their effects on story creation please check Permissions section. In media library, your users can take the following actions:
- Select a single media to share
- Select multiple media to share
- Open camera to capture media (If permission is given)
Selecting one of these options will open a share story screen for the last review of the media. In share story screen, users can review the selected media and they can either discard or share media. After upload and share process is successful, users will be directed to my stories screen to see their newly created stories.
If you call createStory function with
uri parameter, your users will be directed to story sharing screen straight away with the provided media.
# Open My Stories
Using this function, you can let your users view their live stories by opening my stories screen. In my stories screen, your users are able to check who has seen or liked their stories. They can also delete their live stories. You can direct your users to this screen using the following function:
public func openMyStories()
# Initiate Main Functions From Storyly Bar
For your application users to see the stories of their followers, you should integrate Storyly SDK (opens new window) into your application. For this, you should initialize your Storyly instance by passing the user payload to the
storylyPayload parameter as follows:
val storylyId: String,
val storylyPayload: String?
If you have already connected your Storyly Moments* instance to your Storyly instance of your application from dashboard and initialize the Storyly Moments* instance by sending the user payload through
storylyPayload parameter, users will be able to see stories of their followers by default.
In addition to these follower story groups, Storyly SDK allows you to add custom Storyly Moments views in order to initiate story create process or show user's own stories from Storyly bar. You can create your own views and assign those views to
fun setMomentsItem(momentsItems: List<MomentsItem>)
Assigned custom views will be the initial story groups and their places will be fixed.
# Set up Listener
This walkthrough shows you how to handle Storyly Moments events in your app. Storyly Moments events provide insight on what your user intend to do in Storyly Moments such as opening gallery to create story or opening the user stories to preview.
MomentsListener notifies application when an event occurs. You can adopt
MomentsListener interface in your code, and then override its functions to learn about specific events, which will be explained in the next sections.
Do not forget to provide the class that adopts
MomentsListener in Storyly Moments setup.
# onOpenCreateStory Event
This event will let you know that your users intend to create a story.
isDirectMediaUpload parameter denotes whether the users intend to create a story using application provided media or library/camera media. In order to be notified about this event, override the following function in your listener:
fun onOpenCreateStory(isDirectMediaUpload: Bool)
# onOpenMyStory Event
This event will let you know that your users intend to view their stories. In order to be notified about this event, override the following function in your listener:
# onUserStoriesLoaded Event
This event will let you know that your loading of user stories is successful.
momentsStoryGroup parameter denotes loaded user story group information. In order to be notified about this event, override the following function in your listener:
fun onUserStoriesLoaded(momentsStoryGroup: MomentsStoryGroup?)
# onUserStoriesLoadFailed Event
This event will let you know that your loading of user stories loading is failed.
errorMessage parameter denotes fail reason of the loading. In order to be notified about this event, override the following function in your listener:
fun onUserStoriesLoadFailed(errorMessage: String)