Musicgy
Musicgy is a real-time music collaborative playback platform based on Next.js. It supports multiple people to join the same room to jointly search for Netease cloud music, add songs to the queue, and listen to them synchronously in real time.
- ** Multi-person collaboration **: Support multiple users online at the same time to jointly manage playback queues - ** Netease Cloud Music **: Integrate Netease Cloud Music API and search through massive music libraries - ** Real-time synchronization **: Real-time status management based on Redis, all users listen synchronously - ** Voting Skip **: Democratic voting mechanism, more than half of users can skip the current song if they agree - ** High sound quality support **: Automatically requests high-quality audio and supports lossless sound quality - ** User online status **: Real-time display of online user list and heartbeat detection - ** Queue management **: View the current playlist to learn about the songs that are about to play ####First use 1. ** Open a browser to access the assigned domain name ** 2. ** Enter the music room ** - The app will automatically assign you a user ID - Nicknames can be modified in settings (optional) 3. ** Search for music ** - Click the "Search" button in the upper right corner - Enter the song name, singer name, or album name - Select songs from search results to join the queue 4. ** Start playing ** - Playing automatically starts after adding a song - All online users listen to the same song simultaneously --- ###Function Description #### 1. music playback - ** Currently playing **: Display the song information, singer, and album cover being played - ** Progress bar **: Real-time synchronization of playback progress - ** Playback Queue **: View the list of songs that are about to be played #### 2. collaboration capabilities - ** Voting Skip **: Click the "Skip" button to vote, and more than half of the users agree to skip the current song - ** Online users **: Display the current number of online users in real time - ** User heartbeat **: Automatic offline after 60 seconds of no activity, automatic online after re-operation #### 3. Search and Add - ** Search Type **: Support searching for songs, albums, and singers - ** Add to Queue **: Click the "Add" button in the search results - ** Queue management **: Songs are played in the order they are added #### 4. Advanced features (optional) - ** Netease Cloud Login **: Log in to Netease Cloud account through QR code to unlock high-quality audio - ** Sound quality selection **: Automatically request lossless sound quality (you need to log in to Netease Cloud member account) --- ###Common Questions #### Q1: The song cannot be played, displaying "Loading" ** Reason **: Netease Cloud Music API may have returned restricted songs ** Solution **: 1. Wait for the system to automatically skip (about 3 seconds) 2. Or manually vote to skip the current song 3. Try searching and adding other songs --- #### Q2: Audio stuck or delayed ** Reason **: Insufficient network bandwidth or high concurrent access ** Solution **: 1. Check device network connection 2. Reduce the number of concurrent users (no more than 10 recommended) 3. If self-hosting, ensure server bandwidth ≥ 10Mbps --- #### Q3: Some songs could not be searched ** Reason **: - Netease Cloud Music API Copyright Restrictions - The song name is misspelled ** Solution **: 1. Try searching using the artist name or album name 2. Use more precise keywords 3. Some songs may require Netease Cloud membership. You can try logging in to your Netease Cloud account --- #### Q4: How to log in to Netease Cloud account? ** Steps **: 1. Click the "Sign in" button in the upper right corner of the application 2. Scan the QR code using mobile phone Netease Cloud Music APP 3. After successfully logging in, you can unlock more songs and high-quality audio
