streamify-audio 2.1.11 → 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.11",
+  "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

@@ -261,7 +261,19 @@ class Player extends EventEmitter {
             await this.connect();
         }
 
-        const startPosition = options.startPosition || options.seek || 0;
+        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);
@@ -269,7 +281,7 @@ class Player extends EventEmitter {
         }
 
         this.queue.setCurrent(track);
-        return this._playTrack(track, startPosition);
+        return this._playTrack(track, playOptions.startPosition);
     }
 
     async _playTrack(track, startPosition = 0) {