1.0.0 • Published 1 year ago
frosty-audio-player v1.0.0
Frosty Media Player UX Components
Frosty Media Player UX Components allows you to easily create your own music player, minting site, or music marketplace with Frosty infrastructure.
This library works alongside the Frosty minting studio allows for DAOs and individuals to run their own decentralized record labels. Arbitrary music NFTs across a wide variety of contract implementations are supported.
Main components:
<AudioPlayer />
- play / pause button.
<PersistentPlayer />
- full play bar.
Quickstart
- Add package:
yarn add frosty-audio-player
⏯️ frosty-audio-player 🎧
- example: frosty-audio-player
2 options:
<AudioPlayer />
- single track controls.<PersistentPlayer />
- full-width playbar with playlists.
Usage
- Add Providers:
import { useReducer } from "react";
import {
DispatchPlayerContext,
PlayerContext,
playerInitialState,
playerReducer,
} from "frosty-audio-player";
const App = ({ Component, pageProps }: AppProps) => {
const [state, dispatch] = useReducer(playerReducer, playerInitialState);
return (
<PlayerContext.Provider value={state}>
<DispatchPlayerContext.Provider value={dispatch}>
<Component {...pageProps} />
</DispatchPlayerContext.Provider>
</PlayerContext.Provider>
);
};
- Render a simple Audio Player:
import { AudioPlayer } from "frosty-audio-player";
export const Page = () => (
<AudioPlayer
size={56}
audioSrc="https://nftstorage.link/ipfs/QmWNaSdhXq2WdusiBcVC2Ju5A1JJySRDVNrQMEBGcaazvC"
callbackAfterPlay={console.log}
active
/>
);
- Render a full Persistent Player:
import { AudioPlayer } from "frosty-audio-player";
const PLAYLIST = [
{
songUrl:
"https://nftstorage.link/ipfs/bafybeihxtxizfgtp5nazudkuc6dvtru2rykyklsse7t5r3rquydirgunxy/SHINY_7.wav",
project: "shiny",
artist: "kat dahlia",
website: "https://github.com/mrcryptofrosty",
image:
"https://nftstorage.link/ipfs/QmVJBGbMXHNyBe62ruPByK5MG6KdbZkSGPiBMfpqRQ6qP2",
},
{
songUrl:
"https://nftstorage.link/ipfs/bafybeid3su3rqfwj7ydk52coz3xinku5vc7uu557t7rdkxx5dswcbxolda",
project: "rugburn by sad alex",
artist: "sad alex & chillpill",
website: "https://github.com/mrcryptofrosty",
image:
"https://nftstorage.link/ipfs/bafybeif55mfehhzipicowg7fpdvdmgulwk6jgz2pbbxwuxjt7pmr7swlvu",
},
];
export const Page = () => {
return <PersistentPlayer playlist={PLAYLIST} />;
};
Props
<AudioPlayer />
size
- size of Audio Player.audioSrc
- src of audio.callbackAfterPlay
- function to call after track begins playing.active
- flag for pre-released tracks to be unplayable / disabled.
<PersistentPlayer />
playlist
- Array of SongsSong[]
.
Song
export type Song = {
songUrl: string;
project: string;
artist?: string;
website?: string;
image: string;
};