Files
zyt/TUICallKit-Vue3/training/pages/components/grip-ring-canvas.vue
T
longandClaude Opus 4.7 c3e4dfa479 feat(training): 握力环训练全面优化 - 音效集成 + 沉浸式画布 + Canvas 2D
## 主要改动

### 1. 音效集成
- 集成 4 个捏碎音效(鸡蛋/核桃/易拉罐/气球)
- 集成背景音乐 BGM + 右上角开关按钮
- 修复音效 URL 空值时的崩溃问题
- useMetronome 新增 volume 参数(默认 1.0)
- 节拍音量调小至 0.35,避免木鱼声过大

### 2. 画布升级到 Canvas 2D 接口
- 解决微信小程序 canvas-id 接口的警告
- 支持同层渲染,可与其他元素正常叠加
- 使用 requestAnimationFrame 替代 setTimeout
- DPR 自适应,Retina 屏幕高清渲染

### 3. 粒子特效差异化升级
- 4 种物品各自独立配色和形状
  - 🥚 鸡蛋: 蛋黄黄+白色,圆形,中速
  - 🌰 核桃: 4 种棕色,方形/三角/长方形,重粒
  - 🥫 易拉罐: 5 种银色,长方形,快速
  - 🎈 气球: 8 色彩虹,小颗粒,飘浮(低重力)
- 新增双层冲击波效果
- 粒子旋转动画(方形/三角形/长方形)
- 多形状粒子绘制(circle/square/triangle/rect)

### 4. 沉浸式画布重新设计
- 画布占屏幕 60vh(min 720rpx, max 900rpx)
- 背景与页面无缝融合(#f8fafc)
- 中心 1400rpx 大放射光晕,营造空间感
- 握力环放大至 520rpx,内圈 280rpx
- 完全移除浮动气泡(性能优化)

### 5. 视觉与体验优化
- 主题色改回青绿色(#14b8a6),握力环保持粉色突出
- 训练完成卡片大改造:
  - 大号 emoji 跳动动画
  - 统计项加入图标(💪⏱️🔥)
  - 食物对照可视化(emoji + 数量,最多 3 个)
  - 食物库扩展到 7 种(糖果/饼干/巧克力/苹果/香蕉/米饭/可乐)
- BPM 数字大号显示(80rpx 深粉色)
- 实时统计栏增加分隔线和顶部彩色高光

### 6. 性能优化(低配机器友好)
- 静态背景渐变(0 性能消耗)
- 单层中心光晕(无动画)
- 外发光仅在播放时启用
- GPU 加速(will-change + transform/opacity)
- 移除 backdrop-filter(高消耗)

### 7. Bug 修复
- crush-canvas 的 \$scope of null 错误
- 进入页面时音效预热不再发声(静音预热)
- 修复 walnut emoji 错用花生(🥜🌰)
- 弹窗遮挡粒子动画(延迟 1200ms 显示弹窗)

### 8. 文档
- 新增音效采集清单(grip-ring-audio-shopping-list.md)

## 修改文件
- grip-ring.vue: 主页面,音效集成、UI 重设计、食物对照
- grip-ring-canvas.vue: 沉浸式画布、握力环主体
- crush-canvas.vue: Canvas 2D 升级、差异化粒子系统
- useMetronome.ts: 音量参数支持
- dev-training-entry/index.vue: 入口配置微调

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-28 11:35:43 +08:00

319 lines
7.6 KiB
Vue

<template>
<view class="grip-ring-canvas">
<!-- 环境氛围:中心放射光晕(不形成边界,真正融入) -->
<view class="ambient-glow" />
<!-- 捏碎特效画布 -->
<CrushCanvas ref="crushCanvasRef" />
<!-- 握力环容器 -->
<view class="ring-container" :class="{ playing: isPlaying }" @click="onButtonClick">
<!-- 外发光(只在播放时启用) -->
<view class="ring-aura" />
<!-- 握力环主体 -->
<view class="grip-ring">
<view class="ring-outer-circle" />
<view class="ring-highlight" />
<view class="ring-inner-circle" />
</view>
<!-- 中心提示 (仅未开始时显示) -->
<view v-if="!isPlaying" class="center-hint">
<view class="hint-icon">
<view class="play-triangle" />
</view>
<text class="hint-text">点击开始</text>
</view>
<!-- BPM 显示 (播放时显示) -->
<view v-else class="bpm-display">
<text class="bpm-value">{{ bpm }}</text>
<text class="bpm-label">BPM</text>
</view>
</view>
</view>
</template>
<script setup lang="ts">
import { ref } from 'vue'
import CrushCanvas from './crush-canvas.vue'
interface Props {
bpm: number
isPlaying: boolean
}
const props = defineProps<Props>()
const emit = defineEmits<{
togglePlay: []
}>()
const crushCanvasRef = ref()
const onButtonClick = () => {
emit('togglePlay')
}
// 暴露捏碎特效触发方法
const triggerCrushEffect = (itemType: 'egg' | 'walnut' | 'can' | 'balloon') => {
crushCanvasRef.value?.triggerCrush(itemType)
}
defineExpose({
triggerCrushEffect
})
</script>
<style lang="scss" scoped>
/* ============================================================
* 画布容器 - 完全融入页面,无边界
* ============================================================ */
.grip-ring-canvas {
width: 100%;
height: 100%;
display: flex;
align-items: center;
justify-content: center;
position: relative;
overflow: hidden;
/* 与页面背景一致,无可见边界 */
background: #f8fafc;
}
/* 环境氛围 - 中心大放射光晕,营造空间感 */
.ambient-glow {
position: absolute;
width: 1400rpx;
height: 1400rpx;
top: 50%;
left: 50%;
transform: translate(-50%, -50%);
border-radius: 50%;
background:
radial-gradient(circle,
rgba(255, 255, 255, 1) 0%,
rgba(241, 245, 249, 0.6) 25%,
rgba(226, 232, 240, 0.3) 50%,
transparent 75%);
pointer-events: none;
}
/* ============================================================
* 握力环容器 - 主视觉
* ============================================================ */
.ring-container {
position: relative;
width: 640rpx;
height: 640rpx;
display: flex;
align-items: center;
justify-content: center;
cursor: pointer;
z-index: 1;
}
/* 外发光 - 只在播放时显示(节省 GPU) */
.ring-aura {
position: absolute;
width: 700rpx;
height: 700rpx;
border-radius: 50%;
background: radial-gradient(circle,
rgba(244, 114, 182, 0.45) 0%,
rgba(244, 114, 182, 0.15) 35%,
rgba(244, 114, 182, 0) 70%);
opacity: 0;
transition: opacity 0.3s ease;
will-change: transform, opacity;
}
.ring-container.playing .ring-aura {
opacity: 1;
animation: aura-breath 2s ease-in-out infinite;
}
@keyframes aura-breath {
0%, 100% {
transform: scale(0.95);
opacity: 0.7;
}
50% {
transform: scale(1.08);
opacity: 1;
}
}
/* ============================================================
* 握力环主体 - 大尺寸沉浸感
* ============================================================ */
.grip-ring {
position: relative;
width: 520rpx;
height: 520rpx;
display: flex;
align-items: center;
justify-content: center;
transition: transform 0.3s cubic-bezier(0.34, 1.56, 0.64, 1);
will-change: transform;
}
.ring-container:active .grip-ring {
transform: scale(0.96);
}
/* 外圈 - 粉色渐变(精致质感) */
.ring-outer-circle {
position: absolute;
width: 100%;
height: 100%;
border-radius: 50%;
background: linear-gradient(135deg,
#fda4af 0%,
#f472b6 50%,
#ec4899 100%);
box-shadow:
0 24rpx 64rpx rgba(236, 72, 153, 0.4),
0 12rpx 32rpx rgba(244, 114, 182, 0.3),
inset 0 -20rpx 40rpx rgba(190, 24, 93, 0.35),
inset 0 20rpx 40rpx rgba(255, 255, 255, 0.5);
}
/* 顶部高光 - 模拟材质感 */
.ring-highlight {
position: absolute;
width: 420rpx;
height: 120rpx;
top: 40rpx;
border-radius: 50%;
background: radial-gradient(ellipse,
rgba(255, 255, 255, 0.6) 0%,
rgba(255, 255, 255, 0) 70%);
pointer-events: none;
}
/* 内圈中空 */
.ring-inner-circle {
position: absolute;
width: 280rpx;
height: 280rpx;
border-radius: 50%;
background: linear-gradient(135deg, #ffffff 0%, #f8fafc 100%);
box-shadow:
inset 0 8rpx 20rpx rgba(190, 24, 93, 0.3),
inset 0 -2rpx 8rpx rgba(255, 255, 255, 0.8);
}
/* 播放时的挤压动画(只影响 transform,GPU 加速) */
.ring-container.playing .grip-ring {
animation: squeeze-ring 1s ease-in-out infinite;
}
@keyframes squeeze-ring {
0%, 100% {
transform: scale(1);
}
50% {
transform: scale(0.93);
}
}
/* ============================================================
* 中心提示 (未开始)
* ============================================================ */
.center-hint {
position: absolute;
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
gap: 16rpx;
pointer-events: none;
animation: hint-fade-in 0.3s ease;
}
@keyframes hint-fade-in {
from {
opacity: 0;
transform: scale(0.9);
}
to {
opacity: 1;
transform: scale(1);
}
}
.hint-icon {
width: 108rpx;
height: 108rpx;
display: flex;
align-items: center;
justify-content: center;
background: rgba(255, 255, 255, 0.98);
border-radius: 50%;
box-shadow:
0 12rpx 32rpx rgba(236, 72, 153, 0.35),
inset 0 2rpx 4rpx rgba(255, 255, 255, 0.9);
animation: hint-bounce 2s ease-in-out infinite;
will-change: transform;
}
.play-triangle {
width: 0;
height: 0;
border-left: 36rpx solid #ec4899;
border-top: 24rpx solid transparent;
border-bottom: 24rpx solid transparent;
margin-left: 10rpx;
}
@keyframes hint-bounce {
0%, 100% {
transform: scale(1);
}
50% {
transform: scale(1.06);
}
}
.hint-text {
font-size: 28rpx;
color: #be185d;
font-weight: 700;
letter-spacing: 4rpx;
text-shadow: 0 2rpx 8rpx rgba(255, 255, 255, 0.9);
}
/* ============================================================
* BPM 显示 (播放中)
* ============================================================ */
.bpm-display {
position: absolute;
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
gap: 4rpx;
pointer-events: none;
}
.bpm-value {
font-size: 88rpx;
color: #be185d;
font-weight: 900;
line-height: 1;
letter-spacing: -2rpx;
text-shadow: 0 2rpx 8rpx rgba(255, 255, 255, 0.9);
font-variant-numeric: tabular-nums;
}
.bpm-label {
font-size: 22rpx;
color: #ec4899;
font-weight: 700;
letter-spacing: 6rpx;
margin-top: 2rpx;
}
</style>