feat: 源码提交
Build Windows / build (push) Has been cancelled

This commit is contained in:
2025-10-19 23:30:54 -07:00
parent 54e7df78db
commit 75d4c48e41
6076 changed files with 64655 additions and 0 deletions
@@ -0,0 +1,10 @@
import 'package:get/get.dart';
import '../controllers/kr_crisp_controller.dart';
/// Crisp 聊天绑定
class KRCrispBinding implements Bindings {
@override
void dependencies() {
Get.lazyPut<KRCrispController>(() => KRCrispController());
}
}
@@ -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'; // 英语(默认)
}
}
}
+141
View File
@@ -0,0 +1,141 @@
import 'package:flutter/material.dart';
import 'package:get/get.dart';
import 'package:crisp_sdk/crisp_sdk.dart';
import 'package:flutter_screenutil/flutter_screenutil.dart';
import '../controllers/kr_crisp_controller.dart';
import 'package:kaer_with_panels/app/localization/app_translations.dart';
import 'package:kaer_with_panels/app/widgets/kr_app_text_style.dart';
import '../../../widgets/kr_simple_loading.dart';
/// Crisp 客服聊天视图
class KRCrispView extends GetView<KRCrispController> {
const KRCrispView({Key? key}) : super(key: key);
@override
Widget build(BuildContext context) {
return PopScope(
onPopInvokedWithResult: (didPop, result) async {
if (didPop) {
await controller.kr_cleanupResources();
}
},
child: Scaffold(
backgroundColor: Theme.of(context).scaffoldBackgroundColor,
appBar: _kr_buildAppBar(context),
body: _kr_buildBody(context),
),
);
}
/// 构建导航栏
PreferredSizeWidget _kr_buildAppBar(BuildContext context) {
return AppBar(
backgroundColor: Theme.of(context).cardColor,
elevation: 0,
title: Text(
AppTranslations.kr_userInfo.customerService,
style: KrAppTextStyle(
color: Theme.of(context).textTheme.bodyMedium?.color,
fontSize: 16,
fontWeight: FontWeight.w500,
),
),
leading: IconButton(
icon: Icon(
Icons.arrow_back_ios,
size: 20.sp,
color: Theme.of(context).textTheme.bodyMedium?.color,
),
onPressed: () => _kr_handleBack(),
),
);
}
/// 构建主体内容
Widget _kr_buildBody(BuildContext context) {
return Container(
color: Theme.of(context).scaffoldBackgroundColor,
child: Obx(() {
if (controller.kr_isLoading.value) {
return _kr_buildLoadingView(context, '正在初始化客服系统...');
}
if (controller.kr_isInitialized.value && controller.crispController != null) {
return CrispView(
crispController: controller.crispController!,
clearCache: true,
onSessionIdReceived: _kr_onSessionIdReceived,
);
}
return _kr_buildErrorView(context);
}),
);
}
/// 构建加载视图
Widget _kr_buildLoadingView(BuildContext context, String message) {
return Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
KRSimpleLoading(
color: Colors.blue,
size: 50.0,
),
if (message.isNotEmpty) SizedBox(height: 16.sp),
if (message.isNotEmpty)
Text(
message,
style: KrAppTextStyle(
fontSize: 14,
color: Theme.of(context).textTheme.bodyMedium?.color,
),
),
],
),
);
}
/// 构建错误视图
Widget _kr_buildErrorView(BuildContext context) {
return Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
Icon(
Icons.error_outline,
size: 64.sp,
color: Colors.red,
),
SizedBox(height: 16.sp),
Text(
'客服系统初始化失败',
style: KrAppTextStyle(
fontSize: 16,
color: Colors.red,
),
),
SizedBox(height: 24.sp),
ElevatedButton(
onPressed: () {
controller.kr_initializeCrisp();
},
child: Text('重试'),
),
],
),
);
}
/// 处理返回事件
Future<void> _kr_handleBack() async {
await controller.kr_cleanupResources();
Get.back();
}
/// 处理会话 ID 接收事件
void _kr_onSessionIdReceived(String sessionId) {
debugPrint('Crisp 会话 ID: $sessionId');
}
}