audio player

React/NextJS Audio Player

Демо: https://audioplayer.madza.dev

---

Требования

Node.js 18.x / 20+ требуется.

Протестировано на React 18.2.0 и Nextjs 14.1.0.

Установка

 npm install @ madzadev / audio - player 

Использование

 import Player from "@madzadev/audio-player" ;
import "@madzadev/audio-player/dist/index.css" ; 

 const tracks = [
  {
    url : "https://audioplayer.madza.dev/Madza-Chords_of_Life.mp3" ,
    title : "Madza - Chords of Life" ,
    tags : [ "house" ] ,
  } ,
  {
    url : "https://audioplayer.madza.dev/Madza-Late_Night_Drive.mp3" ,
    title : "Madza - Late Night Drive" ,
    tags : [ "dnb" ] ,
  } ,
  {
    url : "https://audioplayer.madza.dev/Madza-Persistence.mp3" ,
    title : "Madza - Persistence" ,
    tags : [ "dubstep" ] ,
  } ,
] ; 

 < Player trackList = { tracks } />

Единственная обязательная опора - trackList для источника аудио.

Требуется пройти в массиве, состоящем из объектов с url , title и tags .

Параметры

Есть несколько дополнительных реквизитов, которые вы можете использовать для настройки игрока.

Значения по умолчанию отображаются ниже.

 < Player
  trackList = { tracks }
  includeTags = { true }
  includeSearch = { true }
  showPlaylist = { true }
  sortTracks = { true }
  autoPlayNextTrack = { true }
/> 

Цветовые схемы

Вы можете настроить дизайн игрока, редактируя объект colors ниже.

Включите только эти свойства, которые вы хотите настроить.

 const colors = {
  tagsBackground : "#3e32e4" ,
  tagsText : "#ffffff" ,
  tagsBackgroundHoverActive : "#6e65f1" ,
  tagsTextHoverActive : "#ffffff" ,
  searchBackground : "#18191f" ,
  searchText : "#ffffff" ,
  searchPlaceHolder : "#575a77" ,
  playerBackground : "#18191f" ,
  titleColor : "#ffffff" ,
  timeColor : "#ffffff" ,
  progressSlider : "#3e32e4" ,
  progressUsed : "#ffffff" ,
  progressLeft : "#151616" ,
  bufferLoaded : "#1f212b" ,
  volumeSlider : "#3e32e4" ,
  volumeUsed : "#ffffff" ,
  volumeLeft : "#151616" ,
  playlistBackground : "#18191f" ,
  playlistText : "#575a77" ,
  playlistBackgroundHoverActive : "#18191f" ,
  playlistTextHoverActive : "#ffffff" ,
} ; 

 < Player trackList = { tracks } customColorScheme = { colors } /> 

Окончательные примечания

Аудиофайлы могут храниться и доступны как локально в вашем проекте через путь файла (например, public/yourtrack.mp3 ), либо с использованием внешнего хоста и предоставления прямых URL -адресов источника (например, https://website.com/yourtrack.mp3 ).

Этот проект находится под лицензией MIT, так что будьте свободны проверить его и внести свой вклад!