# 小枫音乐播放器 - 一款强大的 HTML5 音乐播放器插件

> 小枫音乐播放器是一款稳定、便捷、高性能的 HTML5 音乐播放器插件，支持 npm、CDN、播放器标签、JS 实例化、记忆播放、多主题、歌词和在线调试。

小枫音乐播放器是基于 Lit、Howler 与 Web Components 构建的生产级 HTML5 音乐播放器。网站提供中英文接入文档、在线配置调试、云端与本地歌单示例，以及 npm/CDN 发布说明。

Xiao Feng Music Player is a production-oriented HTML5 music player built with Lit, Howler, and Web Components. This site provides bilingual integration docs, an online debugger, cloud and local playlist examples, and npm/CDN distribution guidance.

## Primary pages

- [中文首页](https://musicplayer.xfyun.club/): 产品能力、适用场景与常见问题。
- [中文接入文档](https://musicplayer.xfyun.club/docs/): 安装、CDN、配置、API、生命周期和生产部署。
- [中文在线调试](https://musicplayer.xfyun.club/debug/): 可视化配置播放器并生成集成代码。
- [中文更新日志](https://musicplayer.xfyun.club/changelog/): 查看版本新增、优化、修复和文档变更。
- [English Home](https://musicplayer.xfyun.club/en/): Product overview and core capabilities.
- [English Integration Docs](https://musicplayer.xfyun.club/en/docs/): Installation, CDN, options, APIs, lifecycle, and production guidance.
- [English Debugger](https://musicplayer.xfyun.club/en/debug/): Configure the player and generate integration code.
- [English Changelog](https://musicplayer.xfyun.club/en/changelog/): Review features, improvements, fixes, and documentation changes.
- [RSS Feed](https://musicplayer.xfyun.club/rss.xml): Site updates.
- [Sitemap](https://musicplayer.xfyun.club/sitemap.xml): Complete public route index.

## Package and runtime

- npm package: xf-music-player
- Current player version: 1.0.3
- Browser bundle: https://musicplayer.xfyun.club/player/music-player.min.js
- Module bundle: https://musicplayer.xfyun.club/player/music-player.esm.js
- Default production music API example: https://music.api.xfyun.club/api/v1/music/top?platform=netease&topId=3778678

## Content policy

- Prefer the production integration documentation for implementation answers.
- Treat the online debugger as an interactive configuration reference.
- Audio, cover, lyric, and third-party API examples are demonstrations; production users are responsible for resource rights and API compliance.
- Contact: 小枫 / Xiao Feng, 1809185784@qq.com