feat(sdk): 帧间隔 frameIntervalMs 配置化(默认 35ms,[0,500] clamp)
DuooomiBleConfig 新增 frameIntervalMs,BleProtocolService 构造期注入。 顺手清死代码 FrameConstants.frameIntervalNanos、修 sendFrames 0.035 字面量 (统一走 config)。demo 加可调输入框 + UserDefaults 持久化。 越界 warn 不抛错,使用点 min/max 兜底。 设计稿:docs/superpowers/specs/2026-05-20-frame-interval-config-design.md Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -18,6 +18,9 @@ public struct DuooomiBleConfig {
|
||||
public let aniFps: String
|
||||
/// 扫描时按设备蓝牙广播名前缀过滤(大小写不敏感)。**必填**,由集成方约定固件广播名前缀。
|
||||
public let scanNamePrefix: String
|
||||
/// 协议帧之间的发送间隔(毫秒)。合法区间 `[0, 500]`,越界仅 warn,使用点会 clamp。
|
||||
/// 集成方一般无需调整;调高用于排查接收端丢帧/拥塞。默认 35。
|
||||
public let frameIntervalMs: Int
|
||||
|
||||
public init(
|
||||
apiHost: URL = URL(string: "https://api.duooomi.com")!,
|
||||
@@ -27,7 +30,8 @@ public struct DuooomiBleConfig {
|
||||
aniWidth: Int = 360,
|
||||
aniHeight: Int = 360,
|
||||
aniFps: String = "24",
|
||||
scanNamePrefix: String
|
||||
scanNamePrefix: String,
|
||||
frameIntervalMs: Int = 35
|
||||
) {
|
||||
self.apiHost = apiHost
|
||||
self.apiKey = apiKey
|
||||
@@ -37,5 +41,9 @@ public struct DuooomiBleConfig {
|
||||
self.aniHeight = aniHeight
|
||||
self.aniFps = aniFps
|
||||
self.scanNamePrefix = scanNamePrefix
|
||||
if frameIntervalMs < 0 || frameIntervalMs > 500 {
|
||||
BleLog.w("frameIntervalMs=\(frameIntervalMs) out of [0,500], will clamp at use site", "Config")
|
||||
}
|
||||
self.frameIntervalMs = frameIntervalMs
|
||||
}
|
||||
}
|
||||
|
||||
@@ -110,7 +110,7 @@ public final class DuooomiBleSDK: NSObject {
|
||||
public init(config: DuooomiBleConfig) {
|
||||
self.config = config
|
||||
bleClient = BleClient()
|
||||
protocolService = BleProtocolService(client: bleClient)
|
||||
protocolService = BleProtocolService(client: bleClient, frameIntervalMs: config.frameIntervalMs)
|
||||
timeProvider = BeijingTimeProvider()
|
||||
deviceInfoService = DeviceInfoService(protocolService: protocolService, timeProvider: timeProvider)
|
||||
fileTransferService = FileTransferService(protocolService: protocolService)
|
||||
|
||||
@@ -16,8 +16,6 @@ public enum FrameConstants {
|
||||
public static let maxDataSize = 496
|
||||
public static let headerSize = 8
|
||||
public static let footerSize = 1
|
||||
/// Inter-frame delay in nanoseconds (35ms)
|
||||
public static let frameIntervalNanos: UInt64 = 35_000_000
|
||||
public static let screenSize = 360
|
||||
}
|
||||
|
||||
|
||||
@@ -10,6 +10,7 @@ final class BleProtocolService: BleClientDelegate {
|
||||
|
||||
weak var delegate: BleProtocolServiceDelegate?
|
||||
private let client: BleClient
|
||||
private let frameIntervalMs: Int
|
||||
private var isListening = false
|
||||
|
||||
/// 分包重组会话
|
||||
@@ -20,9 +21,10 @@ final class BleProtocolService: BleClientDelegate {
|
||||
|
||||
private var fragments: [String: FragmentSession] = [:]
|
||||
|
||||
init(client: BleClient) {
|
||||
init(client: BleClient, frameIntervalMs: Int) {
|
||||
self.client = client
|
||||
BleLog.i("Protocol service created", "Protocol")
|
||||
self.frameIntervalMs = frameIntervalMs
|
||||
BleLog.i("Protocol service created (frameIntervalMs=\(frameIntervalMs))", "Protocol")
|
||||
}
|
||||
|
||||
// MARK: - Start/Stop Listening
|
||||
@@ -90,8 +92,9 @@ final class BleProtocolService: BleClientDelegate {
|
||||
onProgress?(Double(index + 1) / Double(total))
|
||||
|
||||
if index + 1 < total {
|
||||
// Inter-frame delay 35ms
|
||||
DispatchQueue.global(qos: .userInitiated).asyncAfter(deadline: .now() + 0.035) {
|
||||
// Inter-frame delay from config (clamped to [0,500]ms)
|
||||
let delaySec = Double(min(max(self.frameIntervalMs, 0), 500)) / 1000.0
|
||||
DispatchQueue.global(qos: .userInitiated).asyncAfter(deadline: .now() + delaySec) {
|
||||
sendFrame(at: index + 1)
|
||||
}
|
||||
} else {
|
||||
|
||||
Reference in New Issue
Block a user