Skip to content

Latest commit

 

History

History
84 lines (63 loc) · 3.51 KB

README.md

File metadata and controls

84 lines (63 loc) · 3.51 KB
Raw

Audio Playback Library with Visualizer

Description

The AudioPlayer module is designed to handle audio playback functionality in your application. It provides methods for starting and controlling audio playback, as well as handling various events related to audio playback.

Demo new

image_demo

Overview

This library is a versatile audio playback solution that allows you to seamlessly handle both offline and online audio content. It comes equipped with a built-in visualizer for real-time audio waveform display and an equalizer for fine-tuning audio output to meet your specific needs. Features Offline Audio Playback

Local Audio File Support: Easily play audio files stored on your device, making it perfect for music and sound effect playback in your applications.

Usage

  1. Initialization: Initialize the AudioPlayer and set the audio file path using the StartMusic method.

    Public Sub StartMusic(call As Object, path As String)
    ' Initialize the AudioPlayer
    Private AudioPlayer As PuzzleTak_AudioPlayer
    Private callBack As Object
    callBack = call
    AudioPlayer.initialize("AudioPlayer")
    AudioPlayer.PathFile = path
    Log("StartMusic")
    
    ' Notify the caller about the audio byte data
    CallSub2(callBack, "onGetByteMusic", AudioPlayer.Byte)
    
    ' Check if an audio session is available
    If AudioPlayer.AudioSessionId <> -1 Then
        Log(AudioPlayer.AudioSessionId)
        
        ' Notify the caller about the audio session ID
        If IsPaused(callBack) == False Then CallSub2(callBack, "onGetAudioSession", AudioPlayer.AudioSessionId)
    End If
End Sub

  2. Event Handlers: The module includes various event handlers to monitor the audio playback status:

    • AudioPlayer_onBufferingUpdate(buffer As Int): Handles buffering updates.
    • AudioPlayer_onCompletion(): Handles audio playback completion.
    • AudioPlayer_onError(): Handles audio playback errors.
    • AudioPlayer_onInfo(p0 As Int, p1 As Int): Handles audio playback information updates.
    • AudioPlayer_onPrepared(): Handles audio player preparation.
    • AudioPlayer_onSeekComplete(): Handles seek operations completion.

    Customize these event handlers as needed for your application.

Handling Audio Data and Audio Session

The AudioPlayer module provides two important callback methods for handling audio data and audio session information.

onGetByteMusic(bytes() As Byte)

  • Description: This callback is triggered to provide the raw audio bytes to the SymmetricWaveVisualizer component for visualization or processing. It takes an array of bytes as a parameter, which represents the audio data.
  • Parameters:
    • bytes() As Byte: An array of bytes containing audio data.
  • Usage Example: 
    Private Sub onGetByteMusic(bytes() As Byte)
    SymmetricWaveVisualizer.RawAudioBytes = bytes
End Sub
Private Sub onGetAudioSession(sessionId As Int)
    SymmetricWaveVisualizer.AudioSessionId = sessionId
End Sub


## Example
Here's an example of how to use the `StartMusic` method to start audio playback:

```vbnet
Sub StartAudioPlayback()
	Dim sm As StoryMusic
	sm.Initialize(Me,"sm","dadadada","https://site.com/cover.png","https://site.com/file.mp3")
	Activity.AddView(sm.AsView,0,0,Activity.Width,Activity.Height)
	sm.initState
End Sub