Playback controls

Controls are asynchronous because they talk to Remedia. Await them before you reply to a user.

const queue = player.getQueue(guildId);

if (!queue) return;

await queue.node.pause();
await queue.node.resume();
await queue.node.seek(60_000); // Milliseconds
await queue.node.setVolume(75); // 0 to 200 percent

Skip, stop, and leaveCopy Anchor Link

Use these queue methods for commands. queue.node.stopSession() and queue.node.play(source) control the audio session directly and bypass the queue.

Read the positionCopy Anchor Link

const elapsed = queue.node.playbackTime; // milliseconds
const duration = queue.node.totalDuration; // milliseconds
const timestamp = queue.node.getTimestamp(); // { current, total, progress } or null
const bar = queue.node.createProgressBar({ length: 20 });

getTimestamp() returns null when the track has no known duration, such as a live stream.

playbackTime is the time Remedia has played, not the position inside the source file. It restarts at zero for each new track and after a seek, which sets it to the seek target. With a filter that changes speed, such as nightcore, it advances faster or slower than the file position. progress is capped at 100.

SeekCopy Anchor Link

await queue.node.seek(90_000);

Whether a seek works depends on the source:

• Files and URLs usually support seeking.
• Plugin sources on a remote node can only seek forward. A backward seek is rejected.
• A source with an unknown duration may reject a seek.

Handle the rejection and tell the user:

try {
  await queue.node.seek(positionMs);
} catch (error) {
  await interaction.reply('This track does not support seeking there.');
}

VolumeCopy Anchor Link

setVolume() takes a percentage from 0 to 200. The default is 100. You can also set it when connecting:

await queue.connect({ channelId, volume: 70 });

While crossfadingCopy Anchor Link

During a crossfade, currentTrack is the incoming track. Skip, seek, and stop apply to it. See crossfade.