flet-audio 0.85.2__tar.gz → 0.85.3.dev0__tar.gz

{flet_audio-0.85.2/src/flet_audio.egg-info → flet_audio-0.85.3.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet-audio
-Version: 0.85.2
+Version: 0.85.3.dev0
 Summary: Provides audio integration and playback in Flet apps.
 Author-email: Flet contributors <hello@flet.dev>
 License-Expression: Apache-2.0
@@ -11,7 +11,7 @@ Project-URL: Issues, https://github.com/flet-dev/flet/issues
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: flet==0.85.2
+Requires-Dist: flet==0.85.3.dev0
 Dynamic: license-file
 
 # flet-audio

{flet_audio-0.85.2 → flet_audio-0.85.3.dev0}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "flet-audio"
-version = "0.85.2"
+version = "0.85.3.dev0"
 description = "Provides audio integration and playback in Flet apps."
 readme = "README.md"
 authors = [{ name = "Flet contributors", email = "hello@flet.dev" }]
 license = "Apache-2.0"
 requires-python = ">=3.10"
 dependencies = [
-    "flet==0.85.2",
+    "flet==0.85.3.dev0",
 ]
 
 [project.urls]

{flet_audio-0.85.2 → flet_audio-0.85.3.dev0}/src/flet_audio/audio.py

@@ -107,6 +107,7 @@ class Audio(ft.Service):
 
         Args:
             position: The position to start playback from.
+                Defaults to the beginning of the audio.
         """
         await self._invoke_method(
             method_name="play",

flet_audio-0.85.3.dev0/src/flet_audio/types.py

@@ -0,0 +1,119 @@
+from dataclasses import dataclass
+from enum import Enum
+from typing import TYPE_CHECKING
+
+import flet as ft
+
+if TYPE_CHECKING:
+    from flet_audio.audio import Audio  # noqa
+
+__all__ = [
+    "AudioDurationChangeEvent",
+    "AudioPositionChangeEvent",
+    "AudioState",
+    "AudioStateChangeEvent",
+    "ReleaseMode",
+]
+
+
+class ReleaseMode(Enum):
+    """
+    Determines what happens to the player's resources (the buffered audio and
+    the underlying native player) when playback finishes or is stopped, and
+    therefore how quickly, and at what cost, the same audio can be played again.
+    """
+
+    RELEASE = "release"
+    """
+    Frees all resources once playback completes, as if
+    :meth:`flet_audio.Audio.release` had been called automatically.
+    This is the default mode.
+
+    The buffered audio and the native player are released, so nothing is kept in
+    memory while the audio is idle. Playing again is still supported, but the
+    source is **loaded again from scratch** first (and a remote file is
+    re-downloaded), which adds a short delay before playback starts.
+
+    Best when replays are rare or may never happen and keeping memory usage to a
+    minimum matters.
+
+    Note:
+        - On Android, the native media player is resource-intensive; this mode
+            lets it go and re-buffers the data only when needed.
+        - On iOS and macOS, behaves like :meth:`flet_audio.Audio.release`.
+    """
+
+    LOOP = "loop"
+    """
+    Automatically restarts playback from the beginning every time it completes,
+    creating a continuous loop. All resources are kept buffered.
+
+    Best for audio that should repeat indefinitely, such as background music.
+
+    Note:
+        Resources are never released automatically in this mode. To free them,
+        change the source or call :meth:`flet_audio.Audio.release`.
+    """
+
+    STOP = "stop"
+    """
+    Stops playback when the audio completes but keeps all resources (the
+    buffered audio and the native player) intact.
+
+    Because nothing is released, playing again is **immediate**: the audio
+    restarts straight from the retained buffer, with no reloading or
+    re-downloading. The trade-off is that these resources stay in memory while
+    the audio is idle.
+
+    Best when you intend to replay the same audio and want instant,
+    network-free playback (for example, short sound effects or repeated tones).
+    """
+
+
+class AudioState(Enum):
+    """The state of the audio player."""
+
+    STOPPED = "stopped"
+    """The audio player is stopped."""
+
+    PLAYING = "playing"
+    """The audio player is currently playing audio."""
+
+    PAUSED = "paused"
+    """The audio player is paused and can be resumed."""
+
+    COMPLETED = "completed"
+    """The audio player has successfully reached the end of the audio."""
+
+    DISPOSED = "disposed"
+    """The audio player has been disposed of and should not be used anymore."""
+
+
+@dataclass
+class AudioStateChangeEvent(ft.Event["Audio"]):
+    """
+    Event triggered when the audio playback state changes.
+    """
+
+    state: AudioState
+    """The current state of the audio player."""
+
+
+@dataclass
+class AudioPositionChangeEvent(ft.Event["Audio"]):
+    """
+    Event triggered when the audio playback position changes.
+    """
+
+    position: int
+    """The current playback position in milliseconds."""
+
+
+@dataclass
+class AudioDurationChangeEvent(ft.Event["Audio"]):
+    """
+    Event triggered when the audio duration changes.
+    """
+
+    duration: ft.Duration
+    """The duration of the audio."""

{flet_audio-0.85.2 → flet_audio-0.85.3.dev0/src/flet_audio.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet-audio
-Version: 0.85.2
+Version: 0.85.3.dev0
 Summary: Provides audio integration and playback in Flet apps.
 Author-email: Flet contributors <hello@flet.dev>
 License-Expression: Apache-2.0
@@ -11,7 +11,7 @@ Project-URL: Issues, https://github.com/flet-dev/flet/issues
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: flet==0.85.2
+Requires-Dist: flet==0.85.3.dev0
 Dynamic: license-file
 
 # flet-audio

flet_audio-0.85.3.dev0/src/flet_audio.egg-info/requires.txt

@@ -0,0 +1 @@
+flet==0.85.3.dev0

{flet_audio-0.85.2 → flet_audio-0.85.3.dev0}/src/flutter/flet_audio/lib/src/audio.dart

@@ -85,20 +85,14 @@ class AudioService extends FletService {
         _src = resolvedSrc.uri;
         _srcBytes = null;
         srcChanged = true;
-
-        var assetSrc = control.backend.getAssetSource(_src!);
-        if (assetSrc.isFile) {
-          await player.setSourceDeviceFile(assetSrc.path);
-        } else {
-          await player.setSourceUrl(assetSrc.path);
-        }
+        await _applySource();
       } else if (resolvedSrc.bytes != null &&
           (_srcBytes == null || !listEquals(_srcBytes, resolvedSrc.bytes))) {
         // bytes
         _srcBytes = resolvedSrc.bytes;
         _src = null;
         srcChanged = true;
-        await player.setSourceBytes(resolvedSrc.bytes!);
+        await _applySource();
       }
 
       if (srcChanged) {
@@ -136,12 +130,42 @@ class AudioService extends FletService {
     }();
   }
 
+  /// Pushes the currently tracked source ([_src] or [_srcBytes]) to the native
+  /// [player], preparing it for playback.
+  ///
+  /// Used both when the source changes (from [update]) and to re-prepare
+  /// playback after the player has reached [PlayerState.completed] under
+  /// [ReleaseMode.release], where the native source has already been freed.
+  Future<void> _applySource() async {
+    if (_src != null) {
+      final assetSrc = control.backend.getAssetSource(_src!);
+      if (assetSrc.isFile) {
+        await player.setSourceDeviceFile(assetSrc.path);
+      } else {
+        await player.setSourceUrl(assetSrc.path);
+      }
+    } else if (_srcBytes != null) {
+      await player.setSourceBytes(_srcBytes!);
+    }
+  }
+
   Future<dynamic> _invokeMethod(String name, dynamic args) async {
     debugPrint("Audio.$name($args)");
     switch (name) {
       case "play":
         final position = parseDuration(args["position"]);
-        if (position != null) {
+        if (player.state == PlayerState.completed) {
+          // Playback finished. Under ReleaseMode.release the native source has
+          // been freed, so re-prepare it before resuming.
+          if ((_releaseMode ?? ReleaseMode.release) == ReleaseMode.release) {
+            await _applySource();
+          }
+          // Position is already reset to the start after completion, so only
+          // seek when a specific non-zero position was requested.
+          if (position != null && position > Duration.zero) {
+            await player.seek(position);
+          }
+        } else if (position != null) {
           await player.seek(position);
         }
         await player.resume();
@@ -158,6 +182,12 @@ class AudioService extends FletService {
       case "seek":
         final position = parseDuration(args["position"]);
         if (position != null) {
+          if (player.state == PlayerState.completed &&
+              (_releaseMode ?? ReleaseMode.release) == ReleaseMode.release) {
+            // Source was freed on completion (see "play"); re-prepare it,
+            // otherwise the seek would hang waiting for onSeekComplete.
+            await _applySource();
+          }
           await player.seek(position);
         }
         break;

flet_audio-0.85.2/src/flet_audio/types.py

@@ -1,94 +0,0 @@
-from dataclasses import dataclass
-from enum import Enum
-from typing import TYPE_CHECKING
-
-import flet as ft
-
-if TYPE_CHECKING:
-    from flet_audio.audio import Audio  # noqa
-
-__all__ = [
-    "AudioDurationChangeEvent",
-    "AudioPositionChangeEvent",
-    "AudioState",
-    "AudioStateChangeEvent",
-    "ReleaseMode",
-]
-
-
-class ReleaseMode(Enum):
-    """The behavior of Audio player when an audio is finished or stopped."""
-
-    RELEASE = "release"
-    """
-    Releases all resources, just like calling release method.
-
-    Info:
-        - On Android, the media player is quite resource-intensive, and this will
-            let it go. Data will be buffered again when needed (if it's a remote file,
-            it will be downloaded again).
-        - On iOS and macOS, works just like
-            :meth:`flet_audio.Audio.release` method.
-    """
-
-    LOOP = "loop"
-    """
-    Keeps buffered data and plays again after completion, creating a loop.
-    Notice that calling stop method is not enough to release the resources
-    when this mode is being used.
-    """
-
-    STOP = "stop"
-    """
-    Stops audio playback but keep all resources intact.
-    Use this if you intend to play again later.
-    """
-
-
-class AudioState(Enum):
-    """The state of the audio player."""
-
-    STOPPED = "stopped"
-    """The audio player is stopped."""
-
-    PLAYING = "playing"
-    """The audio player is currently playing audio."""
-
-    PAUSED = "paused"
-    """The audio player is paused and can be resumed."""
-
-    COMPLETED = "completed"
-    """The audio player has successfully reached the end of the audio."""
-
-    DISPOSED = "disposed"
-    """The audio player has been disposed of and should not be used anymore."""
-
-
-@dataclass
-class AudioStateChangeEvent(ft.Event["Audio"]):
-    """
-    Event triggered when the audio playback state changes.
-    """
-
-    state: AudioState
-    """The current state of the audio player."""
-
-
-@dataclass
-class AudioPositionChangeEvent(ft.Event["Audio"]):
-    """
-    Event triggered when the audio playback position changes.
-    """
-
-    position: int
-    """The current playback position in milliseconds."""
-
-
-@dataclass
-class AudioDurationChangeEvent(ft.Event["Audio"]):
-    """
-    Event triggered when the audio duration changes.
-    """
-
-    duration: ft.Duration
-    """The duration of the audio."""

flet_audio-0.85.2/src/flet_audio.egg-info/requires.txt

@@ -1 +0,0 @@
-flet==0.85.2