Fix false Triki confirms in Quiz and category menus.

Restrict paddle-mode primaryAction to the BLE button edge, add TrikiButtonConfirmGate with cooldown, and document preferButtonConfirm plus adaptive BLE input updates across SDK, sample app, and docs.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: koderhack

VeltoKit/GameInput.swift

@@ -59,6 +59,16 @@ public struct GameInput {
   public var gesturePrimed: Bool = false
   /// Stores `pointerDirection` used by this scope.
   public var pointerDirection: PointerDirection = .center
+  /// Wykryty tryb BLE notify (fast / normal / lowPower).
+  public var bleMode: TrikiBLEMode = .unknown
+  /// Δ`posX` od poprzedniej klatki `pollInput` (SDK).
+  public var frameDeltaX: Double = 0
+  /// Δ`posY` od poprzedniej klatki `pollInput` (SDK).
+  public var frameDeltaY: Double = 0
+  /// Prędkość z `TrikiMotionEngine` (nie mylić z `intensity` silnika pozycji).
+  public var trikiVelocity: Double = 0
+  /// Czy gamepad Triki wykrywa ruch w tej ramce.
+  public var isMoving: Bool = false
 
   /// Przycisk / impuls strzału (gry typu Dart — edge w logice gry).
   public var didShoot: Bool { primaryAction || shotTriggered }
@@ -99,6 +109,11 @@ public struct GameInput {
   ///   - throwPower: Siła rzutu gestem.
   ///   - gesturePrimed: Stan uzbrojenia gestu.
   ///   - pointerDirection: Kierunek wskaźnika.
+  ///   - bleMode: Tryb BLE notify.
+  ///   - frameDeltaX: Δ posX między klatkami.
+  ///   - frameDeltaY: Δ posY między klatkami.
+  ///   - trikiVelocity: Prędkość gamepada Triki.
+  ///   - isMoving: Ruch wykryty przez Triki.
   public init(
     moveX: Double = 0,
     moveY: Double = 0,
@@ -127,7 +142,12 @@ public struct GameInput {
     shotTriggered: Bool = false,
     throwPower: Double = 0,
     gesturePrimed: Bool = false,
-    pointerDirection: PointerDirection = .center
+    pointerDirection: PointerDirection = .center,
+    bleMode: TrikiBLEMode = .unknown,
+    frameDeltaX: Double = 0,
+    frameDeltaY: Double = 0,
+    trikiVelocity: Double = 0,
+    isMoving: Bool = false
   ) {
     self.moveX = moveX
     self.moveY = moveY
@@ -157,5 +177,10 @@ public struct GameInput {
     self.throwPower = throwPower
     self.gesturePrimed = gesturePrimed
     self.pointerDirection = pointerDirection
+    self.bleMode = bleMode
+    self.frameDeltaX = frameDeltaX
+    self.frameDeltaY = frameDeltaY
+    self.trikiVelocity = trikiVelocity
+    self.isMoving = isMoving
   }
 }

VeltoKit/Motion/MotionParser.swift

@@ -14,11 +14,11 @@ final class MotionParser: ObservableObject {
   var retainRecentFrames = true
 
   /// Czas wygładzania kanału tilt.
-  var tiltAlpha: Double = 0.18
+  var tiltAlpha: Double = 1.0
   /// Czas wygładzania kanału gyro.
-  var gyroAlpha: Double = 0.32
+  var gyroAlpha: Double = 1.0
   /// Czas wygładzania kanału rotacji.
-  var rotationAlpha: Double = 0.22
+  var rotationAlpha: Double = 1.0
   /// Minimalna zmiana potrzebna do aktualizacji wartości.
   var noiseFloor: Double = 0.001
 

VeltoKit/MotionConfig.swift

@@ -149,7 +149,7 @@ public struct MotionConfig: Equatable, Sendable {
       cfg.axisMapping.invertX = false
       cfg.axisMapping.invertY = true
       cfg.referenceDriftEnabled = false
-      cfg.inputSmoothing = 0
+      cfg.inputSmoothing = 1.0
       cfg.deadzone = 0
       cfg.pointerSensitivity = 0
       cfg.pointerRotDamping = 1
@@ -160,10 +160,10 @@ public struct MotionConfig: Equatable, Sendable {
       cfg.paddleAutoCalibBlend = 0.015
       cfg.paddleAutoCalibMaxSteer = 0.06
       cfg.paddleAutoCalibEnabled = true
-      cfg.paddleSmoothRetain = 0.58
-      cfg.paddleSmoothBlend = 0.42
-      cfg.paddleSmoothRetainIdle = 0.76
-      cfg.paddleRawSmoothing = 0.22
+      cfg.paddleSmoothRetain = 0
+      cfg.paddleSmoothBlend = 1
+      cfg.paddleSmoothRetainIdle = 0
+      cfg.paddleRawSmoothing = 1.0
       cfg.paddleSmoothMax = 2
       cfg.paddleRawDivisor = 100
       cfg.paddleRawDeadband = 8
@@ -190,19 +190,20 @@ public struct MotionConfig: Equatable, Sendable {
       cfg.deadzone = 0.02
       cfg.pointerSensitivity = 0.03
       cfg.pointerRotDamping = 0.98
-      cfg.pointerOutputSmoothing = 0.15
+      cfg.pointerOutputSmoothing = 0
+      cfg.inputSmoothing = 1.0
     case .gesture:
       cfg.sensorInput = .gyro
       cfg.axisMapping.inputX = .gyroY
       cfg.axisMapping.inputY = .gyroX
       cfg.axisMapping.invertX = false
       cfg.axisMapping.invertY = true
       cfg.referenceDriftEnabled = false
-      cfg.inputSmoothing = 0.35
+      cfg.inputSmoothing = 1.0
       cfg.deadzone = 0.02
       cfg.pointerSensitivity = 0.045
       cfg.pointerRotDamping = 0.96
-      cfg.pointerOutputSmoothing = 0.22
+      cfg.pointerOutputSmoothing = 0
       cfg.gestureThreshold = 0.28
       cfg.gestureCooldown = 0.45
       cfg.gestureMinRelY = 0.10

VeltoKit/MotionProcessor.swift

@@ -138,12 +138,20 @@ final class MotionProcessor {
 
     let scale = max(0.001, frameScale)
     if stableInput != 0 {
-      let retain = pow(config.paddleSmoothRetain, scale)
-      smoothX = smoothX * retain + stableInput * (1 - retain)
+      if config.paddleSmoothBlend >= 1, config.paddleSmoothRetain <= 0 {
+        smoothX = stableInput
+      } else {
+        let retain = pow(config.paddleSmoothRetain, scale)
+        smoothX = smoothX * retain + stableInput * (1 - retain)
+      }
     } else {
-      let retainIdle = pow(config.paddleSmoothRetainIdle, scale)
-      smoothX *= retainIdle
-      if abs(smoothX) < 0.02 { smoothX = 0 }
+      if config.paddleSmoothRetainIdle <= 0 {
+        smoothX = 0
+      } else {
+        let retainIdle = pow(config.paddleSmoothRetainIdle, scale)
+        smoothX *= retainIdle
+        if abs(smoothX) < 0.02 { smoothX = 0 }
+      }
     }
 
     let cap = max(0.1, config.paddleSmoothMax)

VeltoKit/MotionSDK+Connection.swift

@@ -8,8 +8,15 @@ extension MotionSDK {
   /// Skan BLE + auto-connect do jedynego urządzenia z „triki” w nazwie.
   public func connect() {
     ensureBLEPipeline()
-    bleManager?.autoConnectWhenSingleLikelyMatch = true
-    bleManager?.startScan(clearList: true)
+    trikiController?.ble.autoConnectWhenSingleLikelyMatch = true
+    trikiController?.connect()
+  }
+
+  /// Ponowne połączenie z ostatnim zapamiętanym urządzeniem (bez pełnego skanu).
+  public func connectLastDevice() {
+    ensureBLEPipeline()
+    trikiController?.ble.autoConnectWhenSingleLikelyMatch = false
+    trikiController?.ble.connectCachedPeripheralIfAvailable()
   }
 
   /// Zamyka połączenie BLE i czyści stan sesji.
@@ -35,21 +42,23 @@ extension MotionSDK {
     }
 
     let now = Date().timeIntervalSince1970
-    if now - lastPacketAt > 0.35, isReceiving { isReceiving = false }
+    let stale = trikiBLEMode.packetStaleSeconds
+    if now - lastPacketAt > stale, isReceiving { isReceiving = false }
+    syncTrikiPublishedState()
 
     if config.mode == .paddle {
       parser.refreshTiltSensors()
       parser.flushImpulsesOnly()
       let impulses = parser.consumeImpulses()
       let out = updateFrame(deltaTime: deltaTime)
-      var enriched = input
-      enriched.tiltY = parser.sensors.tiltY
-      enriched.tiltX = parser.sensors.tiltX
-      enriched.lateral = out.x
-      enriched.lateralSmooth = out.x
-      enriched.shake = impulses.shake || (trikiController?.gameInput.isShake ?? false)
-      enriched.sensors = parser.sensors
-      applyClickToSensors(&enriched)
+      var enriched = makeEnrichedGameInput(
+        output: out,
+        sdkInput: input,
+        parser: parser,
+        impulses: impulses
+      )
+      applyTrikiGamepadSignals(&enriched)
+      finalizeAdaptiveInput(&enriched)
       latestEnrichedInput = enriched
       publishLiveInputIfNeeded(now: now, input: enriched)
       return enriched
@@ -63,14 +72,17 @@ extension MotionSDK {
     )
     let out = updateFrame(deltaTime: deltaTime)
     let impulses = parser.consumeImpulses()
-    latestEnrichedInput = makeEnrichedGameInput(
+    var enriched = makeEnrichedGameInput(
       output: out,
       sdkInput: input,
       parser: parser,
       impulses: impulses
     )
-    publishLiveInputIfNeeded(now: now, input: latestEnrichedInput)
-    return latestEnrichedInput
+    applyTrikiGamepadSignals(&enriched)
+    finalizeAdaptiveInput(&enriched)
+    latestEnrichedInput = enriched
+    publishLiveInputIfNeeded(now: now, input: enriched)
+    return enriched
   }
 
   /// Pobiera ostatnią wzbogaconą ramkę wejścia bez aktualizacji stanu.
@@ -125,6 +137,17 @@ extension MotionSDK {
   /// Czyści bufor logów BLE.
   public func clearBLEDevLog() { bleManager?.devRawLog.removeAll() }
 
+  /// Czy zapisano UUID ostatniego urządzenia (szybkie ponowne połączenie).
+  public var hasCachedBLEDevice: Bool {
+    bleManager?.cachedPeripheralUUID != nil
+  }
+
+  /// Log monitora trybu BLE (Δt między pakietami).
+  public var debugBLEMonitorLogging: Bool {
+    get { trikiController?.debugBLEMonitorLogging ?? false }
+    set { trikiController?.debugBLEMonitorLogging = newValue }
+  }
+
   // MARK: - Private
 
   /// Handles `ensureBLEPipeline`.
@@ -145,7 +168,6 @@ extension MotionSDK {
         self.enqueueBLE(bytes)
         self.streamParser?.enqueue(data: bytes)
         self.lastPacketAt = Date().timeIntervalSince1970
-        if !self.isReceiving { self.isReceiving = true }
       }
       .store(in: &bleCancellables)
 
@@ -156,6 +178,32 @@ extension MotionSDK {
         if !connected { self?.resetConnectionState() }
       }
       .store(in: &bleCancellables)
+
+    triki.$bleMode
+      .removeDuplicates()
+      .sink { [weak self] mode in
+        self?.trikiBLEMode = mode
+      }
+      .store(in: &bleCancellables)
+
+    triki.$idleStatusMessage
+      .sink { [weak self] message in
+        self?.trikiIdleStatusMessage = message
+      }
+      .store(in: &bleCancellables)
+
+    triki.$isReceiving
+      .removeDuplicates()
+      .sink { [weak self] receiving in
+        self?.isReceiving = receiving
+      }
+      .store(in: &bleCancellables)
+  }
+
+  func syncTrikiPublishedState() {
+    guard let triki = trikiController else { return }
+    trikiBLEMode = triki.getBLEMode()
+    trikiIdleStatusMessage = triki.idleStatusMessage
   }
 
   /// Handles `resetConnectionState`.
@@ -166,7 +214,11 @@ extension MotionSDK {
     liveInput = GameInput()
     latestEnrichedInput = GameInput()
     isReceiving = false
+    trikiBLEMode = .unknown
+    trikiIdleStatusMessage = nil
     lastHudPublishAt = 0
+    lastFramePosX = nil
+    lastFramePosY = nil
   }
 
   /// Mapuje wyjście gamepada na silnik pozycji (bez surowych osi w API gry).
@@ -184,13 +236,16 @@ extension MotionSDK {
   /// Handles `refreshLiveInputFromEngine`.
   func refreshLiveInputFromEngine() {
     let out = output
-    latestEnrichedInput = makeEnrichedGameInput(
+    var enriched = makeEnrichedGameInput(
       output: out,
       sdkInput: input,
       parser: streamParser,
       impulses: (false, false)
     )
-    liveInput = latestEnrichedInput
+    applyTrikiGamepadSignals(&enriched)
+    finalizeAdaptiveInput(&enriched)
+    latestEnrichedInput = enriched
+    liveInput = enriched
     lastHudPublishAt = Date().timeIntervalSince1970
   }
 
@@ -205,6 +260,33 @@ extension MotionSDK {
     liveInput = input
   }
 
+  /// Applies Triki gamepad velocity/tilt edges to `GameInput` (all tryby gier).
+  func applyTrikiGamepadSignals(_ input: inout GameInput) {
+    guard let pad = trikiController?.gameInput else { return }
+    input.tiltLeft = pad.isTiltLeft
+    input.tiltRight = pad.isTiltRight
+    let vel = Double(pad.velocity)
+    input.trikiVelocity = vel
+    input.isMoving = pad.isMoving
+    input.intensity = max(input.intensity, vel)
+    input.flick = input.flick || pad.isSwing
+    let dir = Double(pad.direction)
+    if dir != 0, vel > 0.5 {
+      input.deltaX = dir * vel * 0.012
+    }
+  }
+
+  /// Uzupełnia `bleMode`, Δpos i strategię adaptacyjną dla gier.
+  func finalizeAdaptiveInput(_ input: inout GameInput) {
+    input.bleMode = trikiBLEMode
+    let prevX = lastFramePosX ?? input.posX
+    let prevY = lastFramePosY ?? input.posY
+    input.frameDeltaX = input.posX - prevX
+    input.frameDeltaY = input.posY - prevY
+    lastFramePosX = input.posX
+    lastFramePosY = input.posY
+  }
+
   /// Builds a UI/game-friendly input snapshot from raw engine output and parser state.
   ///
   /// - Parameters:
@@ -239,16 +321,19 @@ extension MotionSDK {
       enriched.sensors = parser.sensors
       enriched.pointerDirection = pointerDirection(posX: output.x, posY: output.y)
     }
-    applyClickToSensors(&enriched)
+    let buttonEdge = impulses.click || sdkInput.primaryAction
+    if config.mode == .paddle {
+      enriched.primaryAction = buttonEdge
+    } else if impulses.click {
+      enriched.primaryAction = true
+    }
+    applyClickToSensors(&enriched, clickEdge: buttonEdge)
     return enriched
   }
 
-  /// Handles `applyClickToSensors`.
-  ///
-  /// - Parameters:
-  ///   - input: Input used by this operation.
-  func applyClickToSensors(_ input: inout GameInput) {
-    guard input.primaryAction else { return }
+  /// Sets one-shot click flag on sensors when a BLE button edge was detected.
+  func applyClickToSensors(_ input: inout GameInput, clickEdge: Bool) {
+    guard clickEdge else { return }
     var sensors = input.sensors
     sensors.click = true
     input.sensors = sensors