一款基于PHP+Canvas的竹知了传统玩具模拟器，支持手动拖拽、自动甩动及手机陀螺仪体感操控，内置真实物理引擎与双轨声音引擎（采样+合成）。提供多套皮肤场景、可视化后台配置弹窗广告（富文本/图文/QQ群），附带实时数据统计。部署简单，适合个人站点趣味引流。
竹知了网页版传统玩具模拟器源码说明
这是一款近期热门的网页版传统玩具模拟器，完美还原了经典竹知了（竹蝉）玩具的核心玩法，通过网页端就能模拟竹知了在弹性绳上旋转发出“哇哇”声响的趣味体验，支持独立部署到自有PHP服务器，还自带可自定义的弹窗广告系统，适合个人站点、趣味引流场景使用。
✨ 核心功能亮点
核心玩法
- 手动拖拽：按住屏幕画圈即可驱动竹筒在弹性绳上旋转，旋转速度越快，发出的“哇哇”声响越大，高度还原实体玩具的操作手感
- 自动甩动：点击页面按钮就能触发自动匀速旋转效果，无需手动操作也能持续体验竹知了的发声乐趣
- 移动端体感操作：适配手机端陀螺仪传感器，直接甩动手机就能控制虚拟竹知了旋转，玩法更具沉浸感
- 真实物理模拟：内置固定步长物理模型，精准模拟重力、弹性绳拉力、空气阻力、旋转张力等物理效果，运行流畅自然
- 双轨声音引擎：优先加载真实竹知了玩具的录音采样，根据旋转速度实时调整音频播放效果；当采样文件解码失败时，会自动切换为Web Audio合成音效，保证全场景都能正常发声
皮肤与场景系统
内置多套趣味皮肤和对应场景，可自由切换体验不同风格：
| 皮肤样式 | 对应场景 |
|——|——|
| 🎋 经典竹知了（默认） | ☀️ 明亮白天场景 |
| 🐷 猪猪侠主题 | 🌤 柔和中午场景 |
| 🕷️ 蜘蛛侠主题 | 🌙 静谧夜间场景 |
自定义弹窗广告系统
点击页面右上角按钮即可唤起自定义弹窗，支持3种适配不同需求的内容样式：
| 样式类型 | 功能说明 |
|——|——|
| 富文本样式 | 完全支持HTML语法，可自由排版文字、插入图片、添加跳转链接，实现高度定制化的弹窗内容 |
| 文字+图片样式 | 组合展示广告文字与广告图片，可自主选择开启“一键复制”按钮，方便用户快速获取指定内容 |
| QQ群推广样式 | 展示清晰的加群提示，搭配一键跳转QQ加群页面的按钮，社群引流操作更便捷 |
弹窗还支持可选的二维码展示区域，可放置收款码、公众号码等自定义内容，满足更多运营需求。
实时数据统计
页面右下角会实时展示全站在线人数、累计访问量、总“哇”声次数等核心数据，每一次成功甩出的竹知了叫声都会自动计入全球统计，直观展示站点的互动热度。
📦 完整文件结构
源码上传到服务器后，目录结构清晰简洁，便于后续维护修改：
/
├── index.php # 面向普通用户的主页面，集成竹知了玩具交互与自定义弹窗
├── api.php # 后端核心API接口，负责管理员认证、配置存取等核心逻辑
├── admin/
│ └── index.html # 可视化管理后台，用于在线配置弹窗等站点设置
├── user.db # SQLite数据库文件，首次初始化管理员时自动生成
└── user_data.json # 备用存储文件，SQLite不可用时系统自动切换使用
🚀 详细部署指南
环境要求
部署门槛极低，绝大多数主流PHP服务器都能直接适配：
| 配置项 | 最低要求 | 推荐配置 |
|——|——|——|
| PHP版本 | ≥ 7.0 | 7.4及以上版本 |
| SQLite3扩展 | 可选 | 推荐开启（多数服务器默认已开启） |
| Web服务器 | Apache / Nginx | 配置好PHP解析规则即可 |
| 目录权限 | 站点根目录可写 | 目录权限设置为755或777 |
| 浏览器兼容 | 支持Canvas 2D、Web Audio API的现代浏览器 | 覆盖99%以上的主流移动端、PC端浏览器 |
分步部署流程
- 上传源码文件：将源码包内的所有文件上传到你的PHP服务器，既可以部署在站点根目录，通过主域名直接访问；也可以部署在子目录，通过
https://你的域名/zhuzhiliao/这类路径访问。 - 验证后端运行状态：浏览器访问
https://你的域名/api.php?action=ping，正常情况下会返回包含运行状态、存储类型、PHP版本等信息的JSON数据，确认后端服务正常运行。 - 初始化管理后台：访问
https://你的域名/admin/进入后台页面，首次打开时会自动跳转至“创建管理员”页面，按提示设置专属账号和密码，完成后台初始化。 - 自定义站点配置：登录管理后台后，即可按需修改右上角按钮文字、弹窗标题、弹窗内容样式、二维码展示内容等所有自定义项，完成个性化配置。
- 上线正式使用：所有配置完成后，直接访问站点首页，即可体验完整的竹知了模拟器效果，所有自定义配置会自动生效。
🎛️ 可视化后台配置项
后台支持全可视化修改，无需手动编辑代码即可完成所有设置：
基础站点信息
可自定义右上角按钮文字、弹窗标题、弹窗副标题、左下角站点跳转链接、链接显示文字等基础信息，打造专属站点风格。
弹窗内容配置
支持三选一的弹窗内容模式：
- 富文本模式：完全开放HTML编辑权限，自由实现任意排版效果
- 文字+图片模式：分别设置广告文字、广告图片链接，自主控制一键复制功能的开关状态
- QQ群模式：直接填入QQ群加群链接，即可生成一键跳转的加群弹窗
二维码配置
可自主上传二维码图片并设置二维码下方的说明文字，留空对应字段即可隐藏二维码区域。
🔒 安全机制说明
源码内置多重安全防护，保障站点运行稳定：
- 管理员密码采用SHA-256+自定义盐值的哈希方式加密存储，不会明文保存用户敏感信息
- 登录态使用随机生成的Token进行校验，Token有效期设置为2小时，降低账号被盗用风险
- 弹窗设置的读取接口公开开放，保障用户页面能正常加载配置；所有修改写入操作都需要管理员身份认证，避免配置被恶意篡改
- 若不慎忘记管理员密码，可在后台登录页点击“忘记密码”，使用内置安全密钥
zzl_reset_2024完成密码重置。
❓ 常见问题解答
- 后台提示“无法连接后端服务”：先确认服务器已正确安装PHP环境，检查Web服务器的PHP文件解析规则是否配置正确，也可以直接访问
api.php?action=ping单独测试接口运行状态，本地调试时还可以使用php -S 0.0.0.0:8000快速启动PHP内置测试服务器。 - 弹窗设置保存后页面无变化：用户页面会通过PHP动态注入最新配置，强制刷新页面即可加载最新的自定义效果。
- 服务器没有安装SQLite扩展：完全不影响使用，系统会自动检测环境，自动切换为
user_data.json文件存储模式，所有功能都能正常运行。 - 需要重置所有站点数据：登录管理后台后，在修改密码区域点击“重置账号”按钮，即可一键清除当前管理员账号和所有已保存的弹窗配置，恢复初始状态。
📄 使用许可
本源码仅供个人娱乐与技术学习交流使用，严禁直接或间接用于任何商业用途。
