feat: Introduce Wolf3dAppManager for managing audio shutdown and game data directory selection

Signed-off-by: Hans Kokx <hans.d.kokx@gmail.com>
2026-03-23 19:37:32 +01:00
parent 88050dbc7d
commit 6441592534
3 changed files with 149 additions and 11 deletions
@@ -0,0 +1,123 @@
+library;
+
+import 'dart:async';
+import 'dart:collection';
+
+import 'package:file_selector/file_selector.dart';
+import 'package:wolf_3d_flutter/wolf_3d_flutter.dart';
+
+/// Coordinates app-shell setup actions and shutdown behavior.
+class Wolf3dAppManager {
+  Wolf3dAppManager({required this.engine});
+
+  final Wolf3dFlutterEngine engine;
+
+  bool _isLoadingGameData = false;
+  String? _pickerError;
+  Future<void>? _shutdownFuture;
+
+  bool get isLoadingGameData => _isLoadingGameData;
+  String? get pickerError => _pickerError;
+
+  Future<void> ensureAudioShutdown() {
+    final existing = _shutdownFuture;
+    if (existing != null) {
+      return existing;
+    }
+
+    final shutdown = engine.shutdownAudio();
+    _shutdownFuture = shutdown;
+    return shutdown;
+  }
+
+  Future<void> pickGameDataDirectory({
+    required void Function() notifyChanged,
+  }) async {
+    _isLoadingGameData = true;
+    _pickerError = null;
+    notifyChanged();
+
+    try {
+      final String? directoryPath = await getDirectoryPath(
+        confirmButtonText: 'Use this folder',
+      );
+
+      if (directoryPath == null || directoryPath.trim().isEmpty) {
+        return;
+      }
+
+      await engine.init(directory: directoryPath.trim());
+    } catch (error) {
+      _pickerError = 'Unable to load selected directory: $error';
+    } finally {
+      _isLoadingGameData = false;
+      notifyChanged();
+    }
+  }
+
+  Future<void> pickGameDataFiles({
+    required void Function() notifyChanged,
+  }) async {
+    _isLoadingGameData = true;
+    _pickerError = null;
+    notifyChanged();
+
+    try {
+      final List<XFile> selectedFiles = await openFiles();
+
+      if (selectedFiles.isEmpty) {
+        return;
+      }
+
+      final LinkedHashSet<String> directories = LinkedHashSet<String>();
+      for (final XFile file in selectedFiles) {
+        final String directory = _directoryFromFilePath(file.path);
+        if (directory.isNotEmpty) {
+          directories.add(directory);
+        }
+      }
+
+      if (directories.isEmpty) {
+        _pickerError =
+            'Selected files do not expose local filesystem paths.';
+        return;
+      }
+
+      final List<String> orderedDirectories = directories.toList(
+        growable: false,
+      );
+      await engine.init(
+        directory: orderedDirectories.first,
+        additionalDirectories: orderedDirectories.skip(1),
+      );
+    } catch (error) {
+      _pickerError = 'Unable to load selected files: $error';
+    } finally {
+      _isLoadingGameData = false;
+      notifyChanged();
+    }
+  }
+
+  String _directoryFromFilePath(String path) {
+    final String trimmedPath = path.trim();
+    if (trimmedPath.isEmpty) {
+      return '';
+    }
+
+    final int slashIndex = trimmedPath.lastIndexOf('/');
+    final int backslashIndex = trimmedPath.lastIndexOf(r'\');
+    final int separatorIndex = slashIndex > backslashIndex
+        ? slashIndex
+        : backslashIndex;
+
+    if (separatorIndex < 0) {
+      return '';
+    }
+
+    if (separatorIndex == 0) {
+      return trimmedPath[0];
+    }
+
+    return trimmedPath.substring(0, separatorIndex);
+  }
+}