HI-VPN/hi-client
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix: 修改客服

Browse Source
This commit is contained in:
speakeloudest
2026-01-09 01:36:24 -08:00
parent eb4fad64cb
commit ac65aaa227
12 changed files with 435 additions and 191 deletions
Download Patch File Download Diff File Expand all files Collapse all files
lib/app/modules/kr_crisp_chat/controllers/kr_crisp_controller.dart
+182 -80
View File
@@ -1,33 +1,45 @@
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 'package:kaer_with_panels/app/services/kr_site_config_service.dart';
import 'dart:async';
import '../../../services/kr_device_info_service.dart';
import 'package:flutter/foundation.dart';
/// Crisp 聊天控制器
// 移动平台使用原生 SDK
import 'package:crisp_chat/crisp_chat.dart' as native_crisp;
// 桌面平台使用 WebView SDK
import 'package:crisp_sdk/crisp_sdk.dart' as webview_crisp;
/// 🔧 P15 重构: Crisp 聊天控制器
/// - 移动平台 (Android/iOS): 使用 crisp_chat 原生 SDK，解决 WebView 黑屏问题
/// - 桌面平台 (macOS/Windows): 使用 crisp_sdk WebView 实现
class KRCrispController extends GetxController {
// Crisp 控制器
CrispController? crispController;
// ========== 移动平台 (原生 SDK) ==========
native_crisp.CrispConfig? _nativeConfig;
// 加载状态
final RxBool kr_isLoading = true.obs;
// 初始化完成状态
final RxBool kr_isInitialized = false.obs;
// 用于取消异步操作的订阅
// ========== 桌面平台 (WebView SDK) ==========
webview_crisp.CrispController? crispController;
Completer<void>? _kr_initializationCompleter;
bool _kr_isDisposed = false;
// ========== 共享状态 ==========
final RxBool kr_isLoading = true.obs;
final RxBool kr_isInitialized = false.obs;
/// 是否为移动平台
bool get _isMobilePlatform => Platform.isAndroid || Platform.isIOS;
@override
void onInit() {
super.onInit();
_kr_prepareInitialization();
if (_isMobilePlatform) {
_kr_prepareMobileConfig();
} else {
_kr_prepareDesktopInitialization();
}
}
@override
@@ -35,21 +47,104 @@ class KRCrispController extends GetxController {
super.onReady();
}
/// 准备初始化
Future<void> _kr_prepareInitialization() async {
// ==========================================
// 移动平台方法 (Android/iOS - 原生 SDK)
// ==========================================
/// 准备移动平台 Crisp 配置
void _kr_prepareMobileConfig() {
try {
kr_isLoading.value = false; // 原生 SDK 不需要加载状态
final appData = KRAppRunData();
final userEmail = appData.kr_account.value ?? '';
final deviceId = KRDeviceInfoService().deviceId ?? 'unknown';
final identifier = userEmail.isNotEmpty ? userEmail : deviceId;
// 创建原生 SDK 配置
_nativeConfig = native_crisp.CrispConfig(
websiteID: AppConfig.getInstance().kr_website_id,
user: native_crisp.User(
email: identifier,
nickName: identifier,
),
);
kr_isInitialized.value = true;
if (kDebugMode) {
print('[P15-Mobile] Crisp 原生 SDK 配置已准备');
}
} catch (e) {
if (kDebugMode) {
print('[P15-Mobile] 准备 Crisp 配置时出错: $e');
}
kr_isInitialized.value = false;
}
}
/// 打开原生 Crisp 聊天界面 (移动平台)
Future<void> kr_openNativeCrispChat() async {
if (_nativeConfig == null) {
if (kDebugMode) {
print('[P15-Mobile] Crisp 配置未准备好');
}
return;
}
try {
if (kDebugMode) {
print('[P15-Mobile] 正在打开 Crisp 原生聊天界面...');
}
await native_crisp.FlutterCrispChat.openCrispChat(config: _nativeConfig!);
// 设置会话数据
final currentLanguage = KRLanguageUtils.getCurrentLanguageCode();
final deviceId = KRDeviceInfoService().deviceId ?? 'unknown';
native_crisp.FlutterCrispChat.setSessionString(
key: 'platform',
value: Platform.isAndroid ? 'android' : 'ios',
);
native_crisp.FlutterCrispChat.setSessionString(
key: 'language',
value: currentLanguage,
);
native_crisp.FlutterCrispChat.setSessionString(
key: 'device_id',
value: deviceId,
);
if (kDebugMode) {
print('[P15-Mobile] Crisp 聊天界面已打开');
}
} catch (e) {
if (kDebugMode) {
print('[P15-Mobile] 打开 Crisp 聊天时出错: $e');
}
}
}
// ==========================================
// 桌面平台方法 (macOS/Windows - WebView SDK)
// ==========================================
/// 准备桌面平台初始化
Future<void> _kr_prepareDesktopInitialization() async {
if (_kr_isDisposed) return;
_kr_initializationCompleter = Completer<void>();
try {
kr_isLoading.value = true;
await kr_initializeCrisp();
await kr_initializeDesktopCrisp();
if (!_kr_isDisposed) {
kr_isInitialized.value = true;
}
} catch (e) {
if (kDebugMode) {
print('初始化 Crisp 时出错: $e');
print('[P15-Desktop] 初始化 Crisp 时出错: $e');
}
if (!_kr_isDisposed) {
kr_isInitialized.value = false;
@@ -62,34 +157,23 @@ class KRCrispController extends GetxController {
}
}
/// 初始化 Crisp
Future<void> kr_initializeCrisp() async {
/// 初始化桌面平台 Crisp (WebView)
Future<void> kr_initializeDesktopCrisp() async {
if (_kr_isDisposed) return;
try {
final appData = KRAppRunData();
final currentLanguage = KRLanguageUtils.getCurrentLanguageCode();
final userEmail = appData.kr_account.value ?? '';
// 获取设备 ID
final deviceId = KRDeviceInfoService().deviceId ?? 'unknown';
final identifier = userEmail.isNotEmpty ? userEmail : deviceId;
// 根据当前语言设置对应的 Crisp locale
// Crisp 支持的语言：https://docs.crisp.chat/guides/chatbox/languages/
String locale = _getLocaleForCrisp(currentLanguage);
if (_kr_isDisposed) return;
final websiteId = AppConfig.getInstance().kr_website_id;
if (websiteId.isEmpty) {
// 如果为空，打印错误日志并终止函数
print('Crisp 初始化失败：website_id 未配置');
return;
}
// 初始化 Crisp 控制器
crispController = CrispController(
// 初始化 WebView Crisp 控制器
crispController = webview_crisp.CrispController(
websiteId: AppConfig.getInstance().kr_website_id,
locale: locale,
);
@@ -101,7 +185,7 @@ class KRCrispController extends GetxController {
// 设置用户信息
crispController?.register(
user: CrispUser(
user: webview_crisp.CrispUser(
email: identifier,
nickname: identifier,
),
@@ -114,82 +198,100 @@ class KRCrispController extends GetxController {
// 设置会话数据
crispController?.setSessionData({
'platform': Platform.isAndroid
? 'android'
: Platform.isIOS
? 'ios'
: Platform.isWindows
? 'windows'
: Platform.isMacOS
? 'macos'
: 'unknown',
'platform': Platform.isWindows ? 'windows' : 'macos',
'language': currentLanguage,
'app_version': '1.0.0',
'device_id': deviceId,
});
if (kDebugMode) {
print('Crisp 初始化完成');
print('[P15-Desktop] Crisp WebView 初始化完成');
}
} catch (e) {
if (kDebugMode) {
print('初始化 Crisp 时出错: $e');
print('[P15-Desktop] 初始化 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) {
if (kDebugMode) {
print('清理 Crisp 资源时出错: $e');
}
}
}
/// 根据应用语言代码获取 Crisp locale
/// 支持应用中所有语言：中文、英文、西班牙语、繁体中文、日语、俄语、爱沙尼亚语
String _getLocaleForCrisp(String languageCode) {
// 映射应用语言到 Crisp 支持的 locale
switch (languageCode) {
case 'zh_CN':
case 'zh':
return 'zh'; // 简体中文
return 'zh';
case 'zh_TW':
case 'zhHant':
return 'zh-tw'; // 繁体中文
return 'zh-tw';
case 'es':
return 'es'; // 西班牙语
return 'es';
case 'ja':
return 'ja'; // 日语
return 'ja';
case 'ru':
return 'ru'; // 俄语
return 'ru';
case 'et':
return 'et'; // 爱沙尼亚语
return 'et';
case 'en':
default:
return 'en'; // 英语（默认）
return 'en';
}
}
// ==========================================
// 生命周期管理
// ==========================================
@override
void onClose() {
_kr_isDisposed = true;
if (_isMobilePlatform) {
// 移动平台：原生 SDK 无需手动清理
if (kDebugMode) {
print('[P15-Mobile] onClose - 原生 SDK 无需手动清理');
}
} else {
// 桌面平台：清理 WebView 资源
_kr_cleanupDesktopResources();
}
super.onClose();
}
/// 清理桌面平台资源
Future<void> _kr_cleanupDesktopResources() async {
try {
if (_kr_initializationCompleter != null &&
!_kr_initializationCompleter!.isCompleted) {
try {
await _kr_initializationCompleter!.future.timeout(
const Duration(milliseconds: 500),
onTimeout: () {
if (!_kr_initializationCompleter!.isCompleted) {
_kr_initializationCompleter!.complete();
}
},
);
} catch (e) {
// 忽略超时错误
}
}
if (kr_isInitialized.value || kr_isLoading.value) {
crispController = null;
kr_isInitialized.value = false;
kr_isLoading.value = false;
if (kDebugMode) {
print('[P15-Desktop] Crisp WebView 资源已清理');
}
}
} catch (e) {
if (kDebugMode) {
print('[P15-Desktop] 清理资源时出错: $e');
}
}
}
}