# dice

**Repository Path**: leftshine/dice

## Basic Information

- **Project Name**: dice
- **Description**: 写麻蒋老是没子骰†，干脆己自打一個
- **Primary Language**: HTML
- **License**: GPL-2.0
- **Default Branch**: main
- **Homepage**: https://dice.leftshine.cn/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-27
- **Last Updated**: 2025-10-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 骰子, 随机实验, 麻将

## README

# 3D骰子模拟器

### [访问演示页面](https://dice.leftshine.cn/)

## 简介
这是一个基于Web的3D骰子模拟器，提供逼真的骰子投掷体验。支持多种交互方式和丰富的用户设置选项，适用于桌面和移动设备。

## 主要功能
1. **3D骰子投掷效果** - 模拟真实的物理投掷效果。
2. **多骰子和连续投掷** - 支持一次投掷多个骰子，并可进行连续投掷。
3. **投掷历史记录** - 记录所有投掷结果，并提供可视化显示和抽屉式展开/收起功能。
4. **音效与振动反馈** - 提供音效和设备振动反馈增强体验。
5. **响应式设计** - 支持移动设备，通过“摇一摇”即可投掷骰子。
6. **汉堡菜单设置** - 可配置骰子数量、连续投掷次数、音效、震动、显示方式、晃动投掷开关和历史记录开关等。

## 特性更新
1. 支持中断连续投掷。
2. 历史记录抽屉支持拖拽操作。
3. 适配移动设备。
4. 设置持久化保存。
5. 支持全屏功能。
6. 可控制骰子大小。
7. 音效缓存优化。
8. 架构优化。
9. 兼容iOS系统。
10. UI与交互优化。
11. 文件拆分。
12. 资源压缩优化。

## 使用方法
1. 打开页面后，通过汉堡菜单配置骰子数量、连续投掷次数等选项。
2. 点击“投掷”按钮或在移动设备上“摇一摇”进行投掷。
3. 查看3D骰子的投掷动画和最终结果。
4. 历史记录会自动显示在侧边抽屉中，可展开查看详细信息。

## 技术实现
- **HTML/CSS/JavaScript** - 前端实现基于标准Web技术。
- **3D渲染** - 使用CSS 3D变换实现骰子动画。
- **设备运动检测** - 使用DeviceMotion API实现移动设备“摇一摇”功能。
- **本地存储** - 使用`localStorage`保存用户设置。
- **音效处理** - 使用Web Audio API进行音效播放和缓存。
- **响应式设计** - 使用CSS媒体查询适配不同设备。

## 许可证
本项目采用MIT许可证。详情请查看[LICENSE](LICENSE)文件。