From 262ce70998fa52dec3120589f51c47e96fb96df4 Mon Sep 17 00:00:00 2001
From: 905086 <k2049@qq.com>
Date: Tue, 03 Nov 2026 17:04:19 +0800
Subject: [PATCH] feat: 完成游戏盒子前后端基础功能开发
---
fluttergamebox/lib/pages/detail_page.dart | 730 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 730 insertions(+), 0 deletions(-)
diff --git a/fluttergamebox/lib/pages/detail_page.dart b/fluttergamebox/lib/pages/detail_page.dart
new file mode 100644
index 0000000..f538ae3
--- /dev/null
+++ b/fluttergamebox/lib/pages/detail_page.dart
@@ -0,0 +1,730 @@
+import 'dart:async';
+
+import 'package:file_picker/file_picker.dart';
+import 'package:flutter/material.dart';
+import 'package:fluttergamebox/api/api_client.dart';
+import 'package:fluttergamebox/api/api_service.dart';
+import 'package:fluttergamebox/common/theme.dart';
+import 'package:fluttergamebox/store/app_state.dart';
+import 'package:fluttergamebox/utils/util.dart';
+import 'package:fluttergamebox/widgets/download_manager.dart';
+
+class DetailPage extends StatefulWidget {
+ final int gameId;
+ final VoidCallback? onBack; // 在主Shell内展示时由Shell提供(保留顶部导航栏)
+ const DetailPage({super.key, required this.gameId, this.onBack});
+ @override
+ State<DetailPage> createState() => _DetailPageState();
+}
+
+class _DetailPageState extends State<DetailPage> {
+ Game? game;
+ bool isFavorite = false;
+ bool inLibrary = false;
+ bool _loading = true;
+ int _mediaIndex = 0;
+ Timer? _slideTimer;
+ late PageController _pageCtrl;
+
+ @override
+ void initState() {
+ super.initState();
+ _pageCtrl = PageController();
+ _load();
+ }
+
+ @override
+ void dispose() {
+ _slideTimer?.cancel();
+ _pageCtrl.dispose();
+ super.dispose();
+ }
+
+ Future<void> _load() async {
+ final res = await ApiService.gameDetail(widget.gameId);
+ if (!mounted) return;
+ if (res['code'] == 0) {
+ setState(() {
+ game = Game.fromJson(res['data']['game']);
+ isFavorite = res['data']['is_favorite'] == true;
+ inLibrary = res['data']['in_library'] == true;
+ _loading = false;
+ });
+ // 媒体自动轮播
+ _slideTimer?.cancel();
+ _slideTimer = Timer.periodic(const Duration(seconds: 5), (_) {
+ final mediaCount = 1 + (game?.screenshots.length ?? 0);
+ if (mediaCount > 1 && mounted && _pageCtrl.hasClients) {
+ _pageCtrl.nextPage(
+ duration: const Duration(milliseconds: 400),
+ curve: Curves.easeInOut);
+ }
+ });
+ } else {
+ setState(() => _loading = false);
+ }
+ }
+
+ Future<void> _toggleFavorite() async {
+ final res = await ApiService.toggleFavorite(widget.gameId);
+ if (res['code'] == 0 && mounted) {
+ setState(() => isFavorite = !isFavorite);
+ _toast(res['msg'] ?? '操作成功');
+ }
+ }
+
+ Future<void> _addToLibrary() async {
+ final res = await ApiService.addToLibrary(widget.gameId);
+ if (res['code'] == 0 && mounted) {
+ setState(() => inLibrary = true);
+ _showConfirmDialog(
+ '兑换成功!', '游戏已加入资源库,请在资源库页面查看。');
+ } else if (mounted) {
+ _toast(res['msg'] ?? '添加失败', error: true);
+ }
+ }
+
+ Future<void> _download() async {
+ if (game == null) return;
+ // 检查下载路径
+ var dlPath = await AppPrefs.getDownloadPath();
+ if (dlPath.isEmpty) {
+ final ok = await _askDownloadPath();
+ if (!ok) return;
+ dlPath = await AppPrefs.getDownloadPath();
+ }
+ // 会员校验+开始下载
+ try {
+ await DownloadManager.instance.startDownload(game!);
+ if (mounted) showDownloadDialog(context);
+ setState(() => inLibrary = true);
+ } catch (e) {
+ if (mounted) _toast(e.toString(), error: true);
+ }
+ }
+
+ /// 首次下载询问下载路径
+ Future<bool> _askDownloadPath() async {
+ final res = await ApiService.downloadInfo(widget.gameId);
+ if (res['code'] != 0) {
+ if (mounted) _toast(res['msg'] ?? '无法下载', error: true);
+ return false;
+ }
+ final result = await showDialog<bool>(
+ context: context,
+ builder: (context) => _DownloadPathDialog(gameTitle: game!.title),
+ );
+ return result == true;
+ }
+
+ void _toast(String msg, {bool error = false}) {
+ final overlay = Overlay.of(context);
+ final entry = OverlayEntry(
+ builder: (context) => Positioned(
+ top: 60,
+ left: MediaQuery.of(context).size.width / 2 - 140,
+ child: Material(
+ color: Colors.transparent,
+ child: Container(
+ width: 280,
+ padding:
+ const EdgeInsets.symmetric(horizontal: 16, vertical: 12),
+ decoration: BoxDecoration(
+ color: error ? AppColors.red : AppColors.green,
+ borderRadius: BorderRadius.circular(6),
+ ),
+ child: Row(
+ children: [
+ Icon(error ? Icons.error_outline : Icons.check_circle,
+ color: Colors.white, size: 18),
+ const SizedBox(width: 8),
+ Expanded(
+ child: Text(msg,
+ style: const TextStyle(
+ color: Colors.white, fontSize: 13)),
+ ),
+ ],
+ ),
+ ),
+ ),
+ ),
+ );
+ overlay.insert(entry);
+ Future.delayed(const Duration(seconds: 2), () => entry.remove());
+ }
+
+ void _showConfirmDialog(String title, String content) {
+ showDialog(
+ context: context,
+ builder: (context) => Dialog(
+ backgroundColor: Colors.white,
+ shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(8)),
+ child: Container(
+ width: 360,
+ padding: const EdgeInsets.all(24),
+ child: Column(
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ const Icon(Icons.check_circle,
+ color: AppColors.green, size: 48),
+ const SizedBox(height: 16),
+ Text(title,
+ style: const TextStyle(
+ color: Colors.black,
+ fontSize: 16,
+ fontWeight: FontWeight.bold)),
+ const SizedBox(height: 8),
+ Text(content,
+ textAlign: TextAlign.center,
+ style: const TextStyle(
+ color: Color(0xFF666666), fontSize: 13)),
+ const SizedBox(height: 20),
+ SizedBox(
+ width: 120,
+ child: ElevatedButton(
+ onPressed: () => Navigator.pop(context),
+ style: ElevatedButton.styleFrom(
+ backgroundColor: AppColors.accent,
+ foregroundColor: Colors.white,
+ ),
+ child: const Text('确定'),
+ ),
+ ),
+ ],
+ ),
+ ),
+ ),
+ );
+ }
+
+ @override
+ Widget build(BuildContext context) {
+ return Scaffold(
+ backgroundColor: AppColors.bg,
+ body: _loading
+ ? const Center(
+ child: CircularProgressIndicator(color: AppColors.accent))
+ : game == null
+ ? const Center(
+ child: Text('游戏不存在',
+ style: TextStyle(color: AppColors.textGray)))
+ : Column(
+ children: [
+ _buildHeader(),
+ Expanded(
+ child: SingleChildScrollView(
+ child: Padding(
+ padding: const EdgeInsets.fromLTRB(70, 16, 70, 40),
+ child: Row(
+ crossAxisAlignment: CrossAxisAlignment.start,
+ children: [
+ // 左侧:媒体+介绍
+ Expanded(child: _buildLeft()),
+ const SizedBox(width: 20),
+ // 右侧:配置+操作
+ SizedBox(width: 320, child: _buildRight()),
+ ],
+ ),
+ ),
+ ),
+ ),
+ ],
+ ),
+ );
+ }
+
+ Widget _buildHeader() {
+ return Container(
+ height: 52,
+ color: const Color(0xFF191C2B),
+ padding: const EdgeInsets.symmetric(horizontal: 16),
+ child: Row(
+ children: [
+ IconButton(
+ icon: const Icon(Icons.arrow_back,
+ size: 20, color: AppColors.textGray),
+ onPressed: () {
+ if (widget.onBack != null) {
+ widget.onBack!();
+ } else {
+ Navigator.pop(context);
+ }
+ },
+ ),
+ const SizedBox(width: 8),
+ Expanded(
+ child: Text(game!.title,
+ maxLines: 1,
+ overflow: TextOverflow.ellipsis,
+ style: const TextStyle(
+ color: Colors.white,
+ fontSize: 15,
+ fontWeight: FontWeight.w500)),
+ ),
+ // 收藏
+ GestureDetector(
+ onTap: _toggleFavorite,
+ child: Row(
+ children: [
+ Icon(
+ isFavorite ? Icons.star : Icons.star_border,
+ size: 18,
+ color: isFavorite ? AppColors.yellow : AppColors.textGray,
+ ),
+ const SizedBox(width: 4),
+ Text(isFavorite ? '取消收藏' : '收藏',
+ style: TextStyle(
+ color: isFavorite
+ ? AppColors.yellow
+ : AppColors.textGray,
+ fontSize: 13)),
+ ],
+ ),
+ ),
+ const SizedBox(width: 20),
+ ],
+ ),
+ );
+ }
+
+ Widget _buildLeft() {
+ return Column(
+ crossAxisAlignment: CrossAxisAlignment.start,
+ children: [
+ // 媒体轮播
+ _buildMedia(),
+ const SizedBox(height: 20),
+ // 游戏介绍
+ const Text('游戏介绍',
+ style: TextStyle(
+ color: Colors.white,
+ fontSize: 15,
+ fontWeight: FontWeight.w500)),
+ const SizedBox(height: 12),
+ Container(
+ width: double.infinity,
+ padding: const EdgeInsets.all(16),
+ decoration: BoxDecoration(
+ color: AppColors.bgLight,
+ borderRadius: BorderRadius.circular(6),
+ ),
+ child: Text(
+ game!.description.isEmpty ? '暂无介绍' : game!.description,
+ style: const TextStyle(
+ color: AppColors.textGray, fontSize: 13, height: 1.8),
+ ),
+ ),
+ // 截图
+ if (game!.screenshots.isNotEmpty) ...[
+ const SizedBox(height: 20),
+ const Text('游戏截图',
+ style: TextStyle(
+ color: Colors.white,
+ fontSize: 15,
+ fontWeight: FontWeight.w500)),
+ const SizedBox(height: 12),
+ Wrap(
+ spacing: 10,
+ runSpacing: 10,
+ children: game!.screenshots
+ .map((s) => ClipRRect(
+ borderRadius: BorderRadius.circular(4),
+ child: Image.network(
+ ApiClient.baseUrl + s,
+ width: 200,
+ height: 112,
+ fit: BoxFit.cover,
+ errorBuilder: (_, __, ___) => Container(
+ width: 200,
+ height: 112,
+ color: AppColors.bgLighter,
+ ),
+ ),
+ ))
+ .toList(),
+ ),
+ ],
+ ],
+ );
+ }
+
+ Widget _buildMedia() {
+ final mediaCount = 1 + game!.screenshots.length;
+ return Column(
+ children: [
+ AspectRatio(
+ aspectRatio: 16 / 8,
+ child: PageView.builder(
+ controller: _pageCtrl,
+ itemCount: mediaCount,
+ onPageChanged: (i) => setState(() => _mediaIndex = i),
+ itemBuilder: (context, i) {
+ if (i == 0 && game!.video.isNotEmpty) {
+ // 视频占位(展示封面+播放按钮)
+ return _buildMediaItem(game!.cover, isVideo: true);
+ }
+ final img = i == 0 ? game!.cover : game!.screenshots[i - 1];
+ return _buildMediaItem(img);
+ },
+ ),
+ ),
+ const SizedBox(height: 8),
+ // 缩略图
+ Row(
+ children: [
+ for (var i = 0; i < mediaCount; i++)
+ GestureDetector(
+ onTap: () => _pageCtrl.animateToPage(i,
+ duration: const Duration(milliseconds: 300),
+ curve: Curves.easeInOut),
+ child: Container(
+ width: 88,
+ height: 50,
+ margin: const EdgeInsets.only(right: 8),
+ decoration: BoxDecoration(
+ borderRadius: BorderRadius.circular(4),
+ border: Border.all(
+ color: _mediaIndex == i
+ ? AppColors.accent
+ : Colors.transparent,
+ width: 2,
+ ),
+ ),
+ child: ClipRRect(
+ borderRadius: BorderRadius.circular(3),
+ child: Image.network(
+ ApiClient.baseUrl +
+ (i == 0 ? game!.cover : game!.screenshots[i - 1]),
+ fit: BoxFit.cover,
+ errorBuilder: (_, __, ___) =>
+ Container(color: AppColors.bgLighter),
+ ),
+ ),
+ ),
+ ),
+ ],
+ ),
+ ],
+ );
+ }
+
+ Widget _buildMediaItem(String img, {bool isVideo = false}) {
+ return ClipRRect(
+ borderRadius: BorderRadius.circular(8),
+ child: Stack(
+ fit: StackFit.expand,
+ children: [
+ Image.network(
+ ApiClient.baseUrl + img,
+ fit: BoxFit.cover,
+ errorBuilder: (_, __, ___) =>
+ Container(color: AppColors.bgLighter),
+ ),
+ if (isVideo)
+ Center(
+ child: Container(
+ width: 64,
+ height: 64,
+ decoration: BoxDecoration(
+ color: Colors.black.withOpacity(0.5),
+ shape: BoxShape.circle,
+ border: Border.all(color: Colors.white38),
+ ),
+ child: const Icon(Icons.play_arrow,
+ color: Colors.white, size: 36),
+ ),
+ ),
+ // 版本说明条
+ Positioned(
+ left: 0,
+ right: 0,
+ bottom: 0,
+ child: Container(
+ padding:
+ const EdgeInsets.symmetric(horizontal: 14, vertical: 10),
+ decoration: BoxDecoration(
+ gradient: LinearGradient(
+ begin: Alignment.bottomCenter,
+ end: Alignment.topCenter,
+ colors: [
+ Colors.black.withOpacity(0.8),
+ Colors.transparent,
+ ],
+ ),
+ ),
+ child: Text(game!.versionNote,
+ maxLines: 1,
+ overflow: TextOverflow.ellipsis,
+ style: const TextStyle(color: Colors.white, fontSize: 13)),
+ ),
+ ),
+ ],
+ ),
+ );
+ }
+
+ Widget _buildRight() {
+ return Container(
+ padding: const EdgeInsets.all(20),
+ decoration: BoxDecoration(
+ color: AppColors.bgLight,
+ borderRadius: BorderRadius.circular(8),
+ ),
+ child: Column(
+ crossAxisAlignment: CrossAxisAlignment.start,
+ children: [
+ // 类别标签
+ Wrap(
+ spacing: 8,
+ runSpacing: 8,
+ children: [
+ _tag(game!.platformLabel, AppColors.accent),
+ for (final t in game!.tags.split(','))
+ if (t.trim().isNotEmpty) _tag(t.trim(), AppColors.bgLighter),
+ ],
+ ),
+ const SizedBox(height: 18),
+ _infoRow('游戏大小', game!.size),
+ _infoRow('磁盘占用', game!.installSize),
+ const Divider(color: AppColors.bgLighter, height: 28),
+ _infoRow('操作系统', game!.osReq),
+ _infoRow('CPU', game!.cpuReq),
+ _infoRow('内存', game!.ramReq),
+ _infoRow('显卡', game!.gpuReq),
+ const SizedBox(height: 20),
+ // 加入资源库
+ SizedBox(
+ width: double.infinity,
+ height: 44,
+ child: ElevatedButton(
+ onPressed: inLibrary ? null : _addToLibrary,
+ style: ElevatedButton.styleFrom(
+ backgroundColor: inLibrary
+ ? const Color(0xFF3A3F52)
+ : const Color(0xFF00A651),
+ foregroundColor: Colors.white,
+ disabledBackgroundColor: const Color(0xFF3A3F52),
+ disabledForegroundColor: AppColors.textGray,
+ shape: RoundedRectangleBorder(
+ borderRadius: BorderRadius.circular(4)),
+ ),
+ child: Row(
+ mainAxisAlignment: MainAxisAlignment.center,
+ children: [
+ Icon(
+ inLibrary
+ ? Icons.check_circle_outline
+ : Icons.add_circle_outline,
+ size: 18,
+ ),
+ const SizedBox(width: 8),
+ Text(inLibrary ? '已在资源库' : '加入资源库',
+ style: const TextStyle(fontSize: 14)),
+ ],
+ ),
+ ),
+ ),
+ const SizedBox(height: 12),
+ // 下载游戏
+ SizedBox(
+ width: double.infinity,
+ height: 44,
+ child: ElevatedButton(
+ onPressed: _download,
+ style: ElevatedButton.styleFrom(
+ backgroundColor: AppColors.accent,
+ foregroundColor: Colors.white,
+ shape: RoundedRectangleBorder(
+ borderRadius: BorderRadius.circular(4)),
+ ),
+ child: const Row(
+ mainAxisAlignment: MainAxisAlignment.center,
+ children: [
+ Icon(Icons.download, size: 18),
+ SizedBox(width: 8),
+ Text('下载游戏', style: TextStyle(fontSize: 14)),
+ ],
+ ),
+ ),
+ ),
+ ],
+ ),
+ );
+ }
+
+ Widget _tag(String text, Color color) {
+ return Container(
+ padding: const EdgeInsets.symmetric(horizontal: 10, vertical: 4),
+ decoration: BoxDecoration(
+ color: color,
+ borderRadius: BorderRadius.circular(3),
+ ),
+ child: Text(text,
+ style: const TextStyle(color: Colors.white, fontSize: 12)),
+ );
+ }
+
+ Widget _infoRow(String label, String value) {
+ return Padding(
+ padding: const EdgeInsets.symmetric(vertical: 5),
+ child: Row(
+ crossAxisAlignment: CrossAxisAlignment.start,
+ children: [
+ SizedBox(
+ width: 60,
+ child: Text(label,
+ style: const TextStyle(
+ color: AppColors.textDim, fontSize: 13)),
+ ),
+ Expanded(
+ child: Text(value.isEmpty ? '-' : value,
+ style: const TextStyle(
+ color: AppColors.textWhite, fontSize: 13)),
+ ),
+ ],
+ ),
+ );
+ }
+}
+
+/// 下载路径选择弹窗
+class _DownloadPathDialog extends StatefulWidget {
+ final String gameTitle;
+ const _DownloadPathDialog({required this.gameTitle});
+ @override
+ State<_DownloadPathDialog> createState() => _DownloadPathDialogState();
+}
+
+class _DownloadPathDialogState extends State<_DownloadPathDialog> {
+ final _dlCtrl = TextEditingController();
+ final _insCtrl = TextEditingController();
+
+ @override
+ void initState() {
+ super.initState();
+ _load();
+ }
+
+ Future<void> _load() async {
+ final dl = await AppPrefs.getDownloadPath();
+ final ins = await AppPrefs.getInstallPath();
+ setState(() {
+ _dlCtrl.text = dl.isEmpty ? 'C:\\99GameBox\\99GameD' : dl;
+ _insCtrl.text = ins.isEmpty ? 'C:\\99GameBox\\99GameI' : ins;
+ });
+ }
+
+ @override
+ Widget build(BuildContext context) {
+ return Dialog(
+ backgroundColor: const Color(0xFF1E2130),
+ shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(6)),
+ child: Container(
+ width: 500,
+ padding: const EdgeInsets.all(24),
+ child: Column(
+ mainAxisSize: MainAxisSize.min,
+ crossAxisAlignment: CrossAxisAlignment.start,
+ children: [
+ Row(
+ children: [
+ const Icon(Icons.folder,
+ size: 16, color: AppColors.textGray),
+ const SizedBox(width: 8),
+ const Text('请选择下载安装路径',
+ style: TextStyle(
+ color: Colors.white,
+ fontSize: 14,
+ fontWeight: FontWeight.w500)),
+ const Spacer(),
+ GestureDetector(
+ onTap: () => Navigator.pop(context, false),
+ child: const Icon(Icons.close,
+ size: 16, color: AppColors.textGray),
+ ),
+ ],
+ ),
+ const SizedBox(height: 18),
+ _pathRow('下载路径', _dlCtrl),
+ const SizedBox(height: 12),
+ _pathRow('安装路径', _insCtrl),
+ const SizedBox(height: 20),
+ Row(
+ mainAxisAlignment: MainAxisAlignment.end,
+ children: [
+ OutlinedButton(
+ onPressed: () => Navigator.pop(context, false),
+ style: OutlinedButton.styleFrom(
+ foregroundColor: AppColors.textGray,
+ side: const BorderSide(color: AppColors.bgLighter),
+ padding: const EdgeInsets.symmetric(
+ horizontal: 22, vertical: 10),
+ ),
+ child: const Text('取消'),
+ ),
+ const SizedBox(width: 12),
+ ElevatedButton(
+ onPressed: () async {
+ await AppPrefs.setPaths(_dlCtrl.text, _insCtrl.text);
+ if (context.mounted) Navigator.pop(context, true);
+ },
+ style: ElevatedButton.styleFrom(
+ backgroundColor: AppColors.accent,
+ foregroundColor: Colors.white,
+ padding: const EdgeInsets.symmetric(
+ horizontal: 22, vertical: 10),
+ ),
+ child: const Text('确认'),
+ ),
+ ],
+ ),
+ ],
+ ),
+ ),
+ );
+ }
+
+ Widget _pathRow(String label, TextEditingController ctrl) {
+ return Column(
+ crossAxisAlignment: CrossAxisAlignment.start,
+ children: [
+ Text(label,
+ style: const TextStyle(color: AppColors.textGray, fontSize: 12)),
+ const SizedBox(height: 6),
+ Row(
+ children: [
+ Expanded(
+ child: TextField(
+ controller: ctrl,
+ style: const TextStyle(color: Colors.black, fontSize: 13),
+ decoration: InputDecoration(
+ filled: true,
+ fillColor: Colors.white,
+ contentPadding: const EdgeInsets.symmetric(
+ horizontal: 10, vertical: 10),
+ border: OutlineInputBorder(
+ borderRadius: BorderRadius.circular(4),
+ borderSide: BorderSide.none),
+ ),
+ ),
+ ),
+ const SizedBox(width: 8),
+ ElevatedButton(
+ onPressed: () async {
+ final dir = await FilePicker.platform.getDirectoryPath();
+ if (dir != null) setState(() => ctrl.text = dir);
+ },
+ style: ElevatedButton.styleFrom(
+ backgroundColor: AppColors.accent,
+ foregroundColor: Colors.white,
+ padding: const EdgeInsets.symmetric(
+ horizontal: 14, vertical: 11),
+ ),
+ child: const Text('选择目录', style: TextStyle(fontSize: 12)),
+ ),
+ ],
+ ),
+ ],
+ );
+ }
+}
--
Gitblit v1.10.0