72 lines
2.2 KiB
Dart
72 lines
2.2 KiB
Dart
import 'dart:async';
|
||
|
||
import 'src/config/analytics_config.dart';
|
||
import 'src/core/analytics_core.dart';
|
||
import 'src/core/interceptors.dart';
|
||
import 'src/model/device_info.dart';
|
||
import 'src/model/recent_event_summary.dart';
|
||
import 'src/model/user_info.dart';
|
||
|
||
export 'src/config/analytics_config.dart';
|
||
export 'src/core/interceptors.dart';
|
||
export 'src/model/device_info.dart';
|
||
export 'src/model/event.dart';
|
||
export 'src/model/recent_event_summary.dart';
|
||
export 'src/model/user_info.dart';
|
||
|
||
/// 对外唯一入口（Facade）。
|
||
class Analytics {
|
||
Analytics._();
|
||
|
||
static final AnalyticsCore _core = AnalyticsCore();
|
||
|
||
static Future<void> init(AnalyticsConfig config) => _core.init(config);
|
||
|
||
static Future<void> track(
|
||
String eventType, {
|
||
Map<String, dynamic>? eventParams,
|
||
Map<String, dynamic>? customTags,
|
||
int? timestamp,
|
||
}) {
|
||
return _core.track(
|
||
eventType,
|
||
eventParams: eventParams,
|
||
customTags: customTags,
|
||
timestamp: timestamp,
|
||
);
|
||
}
|
||
|
||
static Future<void> setUser(UserInfo? userInfo) => _core.setUser(userInfo);
|
||
|
||
static Future<void> setDeviceInfo(DeviceInfo deviceInfo) =>
|
||
_core.setDeviceInfo(deviceInfo);
|
||
|
||
static Future<void> flush({bool force = false}) => _core.flush(force: force);
|
||
|
||
/// 当前本地缓存事件数量（用于调试/演示）。
|
||
static Future<int> cachedEventCount() => _core.cachedEventCount();
|
||
|
||
/// 最近事件摘要（用于调试面板）。
|
||
static Future<List<RecentEventSummary>> cachedRecentEvents({int limit = 20}) =>
|
||
_core.cachedRecentEvents(limit: limit);
|
||
|
||
/// Phase 2：手动触发一次配置刷新（默认强制刷新）。
|
||
static Future<void> refreshConfig({bool force = true}) =>
|
||
_core.refreshConfig(force: force);
|
||
|
||
/// Phase 3：立即上报一次 SDK 指标（调试/测试用）。
|
||
static Future<void> reportMetricsNow() => _core.reportMetricsNow();
|
||
|
||
/// Phase 3：注册事件拦截器。
|
||
static void addInterceptor(AnalyticsInterceptor interceptor) {
|
||
_core.addInterceptor(interceptor);
|
||
}
|
||
|
||
static void setDebug(bool enabled) {
|
||
unawaited(_core.setDebug(enabled));
|
||
}
|
||
|
||
/// 可选：当宿主确定不再需要 SDK 时调用。
|
||
static Future<void> dispose() => _core.dispose();
|
||
}
|