streamify-audio 2.1.10 → 2.1.12

package/docs/discord/player.md

@@ -14,7 +14,7 @@ const player = manager.get(guildId);
 
 ## Playback Methods
 
-### play(track)
+### play(track, options?)
 
 Plays a track immediately. If something is playing, adds to queue and skips.
 
@@ -23,6 +23,29 @@ const result = await manager.search('never gonna give you up');
 await player.play(result.tracks[0]);
 ```
 
+**Options:**
+- `startPosition` - Start playback at a specific position in milliseconds
+- `volume` - Set volume before playing (0-200)
+- `filters` - Apply filters before playing
+
+```javascript
+// Start playing at 30 seconds
+await player.play(track, { startPosition: 30000 });
+
+// Start with specific volume
+await player.play(track, { volume: 50 });
+
+// Start with filters applied
+await player.play(track, { filters: { bass: 10, nightcore: true } });
+
+// Combine options (useful for session restoration)
+await player.play(track, {
+    startPosition: savedPositionMs,
+    volume: savedVolume,
+    filters: savedFilters
+});
+```
+
 ### pause()
 
 Pauses playback and destroys the stream to save resources.

package/index.d.ts

@@ -237,6 +237,13 @@ declare module 'streamify-audio' {
         on(event: 'playerDestroy', listener: (player: Player) => void): this;
     }
 
+    export interface PlayOptions {
+        startPosition?: number;
+        seek?: number;
+        volume?: number;
+        filters?: Filters;
+    }
+
     export class Player extends EventEmitter {
         constructor(manager: Manager, options: any);
 
@@ -261,7 +268,7 @@ declare module 'streamify-audio' {
         disconnect(): boolean;
         destroy(): void;
 
-        play(track: Track): Promise<void>;
+        play(track: Track, options?: PlayOptions): Promise<void>;
         pause(destroyStream?: boolean): boolean;
         resume(): Promise<boolean>;
         skip(): Promise<Track | null>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "streamify-audio",
-  "version": "2.1.10",
+  "version": "2.1.12",
   "description": "Dual-mode audio library: HTTP streaming proxy + Discord player (Lavalink alternative). Supports YouTube, Spotify, SoundCloud with audio filters.",
   "main": "index.js",
   "types": "index.d.ts",

package/src/discord/Player.js

@@ -252,7 +252,7 @@ class Player extends EventEmitter {
         });
     }
 
-    async play(track) {
+    async play(track, options = {}) {
         if (this._destroyed) {
             throw new Error('Player has been destroyed');
         }
@@ -261,19 +261,34 @@ class Player extends EventEmitter {
             await this.connect();
         }
 
+        const playOptions = {
+            startPosition: options.startPosition || options.seek || 0,
+            volume: options.volume,
+            filters: options.filters
+        };
+
+        if (options.volume !== undefined) {
+            this._volume = Math.max(0, Math.min(200, options.volume));
+        }
+
+        if (options.filters) {
+            this._filters = { ...this._filters, ...options.filters };
+        }
+
         if (this.queue.current) {
             this.queue.add(track, 0);
             return this.skip();
         }
 
         this.queue.setCurrent(track);
-        return this._playTrack(track);
+        return this._playTrack(track, playOptions.startPosition);
     }
 
-    async _playTrack(track) {
+    async _playTrack(track, startPosition = 0) {
         if (!track) return;
 
-        log.info('PLAYER', `Playing: ${track.title} (${track.id})`);
+        const seekInfo = startPosition > 0 ? ` @ ${Math.floor(startPosition / 1000)}s` : '';
+        log.info('PLAYER', `Playing: ${track.title} (${track.id})${seekInfo}`);
         this.emit('trackStart', track);
 
         try {
@@ -282,7 +297,7 @@ class Player extends EventEmitter {
                 volume: this._volume
             };
 
-            if (this._prefetchedTrack?.id === track.id && this._prefetchedStream) {
+            if (startPosition === 0 && this._prefetchedTrack?.id === track.id && this._prefetchedStream) {
                 log.info('PLAYER', `Using prefetched stream for ${track.id}`);
                 this.stream = this._prefetchedStream;
                 this._prefetchedStream = null;
@@ -292,12 +307,12 @@ class Player extends EventEmitter {
                 this.stream = createStream(track, filtersWithVolume, this.config);
             }
 
-            const resource = await this.stream.create();
+            const resource = await this.stream.create(startPosition);
 
             this.audioPlayer.play(resource);
             this._playing = true;
             this._paused = false;
-            this._positionMs = 0;
+            this._positionMs = startPosition;
             this._positionTimestamp = Date.now();
 
             this._prefetchNext();