@mentra/bluetooth-sdk 0.1.7 → 0.1.9

package/ios/Source/sgcs/MentraLive.swift

@@ -768,9 +768,12 @@ extension MentraLive: CBPeripheralDelegate {
             // Keep state as connecting until glasses are ready
             updateConnectionState(ConnTypes.CONNECTING)
 
-            // Request MTU size
-            let mtuSize = peripheral.maximumWriteValueLength(for: .withResponse)
-            Bridge.log("LIVE: Current MTU size: \(mtuSize + 3) bytes")
+            let withResponseMtu = peripheral.maximumWriteValueLength(for: .withResponse) + 3
+            let withoutResponseMtu = peripheral.maximumWriteValueLength(for: .withoutResponse) + 3
+            currentMtu = max(23, min(withResponseMtu, withoutResponseMtu))
+            Bridge.log(
+                "LIVE: Current MTU estimate: withResponse=\(withResponseMtu), withoutResponse=\(withoutResponseMtu), selected=\(currentMtu)"
+            )
 
             // Enable notifications on RX characteristic
             peripheral.setNotifyValue(true, for: rx)
@@ -1072,6 +1075,7 @@ class MentraLive: NSObject, SGCManager {
     private var connectedPeripheral: CBPeripheral?
     private var txCharacteristic: CBCharacteristic?
     private var rxCharacteristic: CBCharacteristic?
+    private let bes2700MtuLimit = 256
     private var currentMtu: Int = 23 // Default BLE MTU
 
     // State Tracking
@@ -1096,6 +1100,7 @@ class MentraLive: NSObject, SGCManager {
     // Queue Management
     private let commandQueue = CommandQueue()
     private let bluetoothQueue = DispatchQueue(label: "MentraLiveBluetooth", qos: .userInitiated)
+    private let incomingChunkReassembler = MessageChunkReassembler()
     private var lastSendTimeMs: TimeInterval = 0
 
     // Timers
@@ -1312,10 +1317,10 @@ class MentraLive: NSObject, SGCManager {
 
     func requestPhoto(
         _ requestId: String, appId: String, size: String?, webhookUrl: String?, authToken: String?,
-        compress: String?, flash: Bool, sound: Bool, exposureTimeNs: Double?
+        compress: String?, flash: Bool, sound: Bool, exposureTimeNs: Double?, iso: Int?
     ) {
         Bridge.log(
-            "LIVE: PHOTO PIPELINE [5/6] requestPhoto() entry requestId=\(requestId) appId=\(appId) flash=\(flash) sound=\(sound)"
+            "LIVE: PHOTO PIPELINE [5/6] requestPhoto() entry requestId=\(requestId) appId=\(appId) flash=\(flash) sound=\(sound) iso=\(iso.map { String($0) } ?? "auto")"
         )
 
         var json: [String: Any] = [
@@ -1367,6 +1372,10 @@ class MentraLive: NSObject, SGCManager {
             Bridge.log("LIVE: Using manual exposure time for photo request \(requestId): \(Int64(e)) ns")
             json["exposureTimeNs"] = Int64(e)
         }
+        if let iso, iso > 0 {
+            Bridge.log("LIVE: Using manual ISO for photo request \(requestId): ISO \(iso)")
+            json["iso"] = iso
+        }
 
         Bridge.log("LIVE: PHOTO PIPELINE [5b/6] take_photo JSON ready bleImgId=\(bleImgId) transferMethod=auto")
         Bridge.log("LIVE: PHOTO PIPELINE [6/6] Dispatching take_photo to sendJson()")
@@ -1777,6 +1786,11 @@ class MentraLive: NSObject, SGCManager {
         // Log ALL incoming JSON objects for debugging
         // Bridge.log("LIVE: DEBUG: processJsonObject: \(json)")
 
+        if MessageChunker.isChunkedMessage(json) {
+            processChunkedJsonObject(json)
+            return
+        }
+
         // Check for K900 command format
         if let command = json["C"] as? String {
             processK900JsonMessage(json)
@@ -1856,6 +1870,9 @@ class MentraLive: NSObject, SGCManager {
         case "stream_status":
             emitRtmpStreamStatus(json)
 
+        case "photo_status":
+            emitPhotoStatus(json)
+
         case "gallery_status":
             let photoCount = json["photos"] as? Int ?? 0
             let videoCount = json["videos"] as? Int ?? 0
@@ -2120,6 +2137,26 @@ class MentraLive: NSObject, SGCManager {
         }
     }
 
+    private func processChunkedJsonObject(_ json: [String: Any]) {
+        guard let info = MessageChunker.getChunkInfo(json) else {
+            Bridge.log("LIVE: Received malformed chunked message from glasses")
+            return
+        }
+
+        guard let reassembled = incomingChunkReassembler.addChunk(info) else {
+            return
+        }
+
+        guard let data = reassembled.data(using: .utf8),
+              let reassembledJson = try? JSONSerialization.jsonObject(with: data) as? [String: Any]
+        else {
+            Bridge.log("LIVE: Failed to parse reassembled chunked message")
+            return
+        }
+
+        processJsonObject(reassembledJson)
+    }
+
     /// Maps K900 gesture type codes to gesture names
     /// Compute the weighted overall OTA percentage for a BES progress event arriving via sr_adota.
     /// Mirrors the weight table in OtaSessionManager.computeStepWeights() on the glasses side.
@@ -2552,6 +2589,7 @@ class MentraLive: NSObject, SGCManager {
         Bridge.log("LIVE: 🎉 Received glasses_ready message - SOC is booted and ready!")
 
         stopReadinessCheckLoop()
+        sendBleMtuConfig()
 
         // Invalidate any version fields from a prior link session so the next version_info
         // cannot leave a stale build number in RN (ASG is source of truth for PackageInfo).
@@ -2799,8 +2837,12 @@ class MentraLive: NSObject, SGCManager {
         activeFileTransfers.removeValue(forKey: fileName)
 
         let bleImgId = fileName.split(separator: ".").first.map(String.init) ?? ""
-        if blePhotoTransfers.removeValue(forKey: bleImgId) != nil {
+        if let transfer = blePhotoTransfers.removeValue(forKey: bleImgId) {
             Bridge.log("LIVE: 🧹 Cleaned up timed out BLE photo transfer for: \(bleImgId)")
+            Bridge.sendPhotoError(
+                requestId: transfer.requestId, errorCode: "TRANSFER_TIMEOUT",
+                errorMessage: "Transfer timed out for: \(fileName)"
+            )
         }
         if bleIncidentLogRelays.removeValue(forKey: bleImgId) != nil {
             Bridge.log("LIVE: 🧹 Cleaned up timed out BLE incident log relay for: \(bleImgId)")
@@ -2822,8 +2864,11 @@ class MentraLive: NSObject, SGCManager {
         }
 
         Bridge.log("LIVE: ❌ Transfer failed for: \(fileName) (reason: \(reason))")
+        let bleImgId = fileName.split(separator: ".").first.map(String.init) ?? ""
+        let transfer = blePhotoTransfers[bleImgId]
+        let effectiveRequestId = requestId.isEmpty ? transfer?.requestId ?? "" : requestId
         Bridge.sendPhotoError(
-            requestId: requestId, errorCode: "TRANSFER_FAILED",
+            requestId: effectiveRequestId, errorCode: "TRANSFER_FAILED",
             errorMessage: "Transfer failed for: \(fileName) (reason: \(reason))"
         )
 
@@ -2833,7 +2878,6 @@ class MentraLive: NSObject, SGCManager {
             )
         }
 
-        let bleImgId = fileName.split(separator: ".").first.map(String.init) ?? ""
         if let transfer = blePhotoTransfers.removeValue(forKey: bleImgId) {
             Bridge.log(
                 "LIVE: 🧹 Cleaned up failed BLE photo transfer for: \(bleImgId) (requestId: \(transfer.requestId))"
@@ -2970,11 +3014,13 @@ class MentraLive: NSObject, SGCManager {
                             )
                             Bridge.log("❌ Telling glasses to retry entire transfer")
 
-                            // Tell glasses transfer failed, they will retry
+                            // Tell glasses transfer failed, they will retry. Keep the photo
+                            // transfer entry so the retry maps back to the original requestId.
                             sendTransferCompleteConfirmation(
                                 fileName: packetInfo.fileName, success: false
                             )
-                            blePhotoTransfers.removeValue(forKey: bleImgId)
+                            photoTransfer.session = nil
+                            blePhotoTransfers[bleImgId] = photoTransfer
                         }
                     }
                 }
@@ -3207,6 +3253,20 @@ class MentraLive: NSObject, SGCManager {
         )
     }
 
+    private func sendBleMtuConfig() {
+        let effectiveMtu = min(currentMtu, bes2700MtuLimit)
+        let json: [String: Any] = [
+            "type": "set_ble_mtu",
+            "mtu": effectiveMtu,
+            "timestamp": Int64(Date().timeIntervalSince1970 * 1000),
+        ]
+
+        sendJson(json)
+        Bridge.log(
+            "LIVE: Sent BLE MTU config to glasses: negotiated=\(currentMtu), BES2700 limit=\(bes2700MtuLimit), effective=\(effectiveMtu)"
+        )
+    }
+
     // MARK: - Sending Data
 
     func queueSend(_ data: Data, id: String) {
@@ -3857,6 +3917,10 @@ class MentraLive: NSObject, SGCManager {
         Bridge.sendTypedMessage("stream_status", body: json)
     }
 
+    private func emitPhotoStatus(_ json: [String: Any]) {
+        Bridge.sendPhotoStatus(json)
+    }
+
     private func emitButtonPress(buttonId: String, pressType: String, timestamp: Int64) {
         let eventBody: [String: Any] = [
             "device_model": "Mentra Live",
@@ -4739,7 +4803,7 @@ extension MentraLive {
 
         var json: [String: Any] = [
             "type": "start_video_recording",
-            "request_id": requestId,
+            "requestId": requestId,
             "save": save,
             "flash": flash,
             "sound": sound,
@@ -4766,7 +4830,7 @@ extension MentraLive {
 
         let json: [String: Any] = [
             "type": "stop_video_recording",
-            "request_id": requestId,
+            "requestId": requestId,
         ]
         sendJson(json)
     }

package/ios/Source/sgcs/MentraNex.swift

@@ -46,7 +46,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
 
     func requestPhoto(
         _: String, appId _: String, size _: String?, webhookUrl _: String?, authToken _: String?,
-        compress _: String?, flash _: Bool, sound _: Bool, exposureTimeNs _: Double?
+        compress _: String?, flash _: Bool, sound _: Bool, exposureTimeNs _: Double?, iso _: Int?
     ) {}
 
     func startStream(_: [String: Any]) {}

package/ios/Source/sgcs/SGCManager.swift

@@ -20,7 +20,7 @@ protocol SGCManager {
 
     func requestPhoto(
         _ requestId: String, appId: String, size: String?, webhookUrl: String?, authToken: String?,
-        compress: String?, flash: Bool, sound: Bool, exposureTimeNs: Double?
+        compress: String?, flash: Bool, sound: Bool, exposureTimeNs: Double?, iso: Int?
     )
     func startStream(_ message: [String: Any])
     func stopStream()

package/ios/Source/sgcs/Simulated.swift

@@ -75,7 +75,7 @@ class Simulated: SGCManager {
 
     // MARK: - Camera & Media
 
-    func requestPhoto(_: String, appId _: String, size _: String?, webhookUrl _: String?, authToken _: String?, compress _: String?, flash _: Bool, sound _: Bool, exposureTimeNs _: Double?) {
+    func requestPhoto(_: String, appId _: String, size _: String?, webhookUrl _: String?, authToken _: String?, compress _: String?, flash _: Bool, sound _: Bool, exposureTimeNs _: Double?, iso _: Int?) {
         Bridge.log("requestPhoto")
     }
 

package/ios/Source/utils/MessageChunkReassembler.swift

@@ -0,0 +1,89 @@
+import Foundation
+
+final class MessageChunkReassembler {
+    private static let chunkTimeoutMs: TimeInterval = 30_000
+    private static let maxConcurrentSessions = 10
+
+    private var activeSessions: [String: ChunkSession] = [:]
+
+    func addChunk(_ info: MessageChunker.ChunkInfo) -> String? {
+        cleanupTimedOutSessions()
+
+        if activeSessions.count >= Self.maxConcurrentSessions,
+           activeSessions[info.chunkId] == nil
+        {
+            removeOldestSession()
+        }
+
+        let session = activeSessions[info.chunkId] ?? ChunkSession(
+            chunkId: info.chunkId,
+            totalChunks: info.totalChunks
+        )
+        activeSessions[info.chunkId] = session
+
+        guard session.addChunk(index: info.chunkIndex, data: info.data) else {
+            print("MessageChunkReassembler: Failed to add chunk \(info.chunkIndex) for \(info.chunkId)")
+            return nil
+        }
+
+        guard session.isComplete else {
+            return nil
+        }
+
+        let reassembled = session.reassemble()
+        activeSessions.removeValue(forKey: info.chunkId)
+        print("MessageChunkReassembler: Reassembled \(reassembled.count) bytes from \(info.totalChunks) chunks")
+        return reassembled
+    }
+
+    func clear() {
+        activeSessions.removeAll()
+    }
+
+    private func cleanupTimedOutSessions() {
+        let now = Date().timeIntervalSince1970 * 1000
+        activeSessions = activeSessions.filter { entry in
+            now - entry.value.createdAtMs <= Self.chunkTimeoutMs
+        }
+    }
+
+    private func removeOldestSession() {
+        guard let oldest = activeSessions.min(by: { $0.value.createdAtMs < $1.value.createdAtMs }) else {
+            return
+        }
+        activeSessions.removeValue(forKey: oldest.key)
+    }
+
+    private final class ChunkSession {
+        let chunkId: String
+        let totalChunks: Int
+        let createdAtMs: TimeInterval
+        private var chunks: [Int: String] = [:]
+
+        init(chunkId: String, totalChunks: Int) {
+            self.chunkId = chunkId
+            self.totalChunks = totalChunks
+            self.createdAtMs = Date().timeIntervalSince1970 * 1000
+        }
+
+        func addChunk(index: Int, data: String) -> Bool {
+            guard index >= 0, index < totalChunks else {
+                return false
+            }
+            chunks[index] = data
+            return true
+        }
+
+        var isComplete: Bool {
+            chunks.count == totalChunks
+        }
+
+        func reassemble() -> String {
+            var result = ""
+            for index in 0 ..< totalChunks {
+                result += chunks[index] ?? ""
+            }
+            return result
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/bluetooth-sdk",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "SDK for communicating with smart glasses",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -17,6 +17,11 @@
       "react-native": "./src/react/index.ts",
       "default": "./build/react/index.js"
     },
+    "./photo-receiver": {
+      "types": "./build/photo-receiver/index.d.ts",
+      "react-native": "./src/photo-receiver/index.ts",
+      "default": "./build/photo-receiver/index.js"
+    },
     "./_private/*": null,
     "./build/*": null,
     "./src/*": null,

package/src/BluetoothSdk.types.ts

@@ -140,6 +140,43 @@ export type PhotoResponseEvent =
       errorMessage: string
     }
 
+export type PhotoStatusState =
+  | "accepted"
+  | "queued"
+  | "configuring"
+  | "capturing"
+  | "captured"
+  | "compressing"
+  | "uploading"
+  | "uploaded"
+  | "ready_for_transfer"
+  | "transferring"
+  | "failed"
+
+export type PhotoResolvedConfig = {
+  format?: "jpeg" | string
+  width?: number
+  height?: number
+  quality?: number
+  requestedSize?: PhotoSize | string
+  source?: "sdk" | "button" | string
+  transferMethod?: "webhook" | "ble" | "local" | string
+  compression?: PhotoCompression | string
+  saveToGallery?: boolean
+  exposureTimeNs?: number
+  iso?: number
+}
+
+export type PhotoStatusEvent = {
+  type: "photo_status"
+  requestId: string
+  status: PhotoStatusState | string
+  timestamp: number
+  resolvedConfig?: PhotoResolvedConfig
+  errorCode?: string
+  errorMessage?: string
+}
+
 export type GalleryStatusEvent = {
   type: "gallery_status"
   photos: number
@@ -221,16 +258,25 @@ export type DashboardMenuItem = {
   values?: Record<string, unknown>
 }
 
-export type CameraFov = "standard" | "wide"
+export const CAMERA_FOV_MIN = 82
+export const CAMERA_FOV_MAX = 118
+export const CAMERA_FOV_DEFAULT = 102
+
+export type CameraRoiPosition = 0 | 1 | 2
+
+export type CameraFov = {
+  fov: number
+  roiPosition?: CameraRoiPosition
+}
 
 export type CameraFovSetting = {
   fov: number
-  roiPosition: number
+  roiPosition: CameraRoiPosition
 }
 
 type NativeCameraFovSetting = {
   fov: number
-  roi_position: number
+  roi_position: CameraRoiPosition
 }
 
 export type MicPreference = "auto" | "phone" | "glasses" | "bluetooth"
@@ -245,6 +291,8 @@ export type PhotoRequestParams = {
   compress: PhotoCompression
   sound: boolean
   exposureTimeNs?: number | null
+  /** Sensor ISO for this capture only. Only used when exposureTimeNs enables manual exposure. */
+  iso?: number | null
 }
 
 export type StreamVideoConfig = {
@@ -340,58 +388,65 @@ export type StreamStatusLifecycleState = "initializing" | "streaming" | "stoppin
 export type StreamStatusReconnectState = "reconnecting" | "reconnected" | "reconnect_failed"
 export type StreamStatusState = StreamStatusLifecycleState | StreamStatusReconnectState | "error"
 
+export type StreamResolvedConfig = {
+  transport?: "rtmp" | "srt" | "whip"
+  video?: {
+    width: number
+    height: number
+    captureWidth?: number
+    captureHeight?: number
+    bitrate: number
+    fps: number
+  }
+  audio?: {
+    bitrate?: number
+    sampleRate?: number
+    echoCancellation?: boolean
+    noiseSuppression?: boolean
+  }
+}
+
+type StreamStatusCommon = {
+  type: "stream_status"
+  streamId?: string
+  timestamp?: number
+  resolvedConfig?: StreamResolvedConfig
+}
+
 export type StreamStatusEvent =
-  | {
-      type: "stream_status"
+  | (StreamStatusCommon & {
       kind: "lifecycle"
       status: StreamStatusLifecycleState
-      streamId?: string
-      timestamp?: number
-    }
-  | {
-      type: "stream_status"
+    })
+  | (StreamStatusCommon & {
       kind: "reconnect"
       status: "reconnecting"
-      streamId?: string
       attempt: number
       maxAttempts: number
       reason: string
-      timestamp?: number
-    }
-  | {
-      type: "stream_status"
+    })
+  | (StreamStatusCommon & {
       kind: "reconnect"
       status: "reconnected"
-      streamId?: string
       attempt: number
-      timestamp?: number
-    }
-  | {
-      type: "stream_status"
+    })
+  | (StreamStatusCommon & {
       kind: "reconnect"
       status: "reconnect_failed"
-      streamId?: string
       maxAttempts: number
-      timestamp?: number
-    }
-  | {
-      type: "stream_status"
+    })
+  | (StreamStatusCommon & {
       kind: "error"
       status: "error"
-      streamId?: string
       errorDetails: string
-      timestamp?: number
-    }
-  | {
-      type: "stream_status"
+    })
+  | (StreamStatusCommon & {
       kind: "snapshot"
       status: "streaming" | "reconnecting" | "stopped"
       streaming: boolean
       reconnecting: boolean
-      streamId?: string
       attempt?: number
-      timestamp?: number
-    }
+    })
 
 export type KeepAliveAckEvent = {
   type: "keep_alive_ack"
@@ -479,6 +534,7 @@ export type BluetoothSdkModuleEvents = {
   hotspot_status_change: (event: HotspotStatusChangeEvent) => void
   hotspot_error: (event: HotspotErrorEvent) => void
   photo_response: (event: PhotoResponseEvent) => void
+  photo_status: (event: PhotoStatusEvent) => void
   gallery_status: (event: GalleryStatusEvent) => void
   compatible_glasses_search_stop: (event: CompatibleGlassesSearchStopEvent) => void
   heartbeat_sent: (event: HeartbeatSentEvent) => void
@@ -541,6 +597,7 @@ export type BluetoothSdkEventMap = {
   hotspot_status_change: HotspotStatusChangeEvent
   hotspot_error: HotspotErrorEvent
   photo_response: PhotoResponseEvent
+  photo_status: PhotoStatusEvent
   gallery_status: GalleryStatusEvent
   compatible_glasses_search_stop: CompatibleGlassesSearchStopEvent
   swipe_volume_status: SwipeVolumeStatusEvent
@@ -553,7 +610,6 @@ export type BluetoothSdkEventMap = {
   mic_pcm: MicPcmEvent
   mic_lc3: MicLc3Event
   stream_status: StreamStatusEvent
-  keep_alive_ack: KeepAliveAckEvent
 }
 
 export type BluetoothSdkEventName = keyof BluetoothSdkEventMap
@@ -614,7 +670,6 @@ export interface BluetoothSdkPublicModule {
 
   startStream(params: StreamStartRequest): Promise<void>
   stopStream(): Promise<void>
-  keepStreamAlive(params: StreamKeepAliveRequest): Promise<void>
 
   setMicState(
     enabled: boolean,

package/src/_private/BluetoothSdkModule.ts

@@ -6,8 +6,10 @@ import {
   BluetoothSdkModuleEvents,
   BluetoothStatus,
   ButtonPhotoSize,
+  CAMERA_FOV_DEFAULT,
+  CAMERA_FOV_MAX,
+  CAMERA_FOV_MIN,
   CameraFov,
-  CameraFovSetting,
   ConnectOptions,
   DashboardMenuItem,
   Device,
@@ -117,8 +119,9 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
 
   // Stream Commands
   startStream(params: StreamStartRequest): Promise<void>
+  startCloudManagedStream(params: StreamStartRequest): Promise<void>
   stopStream(): Promise<void>
-  keepStreamAlive(params: StreamKeepAliveRequest): Promise<void>
+  sendCloudStreamKeepAlive(params: StreamKeepAliveRequest): Promise<void>
 
   // Microphone Commands
   setMicState(
@@ -181,9 +184,26 @@ const DEFAULT_CONNECT_OPTIONS: Required<ConnectOptions> = {
 
 const DEFAULT_SCAN_TIMEOUT_MS = 15_000
 
-const CAMERA_FOV_SETTINGS: Record<CameraFov, CameraFovSetting> = {
-  standard: {fov: 118, roiPosition: 0},
-  wide: {fov: 118, roiPosition: 0},
+const CAMERA_ROI_MIN = 0
+const CAMERA_ROI_MAX = 2
+
+function clampInteger(value: number, min: number, max: number): number {
+  return Math.max(min, Math.min(max, Math.round(value)))
+}
+
+function normalizeCameraFov(setting: CameraFov): Required<CameraFov> {
+  return {
+    fov: clampInteger(
+      Number.isFinite(setting.fov) ? setting.fov : CAMERA_FOV_DEFAULT,
+      CAMERA_FOV_MIN,
+      CAMERA_FOV_MAX,
+    ),
+    roiPosition: clampInteger(
+      Number.isFinite(setting.roiPosition ?? 0) ? (setting.roiPosition ?? 0) : 0,
+      CAMERA_ROI_MIN,
+      CAMERA_ROI_MAX,
+    ) as Required<CameraFov>["roiPosition"],
+  }
 }
 
 function searchResultsForModel(status: Partial<PublicBluetoothStatus>, model: DeviceModel): Device[] {
@@ -373,7 +393,7 @@ NativeBluetoothSdkModule.setButtonMaxRecordingTime = function (minutes: number)
 }
 
 NativeBluetoothSdkModule.setCameraFov = function (fov: CameraFov) {
-  const setting = CAMERA_FOV_SETTINGS[fov]
+  const setting = normalizeCameraFov(fov)
   return this.updateBluetoothSettings({
     camera_fov: {fov: setting.fov, roi_position: setting.roiPosition},
   })
@@ -499,8 +519,13 @@ function photoRequestParamsForNative(params: PhotoRequestParams): Record<string,
   if (params.authToken != null && params.authToken.length > 0) {
     payload.authToken = params.authToken
   }
-  if (params.exposureTimeNs != null && Number.isFinite(params.exposureTimeNs) && params.exposureTimeNs > 0) {
-    payload.exposureTimeNs = params.exposureTimeNs
+  const exposureTimeNs = params.exposureTimeNs
+  const hasManualExposure = exposureTimeNs != null && Number.isFinite(exposureTimeNs) && exposureTimeNs > 0
+  if (hasManualExposure) {
+    payload.exposureTimeNs = exposureTimeNs
+  }
+  if (hasManualExposure && params.iso != null && Number.isFinite(params.iso) && params.iso > 0) {
+    payload.iso = Math.round(params.iso)
   }
   return payload
 }
@@ -510,5 +535,10 @@ NativeBluetoothSdkModule.requestPhoto = function (params: PhotoRequestParams) {
   return nativeRequestPhoto(photoRequestParamsForNative(params) as unknown as PhotoRequestParams)
 }
 
+const nativeStartStream = NativeBluetoothSdkModule.startStream.bind(NativeBluetoothSdkModule)
+NativeBluetoothSdkModule.startCloudManagedStream = function (params: StreamStartRequest) {
+  return nativeStartStream({...params, keepAliveMode: "external"} as StreamStartRequest)
+}
+
 export default NativeBluetoothSdkModule
 export const BluetoothSdk = NativeBluetoothSdkModule as BluetoothSdkPublicModule