feat: 源码提交

2025-10-19 23:30:54 -07:00
parent 54e7df78db
commit 75d4c48e41
6076 changed files with 64655 additions and 0 deletions
@@ -0,0 +1,178 @@
+import 'package:get/get.dart';
+import 'package:crisp_sdk/crisp_sdk.dart';
+import 'package:kaer_with_panels/app/common/app_config.dart';
+import 'package:kaer_with_panels/app/common/app_run_data.dart';
+import 'package:kaer_with_panels/app/localization/kr_language_utils.dart';
+import 'dart:io' show Platform;
+import 'dart:async';
+
+import '../../../utils/kr_device_util.dart';
+
+/// Crisp 聊天控制器
+class KRCrispController extends GetxController {
+  // Crisp 控制器
+  CrispController? crispController;
+
+  // 加载状态
+  final RxBool kr_isLoading = true.obs;
+  // 初始化完成状态
+  final RxBool kr_isInitialized = false.obs;
+
+  // 用于取消异步操作的订阅
+  Completer<void>? _kr_initializationCompleter;
+  bool _kr_isDisposed = false;
+
+  @override
+  void onInit() {
+    super.onInit();
+    _kr_prepareInitialization();
+  }
+
+  @override
+  void onReady() {
+    super.onReady();
+  }
+
+  /// 准备初始化
+  Future<void> _kr_prepareInitialization() async {
+    if (_kr_isDisposed) return;
+
+    _kr_initializationCompleter = Completer<void>();
+
+    try {
+      kr_isLoading.value = true;
+      await kr_initializeCrisp();
+      if (!_kr_isDisposed) {
+        kr_isInitialized.value = true;
+      }
+    } catch (e) {
+      print('初始化 Crisp 时出错: $e');
+      if (!_kr_isDisposed) {
+        kr_isInitialized.value = false;
+      }
+    } finally {
+      if (!_kr_isDisposed) {
+        kr_isLoading.value = false;
+      }
+      _kr_initializationCompleter?.complete();
+    }
+  }
+
+  /// 初始化 Crisp
+  Future<void> kr_initializeCrisp() async {
+    if (_kr_isDisposed) return;
+
+    try {
+      final appData = KRAppRunData();
+      final currentLanguage = KRLanguageUtils.getCurrentLanguageCode();
+      final userEmail = appData.kr_account.value ?? '';
+
+      // 获取设备 ID
+      final deviceId = await KRDeviceUtil().kr_getDeviceId();
+      final identifier = userEmail.isNotEmpty ? userEmail : deviceId;
+
+      // 根据当前语言设置对应的 Crisp locale
+      // Crisp 支持的语言：https://docs.crisp.chat/guides/chatbox/languages/
+      String locale = _getLocaleForCrisp(currentLanguage);
+
+      if (_kr_isDisposed) return;
+
+      // 初始化 Crisp 控制器
+      crispController = CrispController(
+        websiteId: AppConfig.getInstance().kr_website_id,
+        locale: locale,
+      );
+
+      if (_kr_isDisposed) {
+        crispController = null;
+        return;
+      }
+
+      // 设置用户信息
+      crispController?.register(
+        user: CrispUser(
+          email: identifier,
+          nickname: identifier,
+        ),
+      );
+
+      if (_kr_isDisposed) {
+        crispController = null;
+        return;
+      }
+
+      // 设置会话数据
+      crispController?.setSessionData({
+        'platform': Platform.isAndroid
+          ? 'android'
+          : Platform.isIOS
+            ? 'ios'
+            : Platform.isWindows
+              ? 'windows'
+              : Platform.isMacOS
+                ? 'macos'
+                : 'unknown',
+        'language': currentLanguage,
+        'app_version': '1.0.0',
+        'device_id': deviceId,
+      });
+
+      print('Crisp 初始化完成');
+    } catch (e) {
+      print('初始化 Crisp 时出错: $e');
+      crispController = null;
+      rethrow;
+    }
+  }
+
+  @override
+  void onClose() {
+    _kr_isDisposed = true;
+    kr_cleanupResources();
+    super.onClose();
+  }
+
+  /// 清理 Crisp 资源
+  Future<void> kr_cleanupResources() async {
+    try {
+      // 等待初始化完成
+      if (_kr_initializationCompleter != null && !_kr_initializationCompleter!.isCompleted) {
+        await _kr_initializationCompleter!.future;
+      }
+
+      if (kr_isInitialized.value) {
+        // 清理 Crisp 会话
+        crispController = null;
+        kr_isInitialized.value = false;
+        kr_isLoading.value = false;
+      }
+    } catch (e) {
+      print('清理 Crisp 资源时出错: $e');
+    }
+  }
+
+  /// 根据应用语言代码获取 Crisp locale
+  /// 支持应用中所有语言：中文、英文、西班牙语、繁体中文、日语、俄语、爱沙尼亚语
+  String _getLocaleForCrisp(String languageCode) {
+    // 映射应用语言到 Crisp 支持的 locale
+    switch (languageCode) {
+      case 'zh_CN':
+      case 'zh':
+        return 'zh'; // 简体中文
+      case 'zh_TW':
+      case 'zhHant':
+        return 'zh-tw'; // 繁体中文
+      case 'es':
+        return 'es'; // 西班牙语
+      case 'ja':
+        return 'ja'; // 日语
+      case 'ru':
+        return 'ru'; // 俄语
+      case 'et':
+        return 'et'; // 爱沙尼亚语
+      case 'en':
+      default:
+        return 'en'; // 英语（默认）
+    }
+  }
+}