Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: Buffering preserved and released types #176

Merged
merged 16 commits into from
Feb 13, 2025
Merged

feat: Buffering preserved and released types #176

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
ab26a7d
added `BufferingType` to free memory while playing
alnitak Feb 5, 2025
4459894
added maxBufferSizeDuration to setBufferStream()
alnitak Feb 6, 2025
3a48192
update CHANGELOG
alnitak Feb 6, 2025
91676fd
example chore
alnitak Feb 6, 2025
3713a47
++
alnitak Feb 6, 2025
e4d1a77
removed deprecated js_util
alnitak Feb 13, 2025
37714af
removed test fixes
alnitak Feb 13, 2025
8f6b284
removed deprecated `filter_params.dart`
alnitak Feb 13, 2025
3575e21
check if Web Worker has been already created
alnitak Feb 13, 2025
d572267
removed `initialized` getter in favor of `isInitialized`
alnitak Feb 13, 2025
99f85d8
update settings.gradle of example
alnitak Feb 13, 2025
916f3e9
fix
alnitak Feb 13, 2025
a8e2a53
removed issue_tracker from pubspec
alnitak Feb 13, 2025
790573e
bump verison
alnitak Feb 13, 2025
4d868cf
Merge branch 'main' into bufferingType
alnitak Feb 13, 2025
f4605be
update README
alnitak Feb 13, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .vscode/launch.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
"name": "Flutter debug",
"type": "dart",
"request": "launch",
"program": "lib/audio_data/audio_data.dart",
"program": "lib/buffer_stream/websocket.dart",
"flutterMode": "debug",
"cwd": "${workspaceFolder}/example"
},
Expand Down
2 changes: 1 addition & 1 deletion .vscode/tasks.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
},
{
"label": "compile linux debug",
"command": "cd ${workspaceFolder}/example; flutter build linux -t lib/test.dart --debug",
"command": "cd ${workspaceFolder}/example; flutter build linux -t lib/buffer_stream/websocket.dart --debug",
"type": "shell"
},
{
Expand Down
12 changes: 8 additions & 4 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,13 @@

### 3.0.0-pre.2 ()
### 3.0.0 (13 Feb 2025)
- `BufferStream` now supports 2 type of buffering:
- `BufferingType.preserved` (default): preserve the data already in the buffer while playing.
- `BufferingType.released`: free the memory of the already played data for longer playback.
- breaking change: splitted [maxBufferSize] to [maxBufferSizeBytes] and [maxBufferSizeDuration] in `SoLoud.setBufferStream`. This gives the user a way to choose the maximum buffer size using bytes or time.
- breaking change: removed `initialized` getter in favor of `isInitialized`
- removed deprecated `timeout` parameter in `SoLoud.init`.
- removed deprecated `filter_params.dart`.
- fixed biquad resonant filter `frequency` default parameter #179
- fix: on some unclear conditions `isInitialized` returning false on MacOS after engine starts with no error #177

### 3.0.0-pre.1 (3 Feb 2025)
- fix: Call `loadMem` will crash the application #174.

### 3.0.0-pre.0 (2 Feb 2025)
Expand Down
6 changes: 6 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,12 @@ On Linux and MacOS theese libraries must be installed if you want to use this ki

if the libraries are not found the plugin will throw an exception when calling `setBufferStream` using Opus format.

The `SoLoud.setBufferStream` supports also `BufferingType.preserved` which behaves the same as a normal `AudioSource`, and `BufferingType.released` which will free the memory of the already played audio for longer playback. The latter will accept to play only one instance of the audio stream at the same time.
|BufferingType.preserved|BufferingType.released|
|------------------------------------|----------------------------------|
|![preserved](https://github.com/user-attachments/assets/e8699bfd-2a40-4832-a7a8-d729d844c48b)|![released](https://github.com/user-attachments/assets/7eb57688-ab0f-4859-813f-d23fff6ca10f)|
|acts as normal leaving the whole audio data available for future re-play|while playing the already listened audio is freed. It can be listened to only once and the sound must be manually disposed|

#### Web platform
To use this plugin on the **Web platform**, please add the following scripts to the `<head>` or `<body>` section of your `index.html`:
```
Expand Down
Empty file added example/android/app/.cxx/Debug/5p4b6b24/arm64-v8a/.cmake/api/v1/query/client-agp/cache-v2
View file
Open in desktop
Empty file.
Empty file added ...le/android/app/.cxx/Debug/5p4b6b24/arm64-v8a/.cmake/api/v1/query/client-agp/cmakeFiles-v1
View file
Open in desktop
Empty file.
Empty file added ...ple/android/app/.cxx/Debug/5p4b6b24/arm64-v8a/.cmake/api/v1/query/client-agp/codemodel-v2
View file
Open in desktop
Empty file.
Loading