MusicFree音樂播放器用起來更加的個(gè)性化，您可以自由的添加各種js插件，使得您的播放器變得更加強(qiáng)大，作者默認(rèn)就制作了很多插件，您可以參考下方的教程進(jìn)行安裝！

MusicFree官方簡介

一個(gè)插件化、定制化、無廣告的免費(fèi)音樂播放器，目前只支持Android和Harmony OS。

MusicFree安卓客戶端特色

插件化：本軟件僅僅是一個(gè)播放器，本身并不集成任何平臺的任何音源，所有的搜索、播放、歌單導(dǎo)入等功能全部基于插件。這也就意味著，只要可以在互聯(lián)網(wǎng)上搜索到的音源，只要有對應(yīng)的插件，你都可以使用本軟件進(jìn)行搜索、播放等功能。關(guān)于插件的詳細(xì)說明請看插件一節(jié)。

歌詞關(guān)聯(lián)：你可以把兩首歌的歌詞關(guān)聯(lián)起來，比如將歌曲A的歌詞關(guān)聯(lián)到歌曲B，關(guān)聯(lián)后A、B兩首歌都將顯示歌曲B的歌詞。你也可以關(guān)聯(lián)多首歌的歌詞，如A->B->C，這樣A、B、C三首歌都將顯示C的歌詞。

定制化、無廣告：本軟件提供了淺色、深色模式；支持自定義背景；本軟件基于GPL協(xié)議開源，一個(gè)star做交易 將會(huì)保持免費(fèi)。

插件支持的功能：搜索（音樂、專輯、作者）、播放、查看專輯、查看作者詳細(xì)信息、導(dǎo)入單曲、導(dǎo)入歌單、獲取歌詞等。

隱私：所有的數(shù)據(jù)都存儲在本地，本軟件不會(huì)收集你的任何個(gè)人信息。

插件使用教程

下載app之后，只需要在側(cè)邊欄設(shè)置-插件設(shè)置中安裝插件即可。支持安裝本地插件和從網(wǎng)絡(luò)安裝插件（支持解析。js文件和。json描述文件；已經(jīng)寫了幾個(gè)示意的插件：指路這個(gè)倉庫，不過可能功能不是很完善）； 你可以直接點(diǎn)擊從網(wǎng)絡(luò)安裝插件，然后輸入MusicFree音樂源https://gitee.com/maotoumao/MusicFreePlugins/raw/master/plugins.json ，點(diǎn)擊確認(rèn)即可安裝。

常見問題

遇到“播放一首歌就停止”的情況？

檢查一下系統(tǒng)設(shè)置中 “后臺運(yùn)行” 權(quán)限是否打開；如果是未授予權(quán)限，打開權(quán)限后重啟app應(yīng)該就好了

音樂下載路徑在哪里？

Android/data/fun.upup.musicfree/files/download/music

本地音樂導(dǎo)入之后為空？

1. 可能沒有給讀取存儲的權(quán)限

2. 目前導(dǎo)入本地音樂只支持mp3格式

歌曲id是什么？

點(diǎn)擊歌曲詳情按鈕，拉起歌曲詳情浮層，第一行就是歌曲id，點(diǎn)擊即可復(fù)制。

插件怎么找？

目前已有的插件都是自己寫的，可以參考這個(gè)倉庫：

https://github.com/maotoumao/MusicFreePlugins；你也可以按照插件開發(fā)文檔（待補(bǔ)充）自行開發(fā)任意源的插件。

插件能不能搜索VIP音樂 / 支持xxx軟件？

上述倉庫下的插件為示例插件，本質(zhì)上只是基于網(wǎng)絡(luò)公開的接口做的封裝；沒有任何VIP破解/收費(fèi)音樂破解/軟件解包的功能，并且會(huì)過濾掉VIP/僅供試聽的音樂。以后也不會(huì)提供破解相關(guān)功能。

為什么插件只有部分源有導(dǎo)入功能？

插件沒寫完整，后續(xù)補(bǔ)充完整之后直接在側(cè)邊欄更新即可。

為什么導(dǎo)入某源的歌單后，提示“目標(biāo)歌單為空”？

1. 部分源的默認(rèn)歌單不支持導(dǎo)入，可以先復(fù)制到新歌單，再導(dǎo)入新歌單即可；

2. 導(dǎo)入時(shí)有一些隱含規(guī)則，歌單URL滿足特定正則時(shí)可以正常導(dǎo)入（后續(xù)完善插件規(guī)則就好了）；如果遇到這種情況，可以升級對應(yīng)軟件的客戶端版本嘗試一下

選擇音質(zhì)、導(dǎo)入無損音樂？

導(dǎo)入無損音樂暫時(shí)有點(diǎn)問題，在改了在改了。音質(zhì)相關(guān)，會(huì)盡快完善插件協(xié)議。

是否收費(fèi)/有收費(fèi)計(jì)劃？

開源項(xiàng)目，僅供學(xué)習(xí)參考使用，始終會(huì)保持免費(fèi)。請不要用于任何商業(yè)用途，使用過程中可能產(chǎn)生的版權(quán)數(shù)據(jù)與app無關(guān)，請及時(shí)自行刪除。

更新日志

v0.2.1

【功能】支持webdav備份&播放

【功能】插件榜單詳情支持分頁

【功能】插件支持顯示作者

【功能】側(cè)邊欄新增“權(quán)限管理”設(shè)置

【功能】首頁&歌詞頁樣式改版：新增歌詞進(jìn)度調(diào)整、歌詞大小調(diào)整、歌詞翻譯、自動(dòng)搜索歌詞

【功能】新增收藏歌單功能

【功能】音樂播放欄支持左右滑動(dòng)切歌（可能會(huì)閃一下，后續(xù)修掉）

【功能】新增“通知欄顯示關(guān)閉按鈕”設(shè)置

【優(yōu)化】統(tǒng)一浮層、toast樣式

【優(yōu)化】重構(gòu)播放、數(shù)據(jù)存儲邏輯

【優(yōu)化】去除插件url必須以.js結(jié)尾的限制

【修復(fù)】修改無限列表到底不觸發(fā)onendreached的問題(感謝@282931)

【修復(fù)】修復(fù)播放記錄退出后被清空的問題

【修復(fù)】修復(fù)標(biāo)題欄背景色透明度不生效的問題

【修復(fù)】修復(fù)部分情況下深色模式異常的問題

v0.1.2

【功能】新增桌面歌詞功能，可在設(shè)置頁開啟（開啟之前需要去手機(jī)設(shè)置授予懸浮窗權(quán)限）

【功能】新增插件設(shè)置：打開軟件時(shí)自動(dòng)更新插件、安裝插件時(shí)不校驗(yàn)版本

【功能】新增播放設(shè)置：打開軟件時(shí)自動(dòng)播放歌曲

【功能】可以使用musicfree打開本地.js或.mp3文件；其中.js文件會(huì)被當(dāng)作插件安裝；.mp3文件會(huì)直接播放

【功能】插件頁新增開關(guān)，可以控制是否在榜單、熱門歌單、搜索結(jié)果中展示對應(yīng)插件的結(jié)果

【功能】插件協(xié)議新增“用戶變量”，可以在插件中獲取app輸入的配置（可以由此實(shí)現(xiàn)自建音樂源的插件/webdav源插件，但是還沒寫）

【優(yōu)化】下載單曲支持選擇音質(zhì)

【優(yōu)化】側(cè)邊欄新增“返回桌面”按鈕

【優(yōu)化】新增“關(guān)聯(lián)歌詞方式”設(shè)置，如果設(shè)置為“輸入歌曲id”，則會(huì)恢復(fù)老版本關(guān)聯(lián)歌詞，即輸入id關(guān)聯(lián)歌詞

【修復(fù)】修復(fù)榜單、推薦歌單、搜索歌詞頁白屏閃退的問題(感謝@282931)

【修復(fù)】修復(fù)自定義背景模糊度和透明度無法設(shè)置為0的問題(感謝@282931)

【修復(fù)】修復(fù)無法恢復(fù)桌面版導(dǎo)出的歌單的問題

【修復(fù)】修復(fù)淺色主題狀態(tài)欄表現(xiàn)錯(cuò)誤的問題

【修復(fù)】修復(fù)歌單批量編輯無法刪除的問題

v0.1.0-alpha.1

【功能】插件更新，升級到新版本之后原有插件完全不兼容；更新后卸載原有插件，然后更新訂閱即可（具體看公眾號示例）

【功能】重寫了插件訂閱的邏輯，現(xiàn)在應(yīng)該會(huì)更合理一點(diǎn)點(diǎn)

【功能】刪除本地文件之前增加二次確認(rèn)提醒

【功能】新增功能“倍速播放”

【功能】增加了一些無關(guān)緊要的分享

【樣式】換了個(gè)logo，丑的更直白一些

【樣式】專輯描述文字默認(rèn)6行，點(diǎn)擊可以展開或折疊

【樣式】調(diào)整了一些樣式（如播放頁的模糊和透明度、歌詞樣式等）

【修復(fù)】修復(fù)部分情況下無法下載的問題

【插件】大量插件有更新，更新到此版本后更新訂閱即可