Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ImnIrdst/iiVisu
A player/ recorder visualizer with the swipe to seek functionality.
https://github.com/ImnIrdst/iiVisu
android android-visualizer audio-visualizer custom-view visualizer
Last synced: 3 months ago
JSON representation
A player/ recorder visualizer with the swipe to seek functionality.
- Host: GitHub
- URL: https://github.com/ImnIrdst/iiVisu
- Owner: ImnIrdst
- License: mit
- Created: 2020-10-29T15:50:40.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2023-01-25T01:07:49.000Z (almost 2 years ago)
- Last Synced: 2024-01-31T23:43:21.149Z (9 months ago)
- Topics: android, android-visualizer, audio-visualizer, custom-view, visualizer
- Language: Kotlin
- Homepage:
- Size: 3.69 MB
- Stars: 143
- Watchers: 4
- Forks: 13
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-android-ui - iiVisu - play.gif" width="62%"> (Index)
README
# iiVisu
[](https://jitpack.io/#ImnIrdst/iiVisu)
[](https://android-arsenal.com/details/1/8186)
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`](https://github.com/ImnIrdst/iiVisu/blob/main/iivisu/src/main/java/com/imn/iivisu/RecorderVisualizer.kt) doesn't support swipe to seek functionality.
```XML
```
```Kotlin
visualizer.ampNormalizer = { sqrt(it.toFloat()).toInt() }
recorder.apply {
onStop = { visualizer.clear() }
onAmpListener = {
runOnUiThread {
visualizer.addAmp(it)
}
}
}
```
## Player
```XML
```
```Kotlin
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)
}
val amps = player.loadAmps()
visualizer.setWaveForm(amps, player.tickDuration)
```
# 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 the `PlayerVisualizer`.
- `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 the `barDuration` variable.
- `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 to `RecorderVisualizer` and its bar gets drawn Immediately.
- `setWaveForm`: Receives a list of integer `amps` and a `tickDuration` which defines the time per each amp.
- `updateTime`: Used for updating `PlayerVisualizer` timeline to specified location. `isPlaying` param is used for defining behaviour of `onFinishedSeeking` callback.
- `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 cursor `amount` ahead/back and notifies using `onAnimateToPositionFinished` callback.
- `seekTo(position)`: Moves visualizer's cursor to `position` and notifies using `onAnimateToPositionFinished` callback.
- `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](https://github.com/ImnIrdst/iiVisu/blob/main/LICENSE) file for details.