XiaoMusic用小愛音箱語(yǔ)音口令播本地曲庫(kù)和在線歌曲適合 NAS 自架【免費(fèi)下載鏈接】xiaomusic使用小愛音箱播放音樂音樂使用 yt-dlp 下載。項(xiàng)目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicXiaoMusic 是一個(gè)自架音樂服務(wù)器綁定小米賬號(hào)后接管音箱的語(yǔ)音指令讓本地曲庫(kù)和在線歌曲開口即播音頻由 yt-dlp 下載落本地。家里有 NAS 和小愛音箱的話一條容器命令就能跑起來。先認(rèn)識(shí)一下它它基于 Python FastAPIMIT 協(xié)議開源以容器跑在 NAS 或任意 Linux 服務(wù)器上。綁定小米賬號(hào)后接管指定音箱的語(yǔ)音交互附帶 Web 控制面板可搜索、點(diǎn)播、調(diào)音量、切換設(shè)備。下載的歌保存在音樂目錄形成可離線重播的曲庫(kù)。功能速覽語(yǔ)音口令播放歌曲周杰倫晴天、下一首、單曲循環(huán)、關(guān)機(jī)本地曲庫(kù)掃描目錄里 mp3、flac、wav 等格式每個(gè)目錄一個(gè)播放列表在線搜索用 yt-dlp 搜索下載落本地網(wǎng)絡(luò)歌單JSON 配置電臺(tái)與歌曲定時(shí)任務(wù)按 crontab 執(zhí)行播放、調(diào)音量、語(yǔ)音播報(bào)自定義口令詞把自己的話術(shù)綁定到動(dòng)作解決什么麻煩現(xiàn)有做法各有局限內(nèi)置音樂服務(wù)曲庫(kù)有限且受會(huì)員限制熱門歌曲常無法完整播放本地音樂服務(wù)要在屏幕端打開瀏覽不適合免提場(chǎng)景音箱本身沒有入口播放自己存的音樂文件XiaoMusic 從口令入口切入音箱繼續(xù)當(dāng)交互終端它負(fù)責(zé)找歌、下載和回傳鏈接使用習(xí)慣不變。維度內(nèi)置音樂服務(wù)本項(xiàng)目做法曲庫(kù)來源平臺(tái)曲庫(kù)加會(huì)員本地曲庫(kù)加在線搜索控制方式受平臺(tái)指令限制語(yǔ)音口令可自由擴(kuò)展保存僅在線流下載落本地可離線重播原理一分鐘講完整個(gè)過程分三步拉取對(duì)話記錄小米賬號(hào)登錄成功后程序約每秒輪詢一次音箱對(duì)話記錄你說的話會(huì)出現(xiàn)在記錄里。匹配口令找歌記錄內(nèi)容與配置的口令詞字典匹配默認(rèn)需要播放歌曲前綴命中后先查本地曲庫(kù)查不到就調(diào) yt-dlp 在線搜索并下載?；貍鞑シ沛溄颖镜匚募騽傁螺d的歌都以 HTTP 鏈接回傳給音箱播放。打斷不是無縫的要先拉到記錄、再打斷音箱自帶回答全程有延遲。上圖是本地歌曲列表界面即第二步命中后的樣子?？诹钇ヅ渑c記錄拉取的邏輯可看 xiaomusic/command_handler.py 與 xiaomusic/conversation.py。十分鐘上手先建宿主機(jī)目錄再啟動(dòng)容器mkdir -p /xiaomusic_music /xiaomusic_conf docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic啟動(dòng)后打開http://NAS_IP:58090做三件事在設(shè)置頁(yè)填小米賬號(hào)密碼保存設(shè)備列表自動(dòng)出現(xiàn)無需手動(dòng)獲取 did。勾選要使用的音箱。確認(rèn)主機(jī)名與端口設(shè)置頁(yè)有自動(dòng)填充按鈕改過端口映射要同步改配置。其余參數(shù)下載目錄、轉(zhuǎn) MP3、型號(hào)兼容模式等都在 Web 頁(yè)面完整清單對(duì)照 config-example.json。還能這樣玩每天早晨音樂喚醒用定時(shí)任務(wù)功能crontab 格式配置比如工作日早上 8 點(diǎn)播指定歌曲、7 點(diǎn)先發(fā)一句早上好語(yǔ)音還可以順手設(shè)音量。示例與參數(shù)說明見 docs/issues/182.md。給孩子點(diǎn)播故事對(duì)音箱說播放歌曲小豬佩奇的故事它會(huì)先從 B 站搜到并下載再播放這是 README 標(biāo)注的隱藏玩法歌名搜到就能放適合故事、兒歌這類內(nèi)容。常聽電臺(tái)在設(shè)置頁(yè)填一份 JSON 網(wǎng)絡(luò)歌單支持 m3u8 與 mp3 流地址可掛電臺(tái)整段播放也可放別人分享的歌曲列表格式示例見 docs/issues/78.md。用之前想清楚項(xiàng)目已官方通知停止維護(hù)不再接受新功能與 bug 修復(fù)公告在 README 頂部。下載的歌曲來自第三方平臺(tái)版權(quán)合規(guī)由使用者自行負(fù)責(zé)README 免責(zé)聲明寫明僅供學(xué)習(xí)研究。小米賬號(hào)存在配置里面板暴露公網(wǎng)必須開密碼登錄README 不建議把同一賬號(hào)綁在攝像頭上。L05B、L05C、LX06、L16A 等型號(hào)放不了 flac需要開轉(zhuǎn)換為 MP3 或型號(hào)兼容模式。高頻輪詢對(duì)話記錄可能觸發(fā)風(fēng)控導(dǎo)致登錄失敗不使用時(shí)建議隨手關(guān)閉語(yǔ)音口令開關(guān)。常見卡點(diǎn)設(shè)備列表空提示 Login failed先關(guān)代理并重新登錄米家 App再到 mi.com 官網(wǎng)完成一次驗(yàn)證FAQ 稱能解決多數(shù)登錄失敗最后確認(rèn)設(shè)置里的賬號(hào)密碼無誤。步驟見 docs/issues/99.md。網(wǎng)頁(yè)端能播語(yǔ)音控制無效先確認(rèn)獲取對(duì)話記錄語(yǔ)音口令開關(guān)已打開首次保存 did 后要重啟容器。默認(rèn)口令前綴是播放歌曲說播放音樂不會(huì)被識(shí)別。可在小愛 App 對(duì)話記錄與程序日志里對(duì)照判斷是拉不到記錄還是口令沒匹配。歌曲鏈接瀏覽器能打開音箱沒聲音先確認(rèn)音箱和 NAS 在同一局域網(wǎng)再核對(duì)主機(jī)名與端口配置設(shè)置頁(yè)有自動(dòng)填充按鈕改過端口映射的要同步改配置。排查步驟見 FAQ 的日志顯示正在播放卻沒有聲音一節(jié)。第一天正常第二天語(yǔ)音失靈一般是拉取對(duì)話記錄過于頻繁觸發(fā)風(fēng)控。FAQ 建議用定時(shí)任務(wù)夜間關(guān)閉拉取、白天再開啟也可每天定時(shí)執(zhí)行一次重新初始化緩解登錄失效。接下來去哪docs/issues/99.mdFAQ 問題集合報(bào)錯(cuò)排查主入口docs/issues/index.md文檔與快速入門索引config-example.json全量參數(shù)清單xiaomusic/command_handler.py 與 xiaomusic/conversation.py命令處理與對(duì)話記錄拉取源碼自定義口令的入手處本項(xiàng)目功能已完整但作者已公告停止維護(hù)。若打算長(zhǎng)期使用建議先看 README 推薦的社區(qū)接力項(xiàng)目評(píng)估遷移成本后再部署?！久赓M(fèi)下載鏈接】xiaomusic使用小愛音箱播放音樂音樂使用 yt-dlp 下載。項(xiàng)目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考