Android Stories Library
Instagram like stories library for Android.
Add it in your root build.gradle at the end of repositories:
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
Step 2. Add the dependency
dependencies {
implementation 'com.github.MrMak21:Android-Stories:1.1.4'
}
Usage
- Add view to Activity/Fragment layout
<gr.makris.androidstories.Stories
android:id="@+id/stories"
android:layout_width="match_parent"
android:layout_height="match_parent"
app:progressBarBackgroundColor="@color/gray" // --> progressBar bacground color
app:progressBarColor="@color/white" // --> progressBar color
app:storyDuration="3" // --> in seconds
app:loadingViewProgressColor="@color/purple_700" />
- You can also change the progress bar color & the background with these attributes
app:progressBarBackgroundColor="@color/gray"
app:progressBarColor="@color/white"
- Then create a StoryItem() lists and pass it to Stories view.
Kotlin example:
val storiesList = listOf<StoryItem>(
StoryItem(url = "https://picsum.photos/300/500"),
StoryItem(src = "R.drawable.cool_image"),
StoryItem(url = "https://picsum.photos/300/500"),
StoryItem(src = "R.drawable.cool_image_2")
)
val storiesView = findViewById<Stories>(R.id.stories)
storiesView.setStoriesList(storiesList)
- The StoryItem object can take 2 types of parameters:
- String (Useful for url's containing images)
- Int (You can load a Drawable file)
- Also Android Stories library view containing all the instagram-like functionality. Press to the right to go next story, press to the left to go to the previous story or hold to pause time.
- Android Stories library view also contains a callback so you know when the stories come to an end.
All you have to do is implement StoriesCallback in your Activity/Fragment and override onStoriesEnd() method.
Kotlin example:
class MainActivity : AppCompatActivity(), StoriesCallback
...
...
override fun onStoriesEnd() {
//do something
}
Upcoming things
- Set marginStart & marginEnd of story-progress view from xml
- Set margin between every story-progress line on top of the view
- Support videos
2.7k Dec 27, 2022
2.6k Jan 9, 2023
1.4k Jan 7, 2023
1.7k Dec 27, 2022
5.7k Jan 2, 2023
884 Nov 22, 2022
38 Feb 12, 2022
2.8k Dec 28, 2022
530 Dec 19, 2022
97 Nov 24, 2022
14 Dec 20, 2022
1.1k Jul 23, 2021
5k Dec 27, 2022
3 Aug 6, 2021
91 Nov 25, 2022
110 Nov 11, 2022
1k Dec 18, 2022
26 Dec 22, 2022
97 Dec 30, 2022