iiVisu
A player/ recorder visualizer with the swipe to seek functionality.
Demo
Setup
Step 1. Add the JitPack repository to your build file
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.imnirdst:iivisu:1.1.0'
}
Usage
This repository contains a sample app that shows how to use iiVisu.
Recorder
RecorderVisualizer doesn't support swipe to seek functionality.
<com.imn.iivisu.RecorderVisualizer
android:id="@+id/visualizer"
android:layout_width="0dp"
android:layout_height="256dp"
app:maxAmp="100"
app:barWidth="3dp"
app:spaceBetweenBar="2dp"
app:loadedBarPrimeColor="@color/primaryLight"
app:backgroundBarPrimeColor="@color/gray"
app:layout_constraintBottom_toTopOf="@id/timeline_text_view"
app:layout_constraintTop_toTopOf="parent"
app:layout_constraintLeft_toLeftOf="parent"
app:layout_constraintRight_toRightOf="parent" />
visualizer.ampNormalizer = { sqrt(it.toFloat()).toInt() }
recorder.apply {
onStop = { visualizer.clear() }
onAmpListener = {
runOnUiThread {
visualizer.addAmp(it)
}
}
}
Player
<com.imn.iivisu.PlayerVisualizer
android:id="@+id/visualizer"
android:layout_width="0dp"
android:layout_height="256dp"
app:barWidth="3dp"
app:spaceBetweenBar="2dp"
app:approximateBarDuration="50"
app:loadedBarPrimeColor="@color/primaryLight"
app:backgroundBarPrimeColor="@color/gray"
app:layout_constraintBottom_toTopOf="@id/timeline_text_view"
app:layout_constraintTop_toTopOf="parent"
app:layout_constraintLeft_toLeftOf="parent"
app:layout_constraintRight_toRightOf="parent" />
visualizer.apply {
onStartSeeking = { player.pause() }
onSeeking = { timelineTextView.text = it.formatAsTime() }
onFinishedSeeking = { time, isPlayingBefore ->
player.seekTo(time)
if (isPlayingBefore) {
player.resume()
}
onAnimateToPositionFinished = { time, isPlaying ->
player.seekTo(time)
}
}
}
visualizer.ampNormalizer = { sqrt(it.toFloat()).toInt() }
player.onProgress = { time, isPlaying ->
visualizer.updateTime(time.toInt(), isPlaying)
}
Documentation
-
maxAmp: Maximum amp that you expected to receive from the mic. Amps with higher than maxAmp are shown as a full height bar. This is calculated automatically in thePlayerVisualizer. -
barWidth: Width of each bar. -
spaceBetweenBar: Space between each bar. -
approximateBarDuration: Defines approximate duration of each bar. The exact duration of each bar is calculated and stored in thebarDurationvariable. -
loadedBarPrimeColor: Defines loaded bar color. -
backgroundBarPrimeColor: Defines background (unloaded) bar color. -
ampNormalizer: Receives a lambda method for normalizing amps. (for better visualization) -
addAmp: Used for adding an amp toRecorderVisualizerand its bar gets drawn Immediately. -
updateTime: Used for updatingPlayerVisualizertimeline to specified location.isPlayingparam is used for defining behaviour ofonFinishedSeekingcallback. -
onStartSeeking: Receives a callback for the action needed to happen when seeking starts. -
onSeeking: Receives a callback for the action needed to happen during the seeking process and contains current time position of the visualizer. -
onFinishedSeeking: Receives a callback for the action needed to happen after the seeking finishes and contains time position of the visualizer and a variable for deciding whether you need to resume player after seeking or not. -
seekOver(amount): Moves visualizer's cursoramountahead/back and notifies usingonAnimateToPositionFinishedcallback. -
seekTo(position): Moves visualizer's cursor topositionand notifies usingonAnimateToPositionFinishedcallback. -
onAnimateToPositionFinished: Receives a callback for the action needed to happen after the moving to position finishes and contains time position of the visualizer and a variable for deciding whether you need to resume player after seeking or not.
License
MIT. See the LICENSE file for details.
2.3k Dec 9, 2022
78 Sep 27, 2022
315 Dec 21, 2022
1.3k Nov 25, 2022
1.3k Dec 29, 2022
831 Jan 4, 2023
697 Dec 14, 2022
340 Nov 13, 2022
1 Nov 23, 2021
32 Dec 10, 2022
502 Dec 29, 2022
744 Dec 25, 2022
23 Feb 15, 2022
542 Nov 24, 2022
33 May 6, 2022
1 Feb 2, 2022
5 Dec 6, 2021
1k Dec 29, 2022