Skip to main content

Recipes

Let the React provider manage integrations​

import { createLocalStoragePersistenceAdapter } from "@yetric/audioplayer";
import { AudioPlayerProvider } from "@yetric/audioplayer/react";

export const App = () => (
<AudioPlayerProvider
persistence={{ adapter: createLocalStoragePersistenceAdapter("audio-player") }}
mediaSession
progressReporter={{ intervalMs: 5000, onReport: (snapshot) => console.log(snapshot) }}>
<PlayerScreen />
</AudioPlayerProvider>
);

The provider restores saved state without autoplay and cleans up integrations on unmount. Keep queue setup separate from automatic restore so it does not overwrite a restored queue. See the React guide for option lifetimes and state selectors.

Relative seek controls​

const player = useAudioPlayer();
const controls = <>
<button onClick={() => player.skip(-10)}>Back 10 seconds</button>
<button onClick={() => player.skip(30)}>Forward 30 seconds</button>
</>;

skip uses seconds and clamps at zero and, once metadata is available, the duration. For a timeline without polling, use useAudioPlayerProgress.

Convert a podcast episode into AudioSource​

const toAudioSource = (episode, podcast) => ({
id: episode.id.toString(),
src: episode.url,
title: episode.title,
artist: podcast.name,
artwork: podcast.imageUrl,
album: podcast.name,
});

Keep one queue for the whole app​

await player.setQueue(episodes.map((episode) => toAudioSource(episode, podcast)), {
startAtId: activeEpisodeId,
autoplay: true,
});

Use progress for a slider​

player.subscribe((state) => {
slider.value = String(state.progress.playedFraction * 100);
});

Handle errors in UI​

player.subscribe((state) => {
if (!state.error) {
hideError();
return;
}

showError(state.error.message);
});

Handle first play vs resume​

if (player.getState().currentSourceId === source.id) {
await player.play();
} else {
await player.play(source);
}