@rk911/tracker-sdk 1.7.15 → 1.7.17

package/native/ios/RKTrackerSDK.swift

@@ -1,168 +1,944 @@
-//
-//  RKTrackerSDK.swift
-//  RKTrackerSDK
-//  iOS Native Tracker SDK for tracker-sdk repo
-//
-
-import UIKit
-
-@objc public class RKTrackerSDK: NSObject {
-    @objc public static let shared = RKTrackerSDK()
-
-    private var serverUrl: String = ""
-    private var appId: String = "13" // 13: iOS App
-    private var sessionId: String = ""
-    private var deviceId: String = ""
-    private var userId: String = ""
-    private var phone: String = ""
-    private var storeName: String = ""
-    private var sequence: Int = 0
-
-    private let bgQueue = DispatchQueue(label: "cn.renruikeji.tracker.bgQueue", qos: .utility)
-    private var eventQueue: [[String: Any]] = []
-    private var flushTimer: Timer?
-
-    private override init() {
-        super.init()
-        self.sessionId = "ios_\(Int(Date().timeIntervalSince1970))_\(Int.random(in: 1000...9999))"
-    }
-
-    @objc public func initSDK(serverUrl: String, deviceId: String, userId: String, phone: String, storeName: String) {
-        if !serverUrl.contains("/api/point/task/trackBatch") {
-            if serverUrl.hasSuffix("/") {
-                self.serverUrl = serverUrl + "api/point/task/trackBatch"
-            } else {
-                self.serverUrl = serverUrl + "/api/point/task/trackBatch"
-            }
-        } else {
-            self.serverUrl = serverUrl
-        }
-        self.deviceId = deviceId.isEmpty ? (UIDevice.current.identifierForVendor?.uuidString ?? "") : deviceId
-        self.userId = userId
-        self.phone = phone
-        self.storeName = storeName
-
-        swizzleUIViewController()
-        startTimer()
-    }
-
-    @objc public func getSessionId() -> String {
-        return sessionId
-    }
-
-    @objc public func track(eventName: String, properties: [String: Any]?) {
-        bgQueue.async { [weak self] in
-            guard let self = self else { return }
-            var event = self.createBaseEvent(eventType: "custom", eventName: eventName)
-            if let props = properties, let jsonData = try? JSONSerialization.data(withJSONObject: props), let str = String(data: jsonData, encoding: .utf8) {
-                event["extraData"] = str
-            }
-            self.enqueueEvent(event)
-        }
-    }
-
-    @objc public func trackFrontUrl(frontUrl: String, elementId: String?, postParam: String?) {
-        bgQueue.async { [weak self] in
-            guard let self = self else { return }
-            var event = self.createBaseEvent(eventType: "click", eventName: "legacy_dadian")
-            event["frontUrl"] = frontUrl
-            if let elem = elementId { event["elementId"] = elem }
-            if let post = postParam { event["postParam"] = post }
-            self.enqueueEvent(event)
-        }
-    }
-
-    private func createBaseEvent(eventType: String, eventName: String) -> [String: Any] {
-        sequence += 1
-        var extra: [String: Any] = ["platform": "ios"]
-        if !phone.isEmpty { extra["phone"] = phone }
-        if !storeName.isEmpty { extra["storeName"] = storeName }
-        if !userId.isEmpty { extra["userId"] = userId }
-        var extraStr = ""
-        if let data = try? JSONSerialization.data(withJSONObject: extra), let str = String(data: data, encoding: .utf8) {
-            extraStr = str
-        }
-
-        var event: [String: Any] = [
-            "eventId": "e_\(Int(Date().timeIntervalSince1970 * 1000))_\(Int.random(in: 1000...9999))",
-            "eventType": eventType,
-            "eventName": eventName,
-            "timestamp": Int(Date().timeIntervalSince1970 * 1000),
-            "sequence": sequence,
-            "os": "iOS",
-            "extraData": extraStr
-        ]
-        return event
-    }
-
-    private func enqueueEvent(_ event: [String: Any]) {
-        eventQueue.append(event)
-        if eventQueue.count >= 20 {
-            flushAsync()
-        }
-    }
-
-    private func startTimer() {
-        DispatchQueue.main.async {
-            self.flushTimer = Timer.scheduledTimer(withTimeInterval: 5.0, repeats: true) { [weak self] _ in
-                self?.flushAsync()
-            }
-        }
-    }
-
-    @objc public func flushAsync() {
-        bgQueue.async { [weak self] in
-            guard let self = self, !self.eventQueue.isEmpty, !self.serverUrl.isEmpty else { return }
-            let batchEvents = self.eventQueue
-            self.eventQueue.removeAll()
-            self.sendBatch(events: batchEvents)
-        }
-    }
-
-    private func sendBatch(events: [[String: Any]]) {
-        guard let url = URL(string: serverUrl) else { return }
-        var request = URLRequest(url: url)
-        request.httpMethod = "POST"
-        request.setValue("application/json; charset=UTF-8", forHTTPHeaderField: "Content-Type")
-        request.setValue(appId, forHTTPHeaderField: "appId")
-        request.setValue(deviceId, forHTTPHeaderField: "deviceId")
-
-        let body: [String: Any] = [
-            "appId": Int(appId) ?? 13,
-            "sessionId": sessionId,
-            "deviceId": deviceId,
-            "userId": userId,
-            "phone": phone,
-            "storeName": storeName,
-            "platform": "ios",
-            "events": events
-        ]
-
-        guard let jsonData = try? JSONSerialization.data(withJSONObject: body) else { return }
-        request.httpBody = jsonData
-
-        let task = URLSession.shared.dataTask(with: request) { _, _, _ in }
-        task.resume()
-    }
-
-    // --- Swizzling for UIViewController Auto-Tracking ---
-    private func swizzleUIViewController() {
-        let originalSelector = #selector(UIViewController.viewDidAppear(_:))
-        let swizzledSelector = #selector(UIViewController.rk_viewDidAppear(_:))
-
-        guard let originalMethod = class_getInstanceMethod(UIViewController.self, originalSelector),
-              let swizzledMethod = class_getInstanceMethod(UIViewController.self, swizzledSelector) else { return }
-
-        method_exchangeImplementations(originalMethod, swizzledMethod)
-    }
-}
-
-extension UIViewController {
-    @objc func rk_viewDidAppear(_ animated: Bool) {
-        self.rk_viewDidAppear(animated)
-        let pageRoute = String(describing: type(of: self))
-        if !pageRoute.hasPrefix("UI") {
-            RKTrackerSDK.shared.track(eventName: "page_view", properties: ["pageRoute": pageRoute])
-        }
-    }
-}
+//
+//  RKTrackerSDK.swift
+//  RKTrackerSDK
+//  iOS Native Tracker SDK for renkangios project
+//
+
+import UIKit
+import Network
+import CoreTelephony
+
+public class RKNetworkMonitor: NSObject {
+    public static let shared = RKNetworkMonitor()
+    private let monitor = NWPathMonitor()
+    private let queue = DispatchQueue(label: "cn.renruikeji.tracker.networkMonitor", qos: .utility)
+    private var cachedType: String = "unknown"
+    private let lock = NSLock()
+
+    private override init() {
+        super.init()
+        monitor.pathUpdateHandler = { [weak self] path in
+            self?.updateNetworkType(path: path)
+        }
+        monitor.start(queue: queue)
+    }
+
+    private func updateNetworkType(path: NWPath) {
+        lock.lock()
+        defer { lock.unlock() }
+        if path.status != .satisfied {
+            cachedType = "none"
+            return
+        }
+        if path.usesInterfaceType(.wifi) {
+            cachedType = "wifi"
+            return
+        }
+        if path.usesInterfaceType(.wiredEthernet) {
+            cachedType = "ethernet"
+            return
+        }
+        if path.usesInterfaceType(.cellular) {
+            cachedType = getCellularType()
+            return
+        }
+        cachedType = "other"
+    }
+
+    private func getCellularType() -> String {
+        let info = CTTelephonyNetworkInfo()
+        var radioTech: String?
+        if #available(iOS 12.0, *) {
+            radioTech = info.serviceCurrentRadioAccessTechnology?.values.first
+        } else {
+            radioTech = info.currentRadioAccessTechnology
+        }
+        guard let tech = radioTech else { return "4g" }
+        if #available(iOS 14.1, *) {
+            if tech == CTRadioAccessTechnologyNR || tech == CTRadioAccessTechnologyNRNSA {
+                return "5g"
+            }
+        }
+        switch tech {
+        case CTRadioAccessTechnologyLTE:
+            return "4g"
+        case CTRadioAccessTechnologyWCDMA,
+             CTRadioAccessTechnologyHSDPA,
+             CTRadioAccessTechnologyHSUPA,
+             CTRadioAccessTechnologyCDMA1x,
+             CTRadioAccessTechnologyCDMAEVDORev0,
+             CTRadioAccessTechnologyCDMAEVDORevA,
+             CTRadioAccessTechnologyCDMAEVDORevB,
+             CTRadioAccessTechnologyeHRPD:
+            return "3g"
+        case CTRadioAccessTechnologyGPRS,
+             CTRadioAccessTechnologyEdge:
+            return "2g"
+        default:
+            return "4g"
+        }
+    }
+
+    public func currentNetworkType() -> String {
+        lock.lock()
+        let val = cachedType
+        lock.unlock()
+        if val != "unknown" {
+            return val
+        }
+        if monitor.currentPath.usesInterfaceType(.wifi) {
+            return "wifi"
+        }
+        if monitor.currentPath.usesInterfaceType(.cellular) {
+            return "4g"
+        }
+        if monitor.currentPath.status == .satisfied {
+            return "other"
+        }
+        return "none"
+    }
+}
+
+@objc public class RKTrackerSDK: NSObject {
+    @objc public static let shared = RKTrackerSDK()
+
+    private var serverUrl: String = "https://state.renruikeji.cn/api/point/task/trackBatch"
+    private var appId: String = "13" // 13: iOS App
+    private var sessionId: String = ""
+    private var deviceId: String = ""
+    private var userId: String = ""
+    private var phone: String = ""
+    private var storeName: String = ""
+    private var userName: String = ""
+    private var pflag: Int = -1
+    private var platformName: String = ""
+    private var sequence: Int = 0
+
+    private var currentPageRoute: String = ""
+    private var currentPageTitle: String = ""
+    private var referrerPageRoute: String = ""
+    private var lastPageStartTime: TimeInterval = 0
+
+    private var lastClickKey: String = ""
+    private var lastClickTime: TimeInterval = 0
+
+    private let bgQueue = DispatchQueue(label: "cn.renruikeji.tracker.bgQueue", qos: .utility)
+    private var eventQueue: [[String: Any]] = []
+    private var flushTimer: Timer?
+    private let maxDiskRecords = 1000
+    private let cacheFileName = "rk_tracker_events_cache.json"
+
+    private static let friendlyTitles: [String: String] = [
+        "RRHomeVC": "APP主页/首页Tab",
+        "RRHomeRecommendVC": "首页推荐精选",
+        "RRBaseWebViewController": "通用Web容器",
+        "RRBaseWebViewController/circle": "发光者",
+        "RRBaseWebViewController/shop": "商城",
+        "RRVideoContainerVC": "小视频推荐",
+        "RRMineVC": "个人中心/我的",
+        "RRLoginVC": "登录页",
+        "RRLoginViewController": "登录页",
+        "RRLoginSelectViewController": "登录选择页",
+        "RRLoginPhoneVC": "手机号验证码登录",
+        "RRLoginPhoneVericodeViewController": "手机号验证码登录",
+        "RRLoginBindPhoneViewController": "绑定手机号",
+        "RRLoginBindPhoneMultipleViewController": "多账号绑定手机号",
+        "RRLoginChangePhoneViewController": "更换手机号",
+        "RRWebviewVC": "Web视图",
+        "RRSettingVC": "设置页",
+        "QRCodeScanVC": "扫码页",
+        "RRShortVideoHomeVideoViewController": "小视频首页",
+        "RRShortVideoRecommendVC": "小视频推荐",
+        "RRShortVideoCollectionVC": "小视频合集",
+        "RRShortVideoCollectionVideoViewController": "小视频合集播放",
+        "RRShortVideoFocusVC": "小视频关注",
+        "RRShortVideoNewbieTaskVideoViewController": "新人任务视频",
+        "RRRecreationVideoContainerViewController": "娱乐视频聚合页",
+        "RRRecreationVideoPageViewController": "娱乐视频分页",
+        "RRRecreationVideoViewController": "娱乐视频列表",
+        "RRPlayletHistoryContainerViewController": "短剧历史记录",
+        "RRPlayletHistoryViewController": "短剧历史列表",
+        "RRPlayletHistoryPageViewController": "短剧历史分页",
+        "RRPlayletPlayViewController": "短剧播放页",
+        "RRPlayletSiftViewController": "短剧精选",
+        "RRPlayletSiftPageViewController": "短剧精选分页",
+        "RRRlayletSiftContainerViewController": "短剧精选容器",
+        "PLVECPlayerViewController": "直播间播放页",
+        "PLVECWatchRoomViewController": "直播观看室",
+        "PLVCommodityDetailViewController": "直播商品详情",
+        "PLVECPlaybackListViewController": "直播回放列表",
+        "RRVistorHomeViewController": "游客首页",
+        "RRVistorGoodsViewController": "游客商品页",
+        "RRVistorMineViewController": "游客个人中心",
+        "RRVistorTabBarViewController": "游客主导航"
+    ]
+
+    private override init() {
+        super.init()
+        _ = RKNetworkMonitor.shared // 预热网络监听
+        let savedSession = UserDefaults.standard.string(forKey: "rr_app_session_id")
+        if let s = savedSession, !s.isEmpty {
+            self.sessionId = s
+        } else {
+            self.sessionId = "ios_\(Int(Date().timeIntervalSince1970))_\(Int.random(in: 1000...9999))"
+            UserDefaults.standard.set(self.sessionId, forKey: "rr_app_session_id")
+        }
+        loadDiskEvents()
+    }
+
+    @objc public func initSDK(serverUrl: String, deviceId: String, userId: String, phone: String, storeName: String, userName: String = "") {
+        if !serverUrl.contains("/api/point/task/trackBatch") {
+            if serverUrl.hasSuffix("/") {
+                self.serverUrl = serverUrl + "api/point/task/trackBatch"
+            } else {
+                self.serverUrl = serverUrl + "/api/point/task/trackBatch"
+            }
+        } else {
+            self.serverUrl = serverUrl
+        }
+
+        self.deviceId = deviceId.isEmpty ? (UIDevice.current.identifierForVendor?.uuidString ?? "") : deviceId
+        self.userId = userId
+        self.phone = phone
+        self.storeName = storeName
+        self.userName = userName
+
+        swizzleUIViewController()
+        swizzleUIApplication()
+        startTimer()
+
+        // 记录 App 启动/冷启动事件（对齐 Android Splash 生命周期）
+        trackCustom(eventName: "app_launch", elementText: "冷启动", properties: ["isColdStart": true])
+
+        flushAsync()
+    }
+
+    @objc public func updateUser(userId: String?, phone: String?, storeName: String?, userName: String?) {
+        if let u = userId { self.userId = u }
+        if let p = phone { self.phone = p }
+        if let s = storeName { self.storeName = s }
+        if let n = userName { self.userName = n }
+    }
+
+    @objc public func setPlatform(pflag: Int, platformName: String?) {
+        self.pflag = pflag
+        let raw = platformName ?? ""
+        self.platformName = raw.removingPercentEncoding ?? raw
+    }
+
+    @objc public func resetSession() {
+        self.sequence = 0
+        self.sessionId = "ios_\(Int(Date().timeIntervalSince1970))_\(Int.random(in: 1000...9999))"
+        UserDefaults.standard.set(self.sessionId, forKey: "rr_app_session_id")
+    }
+
+    @objc public func getSessionId() -> String {
+        return sessionId
+    }
+
+    @objc public func getDeviceId() -> String {
+        return deviceId.isEmpty ? (UIDevice.current.identifierForVendor?.uuidString ?? "") : deviceId
+    }
+
+    @objc public func getUserId() -> String {
+        return userId
+    }
+
+    @objc public func getPhone() -> String {
+        return phone
+    }
+
+    @objc public func getStoreName() -> String {
+        return storeName
+    }
+
+    @objc public func getUserName() -> String {
+        return userName
+    }
+
+    @objc public func getPflag() -> Int {
+        return pflag
+    }
+
+    @objc public func getPlatformName() -> String {
+        return platformName
+    }
+
+    @objc public func getCurrentPageRoute() -> String {
+        return currentPageRoute
+    }
+
+    @objc public func updateH5PageState(h5Route: String, h5Title: String) {
+        bgQueue.async { [weak self] in
+            guard let self = self, !h5Route.isEmpty else { return }
+            self.referrerPageRoute = self.currentPageRoute
+            self.currentPageRoute = h5Route
+            self.currentPageTitle = h5Title
+            self.lastPageStartTime = Date().timeIntervalSince1970
+        }
+    }
+
+    @objc public func getCurrentSequence() -> Int {
+        return sequence
+    }
+
+    @objc public func getNetworkType() -> String {
+        return RKNetworkMonitor.shared.currentNetworkType()
+    }
+
+    @objc public func getNormalizedSystemVersion() -> String {
+        let ver = ProcessInfo.processInfo.operatingSystemVersion
+        if ver.majorVersion >= 10 && ver.majorVersion < 25 {
+            if ver.patchVersion > 0 {
+                return "\(ver.majorVersion).\(ver.minorVersion).\(ver.patchVersion)"
+            }
+            return "\(ver.majorVersion).\(ver.minorVersion)"
+        }
+        let sys = UIDevice.current.systemVersion
+        return sys.isEmpty ? "16.0" : sys
+    }
+
+    @objc public func getExactDeviceModel() -> String {
+        var systemInfo = utsname()
+        uname(&systemInfo)
+        let machineMirror = Mirror(reflecting: systemInfo.machine)
+        let identifier = machineMirror.children.reduce("") { identifier, element in
+            guard let value = element.value as? Int8, value != 0 else { return identifier }
+            return identifier + String(UnicodeScalar(UInt8(value)))
+        }
+        if identifier.isEmpty {
+            return UIDevice.current.model
+        }
+        let modelMap: [String: String] = [
+            "iPhone10,1": "iPhone 8", "iPhone10,4": "iPhone 8",
+            "iPhone10,2": "iPhone 8 Plus", "iPhone10,5": "iPhone 8 Plus",
+            "iPhone10,3": "iPhone X", "iPhone10,6": "iPhone X",
+            "iPhone11,2": "iPhone XS",
+            "iPhone11,4": "iPhone XS Max", "iPhone11,6": "iPhone XS Max",
+            "iPhone11,8": "iPhone XR",
+            "iPhone12,1": "iPhone 11",
+            "iPhone12,3": "iPhone 11 Pro",
+            "iPhone12,5": "iPhone 11 Pro Max",
+            "iPhone12,8": "iPhone SE (2nd gen)",
+            "iPhone13,1": "iPhone 12 mini",
+            "iPhone13,2": "iPhone 12",
+            "iPhone13,3": "iPhone 12 Pro",
+            "iPhone13,4": "iPhone 12 Pro Max",
+            "iPhone14,4": "iPhone 13 mini",
+            "iPhone14,5": "iPhone 13",
+            "iPhone14,2": "iPhone 13 Pro",
+            "iPhone14,3": "iPhone 13 Pro Max",
+            "iPhone14,6": "iPhone SE (3rd gen)",
+            "iPhone14,7": "iPhone 14",
+            "iPhone14,8": "iPhone 14 Plus",
+            "iPhone15,2": "iPhone 14 Pro",
+            "iPhone15,3": "iPhone 14 Pro Max",
+            "iPhone15,4": "iPhone 15",
+            "iPhone15,5": "iPhone 15 Plus",
+            "iPhone16,1": "iPhone 15 Pro",
+            "iPhone16,2": "iPhone 15 Pro Max",
+            "iPhone17,3": "iPhone 16",
+            "iPhone17,4": "iPhone 16 Plus",
+            "iPhone17,1": "iPhone 16 Pro",
+            "iPhone17,2": "iPhone 16 Pro Max",
+            "i386": "iPhone Simulator",
+            "x86_64": "iPhone Simulator",
+            "arm64": "iPhone Simulator"
+        ]
+        return modelMap[identifier] ?? identifier
+    }
+
+    @objc public func getFriendlyTitle(for route: String) -> String {
+        if let name = RKTrackerSDK.friendlyTitles[route] {
+            return name
+        }
+        for (k, v) in RKTrackerSDK.friendlyTitles {
+            if route == k || route.hasPrefix(k) { return v }
+        }
+        // 语义化降级兜底
+        if route.contains("ShortVideo") || route.contains("Recommend") { return "小视频推荐" }
+        if route.contains("PlayletHistory") { return "短剧历史" }
+        if route.contains("PlayletPlay") { return "短剧播放页" }
+        if route.contains("Playlet") { return "短剧" }
+        if route.contains("Video") { return "视频页" }
+        if route.contains("Live") || route.contains("PLV") { return "直播" }
+        if route.contains("Login") { return "登录" }
+        if route.contains("Mine") { return "个人中心" }
+        if route.contains("Scan") { return "扫码页" }
+        if route.contains("Web") { return "Web视图" }
+        return route
+    }
+
+    @objc public func getNativeContextJson() -> String {
+        let dict: [String: Any] = [
+            "appId": appId,
+            "deviceId": getDeviceId(),
+            "userId": userId,
+            "phone": phone,
+            "sessionId": sessionId,
+            "appVersion": Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String ?? "1.0.0",
+            "platform": "ios",
+            "os": "iOS",
+            "brand": "Apple",
+            "deviceBrand": "Apple",
+            "model": "iPhone",
+            "deviceModel": getExactDeviceModel(),
+            "osVersion": getNormalizedSystemVersion(),
+            "networkType": getNetworkType(),
+            "currentSequence": sequence,
+            "pflag": pflag,
+            "pFlagName": platformName
+        ]
+        if let data = try? JSONSerialization.data(withJSONObject: dict), let str = String(data: data, encoding: .utf8) {
+            return str
+        }
+        return "{}"
+    }
+
+    @objc public func track(eventName: String, properties: [String: Any]?) {
+        trackCustom(eventName: eventName, elementText: nil, properties: properties)
+    }
+
+    @objc public func trackCustom(eventName: String, elementText: String?, properties: [String: Any]?) {
+        bgQueue.async { [weak self] in
+            guard let self = self else { return }
+            var event = self.createBaseEvent(eventType: "custom", eventName: eventName)
+            if let txt = elementText, !txt.isEmpty {
+                event["elementText"] = txt
+            }
+            if let props = properties {
+                var extra: [String: Any] = self.buildBaseExtra()
+                for (k, v) in props { extra[k] = v }
+                if let data = try? JSONSerialization.data(withJSONObject: extra), let str = String(data: data, encoding: .utf8) {
+                    event["extraData"] = str
+                }
+            }
+            self.enqueueEvent(event)
+            self.flushAsync()
+        }
+    }
+
+    @objc public func trackPageView(pageRoute: String, pageTitle: String) {
+        bgQueue.async { [weak self] in
+            guard let self = self else { return }
+            let now = Date().timeIntervalSince1970
+            // 500ms 内相同路由防抖，避免生命周期和手动调用重复触发
+            if pageRoute == self.currentPageRoute && (now - self.lastPageStartTime < 0.5) {
+                return
+            }
+            self.referrerPageRoute = self.currentPageRoute
+            self.currentPageRoute = pageRoute
+            let title = pageTitle.isEmpty ? self.getFriendlyTitle(for: pageRoute) : pageTitle
+            self.currentPageTitle = title
+            self.lastPageStartTime = now
+
+            var event = self.createBaseEvent(eventType: "page_view", eventName: "page_view")
+            event["pageRoute"] = pageRoute
+            event["pageTitle"] = title
+            self.enqueueEvent(event)
+            self.flushAsync()
+        }
+    }
+
+    @objc public func trackPageStay(pageRoute: String, pageTitle: String, durationMs: Int64) {
+        guard durationMs >= 500 else { return }
+        bgQueue.async { [weak self] in
+            guard let self = self else { return }
+            var event = self.createBaseEvent(eventType: "page_stay", eventName: "page_stay")
+            event["pageRoute"] = pageRoute
+            let title = pageTitle.isEmpty ? self.getFriendlyTitle(for: pageRoute) : pageTitle
+            event["pageTitle"] = title
+            event["duration"] = durationMs
+            self.enqueueEvent(event)
+            self.flushAsync()
+        }
+    }
+
+    @objc public func trackVideo(eventName: String, videoId: Int64, videoTitle: String?, customProperties: [String: Any]?) {
+        bgQueue.async { [weak self] in
+            guard let self = self else { return }
+            if eventName == "video_play_end", let props = customProperties {
+                let dur = (props["playDurationMs"] as? NSNumber)?.int64Value ?? (props["playDurationMs"] as? Int64 ?? 0)
+                let reason = (props["endReason"] as? String) ?? ""
+                if dur < 200 && reason == "refresh_list" {
+                    return
+                }
+            }
+            var event = self.createBaseEvent(eventType: "video", eventName: eventName)
+            event["elementId"] = "video_\(videoId)"
+            if let title = videoTitle, !title.isEmpty {
+                event["elementText"] = title
+            } else {
+                event["elementText"] = "video_\(videoId)"
+            }
+            if let props = customProperties {
+                if let pr = props["pageRoute"] as? String, !pr.isEmpty {
+                    event["pageRoute"] = pr
+                }
+                if let pt = props["pageTitle"] as? String, !pt.isEmpty {
+                    event["pageTitle"] = pt
+                }
+            }
+            var extra: [String: Any] = self.buildBaseExtra()
+            extra["videoId"] = videoId
+            if let title = videoTitle { extra["videoTitle"] = title }
+            if let props = customProperties {
+                for (k, v) in props { extra[k] = v }
+                if let dur = (props["playDurationMs"] as? NSNumber)?.int64Value {
+                    event["duration"] = dur
+                } else if let dur = props["playDurationMs"] as? Int64 {
+                    event["duration"] = dur
+                }
+            }
+            if let data = try? JSONSerialization.data(withJSONObject: extra), let str = String(data: data, encoding: .utf8) {
+                event["extraData"] = str
+            }
+            self.enqueueEvent(event)
+            self.flushAsync()
+        }
+    }
+
+    @objc public func trackVideoComment(videoId: Int64, videoTitle: String?, commentText: String?, customProperties: [String: Any]?) {
+        var props = customProperties ?? [:]
+        props["content"] = commentText ?? ""
+        trackVideo(eventName: "video_comment", videoId: videoId, videoTitle: videoTitle, customProperties: props)
+    }
+
+    @objc public func trackApi(url: String, method: String, statusCode: Int, duration: Int64, reqParam: String?, respData: String?, error: String?) {
+        guard !url.isEmpty, !url.contains("/api/point/task/trackBatch") else { return }
+        bgQueue.async { [weak self] in
+            guard let self = self else { return }
+            let isError = statusCode >= 400 || (error != nil && !error!.isEmpty)
+            let eventType = isError ? "api_error" : "api_request"
+            let apiPath = self.extractApiPath(url)
+            var event = self.createBaseEvent(eventType: eventType, eventName: apiPath)
+
+            var extra: [String: Any] = self.buildBaseExtra()
+            extra["url"] = url
+            extra["apiPath"] = apiPath
+            extra["method"] = method.uppercased()
+            extra["statusCode"] = statusCode
+            extra["duration"] = duration
+            if let req = reqParam { extra["requestParams"] = String(req.prefix(2048)) }
+            if let resp = respData { extra["responseData"] = String(resp.prefix(2048)) }
+            if let err = error { extra["error"] = String(err.prefix(512)) }
+            let reqId = self.extractRequestIdSafe(reqParam, respData)
+            if !reqId.isEmpty {
+                extra["requestId"] = reqId
+            }
+
+            if let data = try? JSONSerialization.data(withJSONObject: extra), let str = String(data: data, encoding: .utf8) {
+                event["extraData"] = str
+            }
+            self.enqueueEvent(event)
+            if isError {
+                self.flushAsync()
+            }
+        }
+    }
+
+    private func extractRequestIdSafe(_ reqParam: String?, _ respData: String?) -> String {
+        for str in [reqParam, respData] {
+            guard let text = str, text.contains("requestId") else { continue }
+            if let regex = try? NSRegularExpression(pattern: "\"requestId\"\\s*:\\s*\"([^\"]+)\"", options: []) {
+                let nsString = text as NSString
+                if let match = regex.firstMatch(in: text, options: [], range: NSRange(location: 0, length: nsString.length)), match.numberOfRanges > 1 {
+                    let r = match.range(at: 1)
+                    if r.location != NSNotFound {
+                        return nsString.substring(with: r)
+                    }
+                }
+            }
+        }
+        return ""
+    }
+
+    @objc public func trackFrontUrl(frontUrl: String, elementId: String?, postParam: String?) {
+        bgQueue.async { [weak self] in
+            guard let self = self else { return }
+            let eventType = "custom"
+            let targetId = !frontUrl.isEmpty ? frontUrl : (elementId ?? "")
+            var event = self.createBaseEvent(eventType: eventType, eventName: targetId)
+            event["frontUrl"] = targetId
+            event["elementId"] = targetId
+            if let post = postParam, !post.isEmpty {
+                event["postParam"] = post
+                event["extraKey"] = "param"
+                event["extraValue"] = post
+                var extra = self.buildBaseExtra()
+                extra["param"] = post
+                extra["getParam"] = post
+                extra["postParam"] = post
+                if let data = try? JSONSerialization.data(withJSONObject: extra), let str = String(data: data, encoding: .utf8) {
+                    event["extraData"] = str
+                }
+            }
+            self.enqueueEvent(event)
+            self.flushAsync()
+        }
+    }
+
+    @objc public func handleNativeControlClick(control: UIControl, action: Selector, event: UIEvent?) {
+        // 过滤非点击结束状态（避免 touchDown、touchDragInside 等多次误触发）
+        if let touch = event?.allTouches?.first {
+            if touch.phase != .ended && touch.phase != .cancelled {
+                return
+            }
+        }
+
+        // 忽略纯文本输入框聚焦等事件
+        if control is UITextField || control is UITextView {
+            return
+        }
+
+        // 提取 elementId
+        var elementId = control.accessibilityIdentifier ?? ""
+        if elementId.isEmpty {
+            let actName = NSStringFromSelector(action).replacingOccurrences(of: ":", with: "")
+            if !actName.isEmpty {
+                elementId = actName
+            } else if control.tag > 0 {
+                elementId = "tag_\(control.tag)"
+            } else {
+                elementId = String(describing: type(of: control))
+            }
+        }
+
+        // 提取 elementText
+        var elementText = ""
+        if let btn = control as? UIButton {
+            elementText = btn.currentTitle ?? btn.titleLabel?.text ?? ""
+        }
+        if elementText.isEmpty {
+            elementText = findTextInView(control)
+        }
+        elementText = elementText.trimmingCharacters(in: .whitespacesAndNewlines)
+        if elementText.count > 30 {
+            elementText = String(elementText.prefix(30))
+        }
+
+        let key = "\(elementId)|\(elementText)"
+        let now = Date().timeIntervalSince1970
+        if key == lastClickKey && (now - lastClickTime < 0.8) {
+            return
+        }
+        lastClickKey = key
+        lastClickTime = now
+
+        let touchLocation = event?.allTouches?.first?.location(in: nil) ?? control.center
+        let pageX = touchLocation.x
+        let pageY = touchLocation.y
+        let viewType = String(describing: type(of: control))
+
+        bgQueue.async { [weak self] in
+            guard let self = self else { return }
+            var clickEvent = self.createBaseEvent(eventType: "click", eventName: "native_click")
+            clickEvent["elementId"] = elementId
+            if !elementText.isEmpty {
+                clickEvent["elementText"] = elementText
+            }
+            var extra = self.buildBaseExtra()
+            extra["viewType"] = viewType
+            extra["pageX"] = pageX
+            extra["pageY"] = pageY
+            extra["isNative"] = true
+            if let data = try? JSONSerialization.data(withJSONObject: extra), let str = String(data: data, encoding: .utf8) {
+                clickEvent["extraData"] = str
+            }
+            self.enqueueEvent(clickEvent)
+            self.flushAsync()
+        }
+    }
+
+    private func findTextInView(_ view: UIView) -> String {
+        for sub in view.subviews {
+            if let label = sub as? UILabel, let t = label.text, !t.isEmpty {
+                return t
+            }
+            let child = findTextInView(sub)
+            if !child.isEmpty {
+                return child
+            }
+        }
+        return ""
+    }
+
+    private func buildBaseExtra() -> [String: Any] {
+        var extra: [String: Any] = ["platform": "ios"]
+        if !phone.isEmpty { extra["phone"] = phone }
+        if !storeName.isEmpty { extra["storeName"] = storeName }
+        if !userName.isEmpty { extra["userName"] = userName }
+        if !userId.isEmpty { extra["userId"] = userId }
+        if pflag != -1 { extra["pflag"] = pflag }
+        if !platformName.isEmpty { extra["platformName"] = platformName }
+        return extra
+    }
+
+    private func createBaseEvent(eventType: String, eventName: String) -> [String: Any] {
+        sequence += 1
+        var extraStr = ""
+        let extra = buildBaseExtra()
+        if let data = try? JSONSerialization.data(withJSONObject: extra), let str = String(data: data, encoding: .utf8) {
+            extraStr = str
+        }
+
+        var event: [String: Any] = [
+            "eventId": "e_\(Int(Date().timeIntervalSince1970 * 1000))_\(Int.random(in: 1000...9999))",
+            "eventType": eventType,
+            "eventName": eventName,
+            "timestamp": Int(Date().timeIntervalSince1970 * 1000),
+            "sequence": sequence,
+            "sessionId": sessionId,
+            "os": "iOS",
+            "deviceBrand": "Apple",
+            "deviceModel": getExactDeviceModel(),
+            "osVersion": getNormalizedSystemVersion(),
+            "networkType": getNetworkType(),
+            "extraData": extraStr
+        ]
+        if !userId.isEmpty { event["userId"] = userId }
+        if !currentPageRoute.isEmpty {
+            event["pageRoute"] = currentPageRoute
+            let title = !currentPageTitle.isEmpty ? currentPageTitle : getFriendlyTitle(for: currentPageRoute)
+            if !title.isEmpty {
+                event["pageTitle"] = title
+            }
+        }
+        if !referrerPageRoute.isEmpty {
+            event["referrer"] = referrerPageRoute
+        }
+        return event
+    }
+
+    private func extractApiPath(_ url: String) -> String {
+        guard let u = URL(string: url) else { return url }
+        return u.path
+    }
+
+    // --- Persistence & Queue ---
+    private func enqueueEvent(_ event: [String: Any]) {
+        eventQueue.append(event)
+        saveDiskEvents()
+        if eventQueue.count >= 20 {
+            flushAsync()
+        }
+    }
+
+    private func getCacheFilePath() -> URL? {
+        FileManager.default.urls(for: .cachesDirectory, in: .userDomainMask).first?.appendingPathComponent(cacheFileName)
+    }
+
+    private func saveDiskEvents() {
+        guard let path = getCacheFilePath() else { return }
+        let toSave = Array(eventQueue.suffix(maxDiskRecords))
+        if let data = try? JSONSerialization.data(withJSONObject: toSave) {
+            try? data.write(to: path)
+        }
+    }
+
+    private func loadDiskEvents() {
+        guard let path = getCacheFilePath(), let data = try? Data(contentsOf: path),
+              let list = try? JSONSerialization.jsonObject(with: data) as? [[String: Any]] else { return }
+        eventQueue = list
+    }
+
+    private func startTimer() {
+        DispatchQueue.main.async {
+            self.flushTimer?.invalidate()
+            let timer = Timer(timeInterval: 3.0, repeats: true) { [weak self] _ in
+                self?.flushAsync()
+            }
+            RunLoop.main.add(timer, forMode: .common)
+            self.flushTimer = timer
+        }
+    }
+
+    @objc public func flushAsync() {
+        bgQueue.async { [weak self] in
+            self?.flushInternal()
+        }
+    }
+
+    @objc public func flushSync() {
+        let semaphore = DispatchSemaphore(value: 0)
+        bgQueue.async { [weak self] in
+            self?.flushInternal()
+            semaphore.signal()
+        }
+        _ = semaphore.wait(timeout: .now() + 1.5)
+    }
+
+    private func flushInternal() {
+        guard !eventQueue.isEmpty, !serverUrl.isEmpty else { return }
+        var batchCount = 0
+        while !eventQueue.isEmpty && batchCount < 5 {
+            batchCount += 1
+            let count = min(eventQueue.count, 20)
+            let batch = Array(eventQueue.prefix(count))
+            let success = sendBatchSync(events: batch)
+            if success {
+                eventQueue.removeFirst(count)
+                saveDiskEvents()
+            } else {
+                break
+            }
+        }
+    }
+
+    private func sendBatchSync(events: [[String: Any]]) -> Bool {
+        guard let url = URL(string: serverUrl) else { return false }
+        var request = URLRequest(url: url)
+        request.httpMethod = "POST"
+        request.setValue("application/json; charset=UTF-8", forHTTPHeaderField: "Content-Type")
+        request.setValue(appId, forHTTPHeaderField: "appId")
+        request.setValue(getDeviceId(), forHTTPHeaderField: "deviceId")
+        request.timeoutInterval = 5.0
+
+        var batchSessionId = sessionId
+        var batchUserId = userId
+        if let first = events.first {
+            if let s = first["sessionId"] as? String, !s.isEmpty { batchSessionId = s }
+            if let u = first["userId"] as? String, !u.isEmpty { batchUserId = u }
+        }
+
+        let body: [String: Any] = [
+            "appId": Int(appId) ?? 13,
+            "sessionId": batchSessionId,
+            "deviceId": getDeviceId(),
+            "userId": batchUserId,
+            "phone": phone,
+            "storeName": storeName,
+            "userName": userName,
+            "platform": "ios",
+            "networkType": getNetworkType(),
+            "events": events
+        ]
+        if pflag != -1 {
+            var mBody = body
+            mBody["pflag"] = pflag
+            if !platformName.isEmpty { mBody["platformName"] = platformName }
+            guard let jsonData = try? JSONSerialization.data(withJSONObject: mBody) else { return false }
+            request.httpBody = jsonData
+        } else {
+            guard let jsonData = try? JSONSerialization.data(withJSONObject: body) else { return false }
+            request.httpBody = jsonData
+        }
+
+        let semaphore = DispatchSemaphore(value: 0)
+        var success = false
+
+        let task = URLSession.shared.dataTask(with: request) { _, response, error in
+            if error == nil, let http = response as? HTTPURLResponse, (200...299).contains(http.statusCode) {
+                success = true
+            }
+            semaphore.signal()
+        }
+        task.resume()
+        _ = semaphore.wait(timeout: .now() + 5.0)
+        return success
+    }
+
+    // --- Swizzling for UIViewController Auto-Tracking ---
+    private func swizzleUIViewController() {
+        let appearSelector = #selector(UIViewController.viewDidAppear(_:))
+        let swizzledAppear = #selector(UIViewController.rk_viewDidAppear(_:))
+        if let orig = class_getInstanceMethod(UIViewController.self, appearSelector),
+           let swiz = class_getInstanceMethod(UIViewController.self, swizzledAppear) {
+            method_exchangeImplementations(orig, swiz)
+        }
+
+        let disappearSelector = #selector(UIViewController.viewDidDisappear(_:))
+        let swizzledDisappear = #selector(UIViewController.rk_viewDidDisappear(_:))
+        if let orig = class_getInstanceMethod(UIViewController.self, disappearSelector),
+           let swiz = class_getInstanceMethod(UIViewController.self, swizzledDisappear) {
+            method_exchangeImplementations(orig, swiz)
+        }
+    }
+
+    // --- Swizzling for UIControl / UIButton Auto-Click Tracking (对齐 Android native_click) ---
+    private func swizzleUIApplication() {
+        let sendActionSelector = #selector(UIApplication.sendAction(_:to:from:for:))
+        let swizzledSendAction = #selector(UIApplication.rk_sendAction(_:to:from:for:))
+        if let orig = class_getInstanceMethod(UIApplication.self, sendActionSelector),
+           let swiz = class_getInstanceMethod(UIApplication.self, swizzledSendAction) {
+            method_exchangeImplementations(orig, swiz)
+        }
+    }
+}
+
+private var rkPageStartTimeKey: UInt8 = 0
+
+extension UIViewController {
+    var rkPageStartTime: TimeInterval {
+        get { (objc_getAssociatedObject(self, &rkPageStartTimeKey) as? TimeInterval) ?? 0 }
+        set { objc_setAssociatedObject(self, &rkPageStartTimeKey, newValue, .OBJC_ASSOCIATION_RETAIN_NONATOMIC) }
+    }
+
+    private func rkShouldTrackPage() -> Bool {
+        if self is UINavigationController || self is UITabBarController {
+            return false
+        }
+        let clsName = String(describing: type(of: self))
+        if clsName.hasPrefix("UI") || clsName.hasPrefix("_") {
+            return false
+        }
+        // 彻底过滤 iOS 15+ 预热机制（Prewarming）及系统快照/预览伪页面
+        if clsName.contains("Prewarming") || clsName.contains("Preview") || clsName.contains("Snapshot") {
+            return false
+        }
+        // 过滤系统辅助/键盘相关临时控制器
+        if clsName.contains("InputWindow") || clsName.contains("Compatibility") || clsName.contains("Alert") {
+            return false
+        }
+        let ignoredContainers = [
+            "CYLMainRootViewController",
+            "MainTabBarController",
+            "RRBaseNavigationController",
+            "RRHomeRecommendPageController"
+        ]
+        if ignoredContainers.contains(clsName) {
+            return false
+        }
+        return true
+    }
+
+    @objc func rk_viewDidAppear(_ animated: Bool) {
+        self.rk_viewDidAppear(animated)
+        guard self.rkShouldTrackPage() else { return }
+        var pageRoute = String(describing: type(of: self))
+        if let baseWeb = self as? NSObject, baseWeb.responds(to: Selector(("rrTag"))),
+           let tag = baseWeb.value(forKey: "rrTag") as? String, !tag.isEmpty {
+            pageRoute = "\(pageRoute)/\(tag)"
+        }
+        self.rkPageStartTime = Date().timeIntervalSince1970
+        let friendly = RKTrackerSDK.shared.getFriendlyTitle(for: pageRoute)
+        RKTrackerSDK.shared.trackPageView(pageRoute: pageRoute, pageTitle: friendly)
+    }
+
+    @objc func rk_viewDidDisappear(_ animated: Bool) {
+        self.rk_viewDidDisappear(animated)
+        guard self.rkShouldTrackPage() else { return }
+        var pageRoute = String(describing: type(of: self))
+        if let baseWeb = self as? NSObject, baseWeb.responds(to: Selector(("rrTag"))),
+           let tag = baseWeb.value(forKey: "rrTag") as? String, !tag.isEmpty {
+            pageRoute = "\(pageRoute)/\(tag)"
+        }
+        if self.rkPageStartTime > 0 {
+            let durMs = Int64((Date().timeIntervalSince1970 - self.rkPageStartTime) * 1000)
+            if durMs >= 500 {
+                let friendly = RKTrackerSDK.shared.getFriendlyTitle(for: pageRoute)
+                RKTrackerSDK.shared.trackPageStay(pageRoute: pageRoute, pageTitle: friendly, durationMs: durMs)
+            }
+            self.rkPageStartTime = 0
+        }
+    }
+}
+
+extension UIApplication {
+    @objc func rk_sendAction(_ action: Selector, to target: Any?, from sender: Any?, for event: UIEvent?) -> Bool {
+        if let control = sender as? UIControl {
+            RKTrackerSDK.shared.handleNativeControlClick(control: control, action: action, event: event)
+        }
+        return self.rk_sendAction(action, to: target, from: sender, for: event)
+    }
+}