介绍及使用文档
原生 JavaScript | 无需框架 | 全网页通用 | 简洁美观 · 安全轻量
🌟 产品介绍
Ulic 音频播放器 v1.0 是一款基于原生 JavaScript 开发的轻量级网页音频播放器，通过简单的自定义标签即可在任何网页、静态站点、在线文档、博客等平台中快速插入美观、可交互的音频播放器。无需依赖任何前端框架，无需复杂配置，一行引入 + 一行标签即可直接使用。
⚙️ 可配置参数
播放器支持三个核心参数，按需填写即可：
- title
音频名称，显示在播放器内部标题区域 - url
音频文件直链，支持 MP3 等主流网页音频格式 autoplay
是否开启自动播放- true 自动播放
- false 不自动播放（默认值）
🚀 标准使用代码
以下为标准引用代码，可直接放置在网页中使用：
<script src="https://ulic.cc/music.js"></script>
<music-player
title="音乐名称"
url="音乐直链"
autoplay="false">
</music-player>注:如果想要进入页面就自动播放 把autoplay的false改成true即可
示例
🛡️ 安全性剖析
- 纯原生 JS 实现，无任何第三方依赖
不引入外部库、框架或第三方接口，从源头降低安全风险。 - 闭包隔离作用域
全部逻辑封装在独立闭包内，不污染全局变量，不与页面其他脚本冲突。 - 无高危代码执行逻辑
不使用 eval、new Function 等危险执行方式，不存在代码注入漏洞。 - 音频地址仅作为资源加载
音频链接仅用于 audio 标签 src 属性，不会被解析为可执行脚本。 - 安全 DOM 操作
所有界面元素通过 createElement 方式创建，避免不安全的 HTML 字符串直接渲染。
✨ 核心优势
- 🌐 全网页通用
支持任何 HTML 页面、静态网站、文档系统、博客平台等 - 🪶 极致轻量
体积极小，加载速度极快，不占用页面资源 - 🎨 现代简约 UI
深色风格设计，进度条流畅，支持点击跳转与拖拽 - 📱 移动端完美适配
支持触摸操作，自适应屏幕尺寸，手机端体验流畅 - ⚙️ 使用极简
只需引入 JS 文件 + 自定义标签，无需额外配置 - 🔁 多实例支持
同一个页面可插入多个播放器，互不干扰 - 🎧 功能完整
包含播放/暂停、进度控制、时长显示、循环播放等基础功能
📌 适用场景
- 个人网站背景音乐
- 文章与文档内语音素材播放
- 在线课程语音讲解
- 播客、电台类页面
- 任何需要插入音频的网页场景
