API 说明

TDEM tdem = TDEM.getInstance();   // 未初始化时返回 null

import com.tencent.tdem.core.TDEMInitListener;

TDEMInitListener listener = (started, remoteConfig) -> {
    // started：是否已进入采集态
    // remoteConfig：本次决策使用的远程配置；拉取耗尽且无缓存时为 null
};

TDEM.addInitListener(listener);
TDEM.removeInitListener(listener);

import java.util.HashMap;
import java.util.Map;

Map<String, String> tags = new HashMap<>();
tags.put("button_id", "submit");
Map<String, Object> properties = new HashMap<>();
properties.put("page", "/checkout");

tdem.track("button_click", tags, properties);

// 直接上报耗时（毫秒）
Map<String, String> tags = new HashMap<>();
tags.put("api", "/user/info");
tdem.measure("api_latency", 320, tags, new HashMap<String, Object>());

// 或使用计时器
tdem.startMeasure("render");
// ... 执行操作 ...
long duration = tdem.endMeasure("render");  // 返回耗时（ms），未找到 start 返回 -1

Map<String, Object> crashTags = new HashMap<>();
crashTags.put("module", "payment");
try {
    riskyOperation();
} catch (Exception e) {
    tdem.captureException(e, crashTags);
}


tdem.setUser("user-456");   // 设置用户
tdem.clearUser();           // 清除用户

tdem.setDeviceId("device-abc");   // 设置设备标识，由宿主提供
tdem.clearDeviceId();             // 清除设备标识，回落 not_set

Map<String, Object> tags = new HashMap<>();
tags.put("role", "admin");
tags.put("team", "dev");

tdem.setTags(tags);                              // 设置/追加标签
tdem.removeTags(Arrays.asList("team"));          // 移除指定标签
tdem.clearTags();                                // 清空所有标签

// 手动逻辑页（LIFO，覆盖自动 Activity/Fragment/Compose 页）
tdem.startPage("checkout");
tdem.leavePage();   // LIFO pop，栈空时幂等 no-op

// 替换当前逻辑页并发 page_view（navigation_type=replace，RN SPA 切页用）
tdem.setPage("/modal/confirm", "确认弹窗");

// 三参：额外指定本次页面浏览的 viewId（不传则每次 setPage 自动生成新的 UUID）
tdem.setPage("/modal/confirm", "确认弹窗", "confirm_dialog_v1");

import java.util.Map;

Map<String, Object> tags = tdem.getTags();
String pageUrl = tdem.getCurrentPageUrl();
String viewId = tdem.getCurrentViewId();
String sessionId = tdem.getCurrentSessionId();
String replayId = tdem.getCurrentReplayId();
String userId = tdem.getUserId();
String deviceId = tdem.getDeviceId();

// 业务主动上报自定义挣扎事件（无需理解或填写 owner）
Map<String, Object> props = new HashMap<>();
props.put("reason", "risk_rejected");
props.put("retry_count", 2);
Map<String, String> tags = new HashMap<>();
tags.put("channel", "checkout");

tdem.trackStruggle(
        "payment_declined",
        TDEMStruggleSeverity.HIGH,          // LOW(1) / MEDIUM(3) / HIGH(5)，默认 MEDIUM
        props,
        tags
);

// 直接上报 TDEMEvent 格式的事件（高级用法，SDK 会自动补齐 page_url、session_id 与 tags）
// 注意：eventId 在 Kotlin 有默认值（自动生成）；Java 主构造器不生成，必须自己传非空值，
//      传空串会原样上报成空的 event_id。
try {
    JSONObject data = new JSONObject();
    data.put("event_name", "my_event");

    tdem.reportTDEMEvent(new TDEMEvent(
            UUID.randomUUID().toString(),   // eventId：Java 侧必须显式给
            EventType.CUSTOM,
            EventCategory.CUSTOM,
            System.currentTimeMillis(),
            "",                             // pageUrl 留空则取当前页面
            "",                             // sessionId 留空则取当前会话
            data,
            "",                             // replayId
            ""                              // viewId
    ));
} catch (JSONException e) {
    // JSONObject.put 是受检异常
}

TDEM.endLaunch();

tdem.setUser("new-user");   // 动态修改用户标识
tdem.destroy();             // 销毁实例

import com.tencent.tdem.TDEM;
import com.tencent.tdem.TDEMConfiguration;
import com.tencent.tdem.core.TDEMCore;

String version = TDEMCore.SDK_VERSION;                      // 当前 SDK 版本号，如 "0.1.25"
new TDEMConfiguration.Builder(this).logLevel(TDEM.LEVEL_WARN);   // 日志级别，默认 WARN