si-sm/fanuzu
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 3 Wiki Activity

GIVE 연타에 행성이 흔들리고 우하단에 [+1] · 10회 이상이면 [+10]과 자전 1.5배, 전송 중 연타는 다음 묶음으로 쌓임

Browse Source
This commit is contained in:
Sn-Kinos
2026-10-22 01:25:27 +09:00
parent 3f59c5070e
commit a2739a37f1
7 changed files with 389 additions and 45 deletions
Download Patch File Download Diff File Expand all files Collapse all files
app/lib/core/ui/live_planet.dart
+5
View File
@@ -18,8 +18,12 @@ class LivePlanet25D extends StatelessWidget {
this.glow = AppColors.neonViolet,
this.animate = true,
this.lowEffects = false,
this.spinBoost = false,
});
final VoidCallback? onOpenHistory;
/// [Planet25D.spinBoost].
final bool spinBoost;
final String fandomId;
final PlanetWatch watch;
final String image;
@@ -54,6 +58,7 @@ class LivePlanet25D extends StatelessWidget {
heroEventIds: state?.heroEventIds,
animate: animate,
lowEffects: lowEffects,
spinBoost: spinBoost,
),
);
}
app/lib/core/ui/planet_25d.dart
+12 -3
View File
@@ -145,8 +145,13 @@ class Planet25D extends StatefulWidget {
this.onOpenHistory,
this.lowEffects = false,
this.animate = true,
this.spinBoost = false,
});
/// GIVE 10회 이상 연타 중 — Figma `2033:15818` 「자전속도 1.5 배」. 본체는 자전하지 않으므로(C-185)
/// 구름 · 궤도 · 링 먼지 · 펄스가 도는 주기를 1.5배 빠르게 한다.
final bool spinBoost;
/// 다음 Stage 진화 5% 전 — 표면 아우라([PlanetVisualState.evolutionImminent]).
final bool evolutionImminent;
@@ -218,9 +223,12 @@ class _Planet25DState extends State<Planet25D>
// 실패의 감소 폭은 원문에 수치가 없어 이클립스 진행 중과 같은 값을 쓴다(해석 확인 항목).
? eclipseLight
: 1;
Duration get _cycle =>
Duration(milliseconds: (_period * 1000 / (widget.spinBoost ? 1.5 : 1)).round());
late final AnimationController _c = AnimationController(
vsync: this,
duration: Duration(seconds: _period),
duration: _cycle,
);
bool get _motionEnabled =>
@@ -245,8 +253,9 @@ class _Planet25DState extends State<Planet25D>
super.didUpdateWidget(old);
if (old.isHibernating != widget.isHibernating ||
old.isEclipsed != widget.isEclipsed ||
old.isHeroTime != widget.isHeroTime) {
_c.duration = Duration(seconds: _period);
old.isHeroTime != widget.isHeroTime ||
old.spinBoost != widget.spinBoost) {
_c.duration = _cycle;
if (_motionEnabled) _c.repeat();
}
_syncMotion();
app/lib/features/galaxy/galaxy_screen.dart
+3 -4
View File
@@ -297,7 +297,8 @@ class _GalaxyScreenState extends State<GalaxyScreen>
.clamp(0, 1 << 30)
: _selectedIndex,
balance: _zap.balance,
pending: _zap.pending,
// 보내는 중인 묶음까지 — 전송 중에도 연타가 쌓인다.
pending: _zap.queued,
sending: _zap.sending,
touchSerial: _zap.touchSerial,
zapResult: _zap.result,
@@ -671,9 +672,7 @@ class _Map extends StatelessWidget {
myPop: (balance ?? data.myPop) - pending * data.zapPop,
// **이클립스와 무관하다.** ZAP 은 행성 성장 기여이며(B-23), 방어는
// 「흔들어 방어」 화면에서 POP 없이 참여한다.
blockedReason: sending
? context.l10n.zapApplying
: retryZap != null
blockedReason: retryZap != null
? context.l10n.zapNeedsCheck
: data.mine == null
? context.l10n.zapNoPlanet
app/lib/features/galaxy/zap_controller.dart
+30 -2
View File
@@ -20,6 +20,16 @@ class ZapController extends ChangeNotifier {
({String fandomId, int count, String key})? _batch;
bool get needsRetry => _batch != null && !sending;
/// 아직 확정되지 않은 연타 — 보내는 중인 묶음 + 다음 묶음. 표시 잔액은 이만큼 미리 뺀다.
int get queued => pending + (sending ? _batch?.count ?? 0 : 0);
/// 이어서 누른 횟수 — Figma `2024:20758` 「0.5초간 [+1] 표시(연속 가능)」: [+1] 이 떠 있는
/// [streakWindow] 안에 다시 누르면 이어지고, 넘기면 1 부터 다시 센다.
int streak = 0;
Timer? _streakTimer;
String? _pendingFandom;
static const streakWindow = Duration(milliseconds: 500);
/// 지금 결과가 ZAP 이 아니라 퀘스트 보상 확정의 행성 반응인가([react]).
bool questReaction = false;
@@ -41,14 +51,25 @@ class ZapController extends ChangeNotifier {
notifyListeners();
}
/// 보내는 중에도 받는다 — 다음 묶음으로 쌓였다가 앞 묶음이 확정되면 보낸다. 실패한 묶음이
/// 있으면([needsRetry]) 같은 키로 다시 확인하기 전까지 받지 않는다.
void tap(String fandomId) {
if (_disposed || sending || _batch != null || fandomId.isEmpty) return;
if (_disposed || needsRetry || fandomId.isEmpty) return;
// 쌓인 연타는 한 행성 몫이다. 다른 행성 탭은 쌓인 묶음이 나간 뒤에 받는다.
if (pending > 0 && fandomId != _pendingFandom) return;
_pendingFandom = fandomId;
questReaction = false;
if (pending == 0) fxHaptic(FxIntensity.small);
streak = _streakTimer?.isActive == true ? streak + 1 : 1;
_streakTimer?.cancel();
_streakTimer = Timer(streakWindow, () {});
pending++;
touchSerial++;
notifyListeners();
_burst ??= Timer(const Duration(milliseconds: 450), () => _flush(fandomId));
_burst ??= Timer(const Duration(milliseconds: 450), () {
_burst = null;
_flush(_pendingFandom!);
});
}
void retry() {
@@ -56,6 +77,7 @@ class ZapController extends ChangeNotifier {
}
Future<void> _flush(String fandomId) async {
// 보내는 중이면 확정 뒤(finally)에 이어 보낸다.
if (_disposed || sending) return;
final batch =
_batch ??
@@ -84,6 +106,10 @@ class ZapController extends ChangeNotifier {
_batch = null;
} catch (error) {
if (_disposed) return;
// 실패하면 뒤에 쌓인 연타는 보내지 않는다 — 실패 묶음을 같은 키로 다시 확인하는 것이 먼저다.
pending = 0;
_burst?.cancel();
_burst = null;
onFailure(switch (error) {
BackendException(code: 'E-POP-01') => appL10n.zapFailNoPop,
BackendException(code: 'E-POP-02') => appL10n.zapFailLedger,
@@ -94,6 +120,7 @@ class ZapController extends ChangeNotifier {
if (!_disposed) {
sending = false;
notifyListeners();
if (_batch == null && pending > 0 && _burst == null) _flush(_pendingFandom!);
}
}
}
@@ -102,6 +129,7 @@ class ZapController extends ChangeNotifier {
void dispose() {
_disposed = true;
_burst?.cancel();
_streakTimer?.cancel();
super.dispose();
}
}
app/lib/features/home/widgets/home_hero.dart
+145 -35
View File
@@ -1,3 +1,4 @@
import 'dart:async';
import '../../../core/ui/planet_fx_scope.dart';
import '../../galaxy/galaxy_data.dart';
import '../../galaxy/zap_controller.dart';
@@ -225,9 +226,14 @@ class _HomeHeroState extends State<HomeHero> {
clipBehavior: Clip.none,
children: [
Positioned.fill(
child: _TapShake(
child: _PlanetReaction(
onTap: widget.onTapPlanet,
child: LivePlanet25D(
zap: hasZap ? widget.zap : null,
planetSize: math.min(
planet,
box.maxHeight,
),
builder: (spinBoost) => LivePlanet25D(
onOpenHistory:
widget.onOpenHistory,
key: _planetKey,
@@ -243,6 +249,7 @@ class _HomeHeroState extends State<HomeHero> {
box.maxHeight,
),
glow: AppColors.neonViolet,
spinBoost: spinBoost,
),
),
),
@@ -755,9 +762,10 @@ class _Nebula extends StatelessWidget {
label: context.l10n.heroNebula,
// Figma `2013:15377` 「성운 터치시 흔들림」 — 조건 전에도 흔들림 · 가벼운 햅틱으로 반응하고,
// 탄생 조건을 채웠으면 흔들린 뒤 행성 생성으로 간다.
child: _TapShake(
child: _PlanetReaction(
onTap: ready && onBirth != null ? onBirth : () {},
child: Image.asset(
planetSize: 212,
builder: (_) => Image.asset(
'assets/figma/nebula-home.png',
width: 212,
height: 212,
@@ -1086,16 +1094,13 @@ class HomeZap extends StatelessWidget {
showLabel: false,
onItem: onItem,
zapPop: data.zapPop,
myPop: (zap.balance ?? data.myPop) - zap.pending * data.zapPop,
myPop: (zap.balance ?? data.myPop) - zap.queued * data.zapPop,
// Figma `516:88102` Zap_버프(아이템 배수 · 지속시간)는 별첨 B B-22 「배수 기능 제거」 ·
// 10/3 통합회신(C-124) 「사용 시 Drop Pool 발생 후 HERO TIME 발동」이 대체한다 —
// 같은 팬덤의 아이템 사용으로 HERO TIME 이 열리면 ZAP 이 Drop POP 참여로 바뀐다.
isHeroTime: hero,
blockedReason: zap.sending
? context.l10n.zapApplying
: zap.needsRetry
? context.l10n.zapNeedsCheck
: null,
// 보내는 중에도 누를 수 있다 — 연타는 다음 묶음으로 쌓인다(Figma `2033:15818` 10회 이상 연타).
blockedReason: zap.needsRetry ? context.l10n.zapNeedsCheck : null,
onZap: () => hero ? onHeroParticipate!() : zap.tap(fandomId),
),
],
@@ -1104,54 +1109,159 @@ class HomeZap extends StatelessWidget {
);
}
/// 행성 터치 반응 — Figma `2024:20758` 「행성 1회 터치시 흔들림 1번」 · UX·FX v1.5 §3 Light Haptic.
/// 흔들림이 끝나면 [onTap](커뮤니티 이동)을 부른다. [onTap] 이 없으면 아무 반응도 하지 않는다.
class _TapShake extends StatefulWidget {
const _TapShake({required this.child, this.onTap});
/// 행성 반응 — Figma `2024:20758` 「행성 1회 터치시 흔들림 1번」 · `2033:15818` 행성 리액션 1.
///
/// - 행성 터치: Light Haptic · 흔들림 1번이 끝나면 [onTap](커뮤니티 이동).
/// - GIVE: 누를 때마다 흔들림 1번 · 행성 우하단 [+1] 0.5초(연속 가능). 이어서 10회 이상이면
/// 흔들림 x2 · 자전 1.5배([Planet25D.spinBoost]) · [+10]. 숫자는 누른 횟수이고 기여 결과는
/// 서버 확정 뒤 [ZapFeedback] 이 따로 띄운다(v1.5 §1.2).
class _PlanetReaction extends StatefulWidget {
const _PlanetReaction({
required this.builder,
required this.planetSize,
this.onTap,
this.zap,
});
final Widget child;
final Widget Function(bool spinBoost) builder;
final double planetSize;
final VoidCallback? onTap;
final ZapController? zap;
/// 「10 회 이상 터치시」.
static const boostStreak = 10;
/// 흔들림 한 번 길이.
static const shakeOnce = Duration(milliseconds: 320);
@override
State<_TapShake> createState() => _TapShakeState();
State<_PlanetReaction> createState() => _PlanetReactionState();
}
class _TapShakeState extends State<_TapShake>
class _PlanetReactionState extends State<_PlanetReaction>
with SingleTickerProviderStateMixin {
late final _shake = AnimationController(
vsync: this,
duration: const Duration(milliseconds: 320),
duration: _PlanetReaction.shakeOnce,
);
int _shakes = 1;
int? _seenSerial;
int _streak = 0;
Timer? _countTimer;
@override
void initState() {
super.initState();
_seenSerial = widget.zap?.touchSerial;
widget.zap?.addListener(_onZap);
}
@override
void didUpdateWidget(_PlanetReaction old) {
super.didUpdateWidget(old);
if (old.zap != widget.zap) {
old.zap?.removeListener(_onZap);
_seenSerial = widget.zap?.touchSerial;
widget.zap?.addListener(_onZap);
}
}
@override
void dispose() {
widget.zap?.removeListener(_onZap);
_countTimer?.cancel();
_shake.dispose();
super.dispose();
}
void _onZap() {
final zap = widget.zap!;
if (zap.touchSerial == _seenSerial) return;
_seenSerial = zap.touchSerial;
if (zap.questReaction) return;
setState(() => _streak = zap.streak);
_countTimer?.cancel();
_countTimer = Timer(ZapController.streakWindow, () {
if (mounted) setState(() => _streak = 0);
});
_play(_streak >= _PlanetReaction.boostStreak ? 2 : 1);
}
TickerFuture? _play(int shakes) {
// 동작 줄이기면 흔들지 않는다 — 숫자 표시와 이동은 그대로.
if (MediaQuery.disableAnimationsOf(context)) return null;
_shakes = shakes;
_shake.duration = _PlanetReaction.shakeOnce * shakes;
return _shake.forward(from: 0);
}
bool _opening = false;
/// 흔들림 한 번을 보여 준 뒤 이동한다. 그사이 GIVE 가 흔들림을 다시 시작해도 이동은 그대로 간다.
Future<void> _tap() async {
final onTap = widget.onTap;
if (onTap == null || _shake.isAnimating) return;
if (onTap == null || _opening) return;
_opening = true;
fxHaptic(FxIntensity.micro);
if (!MediaQuery.disableAnimationsOf(context)) await _shake.forward(from: 0);
if (_play(1) != null) await Future<void>.delayed(_PlanetReaction.shakeOnce);
_opening = false;
if (mounted) onTap();
}
@override
Widget build(BuildContext context) => GestureDetector(
behavior: HitTestBehavior.translucent,
onTap: widget.onTap == null ? null : _tap,
child: AnimatedBuilder(
animation: _shake,
// 한 번 좌우로 흔들리고 제자리 — 진폭 6 · 감쇠.
builder: (context, child) => Transform.translate(
offset: Offset(
math.sin(_shake.value * math.pi * 4) * 6 * (1 - _shake.value),
0,
),
child: child,
Widget build(BuildContext context) {
final boost = _streak >= _PlanetReaction.boostStreak;
return GestureDetector(
behavior: HitTestBehavior.translucent,
onTap: widget.onTap == null ? null : _tap,
child: Stack(
clipBehavior: Clip.none,
alignment: Alignment.center,
children: [
AnimatedBuilder(
animation: _shake,
// 좌우로 흔들리고 제자리 — 진폭 6 · 감쇠. 한 번에 [_shakes] 왕복.
builder: (context, child) => Transform.translate(
key: const ValueKey('planet-give-shake'),
offset: Offset(
math.sin(_shake.value * math.pi * 4 * _shakes) *
6 *
(1 - _shake.value),
0,
),
child: child,
),
child: widget.builder(boost),
),
if (_streak > 0)
// 행성 우측 하단 — 행성 그림 상자([planetSize]) 안 오른쪽 아래.
Positioned.fill(
child: IgnorePointer(
child: Center(
child: SizedBox.square(
dimension: widget.planetSize,
child: Align(
alignment: const Alignment(0.85, 0.85),
child: Text(
boost ? '+10' : '+1',
key: const ValueKey('planet-give-count'),
style: const TextStyle(
fontFamily: AppFonts.body,
fontSize: 16,
fontWeight: FontWeight.w600,
color: AppColors.onCosmic,
shadows: [
Shadow(color: AppColors.neonViolet, blurRadius: 8),
],
),
),
),
),
),
),
),
],
),
child: widget.child,
),
);
);
}
}