@mentra/acs-meeting 3.3.0-dev.328 → 3.3.0-dev.329

package/README.md

@@ -237,6 +237,7 @@ Audio and video control:
 | Function | Notes |
 |---|---|
 | `setMuted(muted)` | Gates the uplink chain synchronously, then applies ACS policy |
+| `setVideoEnabled(enabled)` | ACS `stopVideo`/`startVideo` on the virtual outgoing stream. Glasses source and preview tap keep running; `videoEnabled` resets to true per join |
 | `setAudioSource(source)` | **No-op.** The source is locked for the call at join |
 | `pushOutgoingPcm(base64, rate, ch)` | Synchronous `Function`, ~100 calls/s. Returns whether it entered the uplink |
 | `updateVideoSource(whepUrl)` | WHEP only |

package/android/src/main/java/com/mentra/acsmeeting/AcsMeetingModule.kt

@@ -429,6 +429,18 @@ class AcsMeetingModule : Module() {
       session?.setMuted(muted) ?: mapOf("state" to "idle", "muted" to muted)
     }
 
+    AsyncFunction("setVideoEnabled") { enabled: Boolean, promise: Promise ->
+      val meeting = session
+      if (meeting == null) {
+        promise.reject("VIDEO_TOGGLE_FAILED", "No active meeting", null)
+      } else {
+        meeting.setVideoEnabled(enabled) { state, error ->
+          if (error != null) promise.reject("VIDEO_TOGGLE_FAILED", error.message, error)
+          else promise.resolve(state)
+        }
+      }
+    }
+
     AsyncFunction("setAudioSource") { source: String ->
       session?.setAudioSource(source) ?: mapOf("state" to "idle", "muted" to false, "audioSource" to source)
     }

package/android/src/main/java/com/mentra/acsmeeting/AcsMeetingSession.kt

@@ -74,6 +74,7 @@ import com.mentra.glassesmedia.source.OutgoingRateArm
 import com.mentra.glassesmedia.source.PixelFormatArm
 import com.mentra.glassesmedia.source.GlassesMediaController
 import com.mentra.glassesmedia.network.ScopedSoftApNetwork
+import com.mentra.glassesmedia.source.DecodedFrameTap
 import com.mentra.glassesmedia.source.GlassesMediaSourceFactory
 import com.mentra.glassesmedia.source.LocalWhipIngestSource
 import com.mentra.acsmeeting.source.MeetingVideoSourceSpec
@@ -210,6 +211,8 @@ class AcsMeetingSession(
   private var localOut: LocalOutgoingAudioStream? = null
   private var audioIn: RawIncomingAudioStream? = null
   private var videoOut: VirtualOutgoingVideoStream? = null
+  /** Whether ACS is sending [videoOut]. Only [setVideoEnabled] turns it off; every call starts on. */
+  @Volatile private var videoEnabled = true
   @Volatile private var meetingUrl: String? = null
   @Volatile private var phase = "idle"
   @Volatile private var lastError: String? = null
@@ -285,6 +288,7 @@ class AcsMeetingSession(
     val result = mutableMapOf<String, Any>(
       "state" to phase,
       "muted" to muted.get(),
+      "videoEnabled" to videoEnabled,
       "provider" to "acs-teams",
       "audioSource" to audioSource,
       "activeStream" to controller.readActive().name.lowercase(),
@@ -641,7 +645,10 @@ class AcsMeetingSession(
           bindIngestUnpinned {
             media.attach(
               video = { planes ->
-                frameSender.sendPlanes(planes)
+                // Preview first, deliberately: the tap must see frames ACS's pacing and
+                // readiness gates would otherwise hide, and it cannot delay or break this call.
+                DecodedFrameTap.offer(planes)
+                if (frameSender.sendPlanes(planes)) DecodedFrameTap.recordAcsSend()
               },
               pcm = { pcm, rate, channels -> feedOutgoingPcm(pcm, rate, channels) },
               config = videoSource.toConfig(),
@@ -668,7 +675,8 @@ class AcsMeetingSession(
         if (videoSource !is MeetingVideoSourceSpec.SoftAp) {
           media.attach(
             video = { planes ->
-              frameSender.sendPlanes(planes)
+              DecodedFrameTap.offer(planes)
+              if (frameSender.sendPlanes(planes)) DecodedFrameTap.recordAcsSend()
             },
             pcm = { pcm, rate, channels -> feedOutgoingPcm(pcm, rate, channels) },
             config = if (synthetic) SourceConfig("", SourceKind.DIRECT) else videoSource.toConfig(),
@@ -900,6 +908,45 @@ class AcsMeetingSession(
     return snap
   }
 
+  /**
+   * Stop or resume the camera Teams receives without leaving the call. The glasses source, the
+   * preview tap and the WHEP/WHIP transport keep running; [frameSender] drops frames while ACS
+   * reports the stream stopped. [videoEnabled] only moves once ACS accepts the change.
+   */
+  fun setVideoEnabled(next: Boolean, complete: (Map<String, Any>?, Throwable?) -> Unit) {
+    val generation = joinGeneration.get()
+    executor.execute {
+      val active = call
+      val stream = videoOut
+      if (active == null || stream == null || joinGeneration.get() != generation) {
+        complete(null, IllegalStateException("No active meeting"))
+        return@execute
+      }
+      if (videoEnabled == next) {
+        complete(snapshot(), null)
+        return@execute
+      }
+      val result = runCatching {
+        val change = if (next) active.startVideo(context, stream) else active.stopVideo(context, stream)
+        change.get(VIDEO_TOGGLE_TIMEOUT_MS, TimeUnit.MILLISECONDS)
+      }
+      if (call !== active || joinGeneration.get() != generation) {
+        complete(null, IllegalStateException("The meeting ended before the camera changed"))
+        return@execute
+      }
+      result.exceptionOrNull()?.let { error ->
+        Log.e(TAG, "setVideoEnabled=$next failed", error)
+        complete(null, error)
+        return@execute
+      }
+      Log.i(TAG, "setVideoEnabled=$next")
+      videoEnabled = next
+      val snap = snapshot()
+      onState(snap)
+      complete(snap, null)
+    }
+  }
+
   fun setAudioSource(source: String): Map<String, Any> {
     val parsed = AcsAudioPolicy.parseSource(source)
     if (parsed == null) {
@@ -2021,6 +2068,7 @@ class AcsMeetingSession(
     localOut = null
     audioIn = null
     videoOut = null
+    videoEnabled = true
     outgoingReady.set(false)
     muted.set(false)
     hangUpForEveryone = CapabilityStatus()
@@ -2097,6 +2145,7 @@ class AcsMeetingSession(
     private const val TAG = "ACS-SPIKE"
     const val GLASSES_REQUIRES_UNMUTED_TRANSPORT = true
     private const val ROSTER_COALESCE_MS = 150L
+    private const val VIDEO_TOGGLE_TIMEOUT_MS = 10_000L
     private const val MEDIA_RESTART_BASE_MS = 1_000L
     private const val MEDIA_RESTART_MAX_MS = 10_000L
 

package/android/src/main/java/com/mentra/acsmeeting/video/AcsFrameSender.kt

@@ -103,20 +103,21 @@ class AcsFrameSender(
 
   fun isReady(): Boolean = stream.get() != null && running.get() && format.get() != null
 
-  fun sendPlanes(planes: I420Planes) {
+  /** True when the frame was submitted to ACS; false when a readiness, size, pacing or busy gate dropped it. */
+  fun sendPlanes(planes: I420Planes): Boolean {
     val out = stream.get()
     if (out == null || !running.get()) {
       stats.onDropNotStarted()
-      return
+      return false
     }
     val negotiated = format.get()
     if (negotiated == null) {
       stats.onDropNotStarted()
-      return
+      return false
     }
     if (negotiated.width != planes.width || negotiated.height != planes.height) {
       stats.onDropSize()
-      return
+      return false
     }
     if (!planes.planesReadable()) {
       stats.onDropMalformed()
@@ -125,11 +126,11 @@ class AcsFrameSender(
         "P5 send plane too small ${planes.width}x${planes.height} " +
           "stride=${planes.strideY}/${planes.strideU}/${planes.strideV}",
       )
-      return
+      return false
     }
     if (!pacer.tryAdmit(FramePacer.intervalNs(negotiated.framesPerSecond))) {
       stats.onDropPaced()
-      return
+      return false
     }
 
     val prepared = prepareSend(planes, negotiated)
@@ -139,7 +140,7 @@ class AcsFrameSender(
     if (!gate.tryAcquire()) {
       stats.onDropBusy()
       releaseSendBuffers(prepared, planes)
-      return
+      return false
     }
 
     val seq = sendSeq.incrementAndGet()
@@ -230,6 +231,7 @@ class AcsFrameSender(
       gate.release()
       releaseSendBuffers(prepared, planes)
     }
+    return submitted
   }
 
   private data class PreparedSend(

package/build/AcsMeeting.types.d.ts

@@ -19,6 +19,8 @@ export type AcsMeetingParticipant = {
 export type AcsMeetingState = {
     state: MeetingPhase;
     muted: boolean;
+    /** Whether ACS is sending the glasses camera. Resets to true on every join. */
+    videoEnabled?: boolean;
     error?: string;
     meetingUrl?: string;
     provider?: "acs-teams";

package/build/AcsMeeting.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcsMeeting.types.d.ts","sourceRoot":"","sources":["../src/AcsMeeting.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AcsMeeting.types.d.ts","sourceRoot":"","sources":["../src/AcsMeeting.types.ts"],"names":[],"mappings":"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"}

package/build/AcsMeeting.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcsMeeting.types.js","sourceRoot":"","sources":["../src/AcsMeeting.types.ts"],"names":[],"mappings":"","sourcesContent":["export type MeetingPhase = \"idle\" | \"connecting\" | \"lobby\" | \"connected\" | \"disconnected\" | \"error\"\n\nexport type AcsAudioSource = \"glasses\" | \"phone\"\nexport type AcsActiveStream = \"none\" | \"virtual\" | \"local\"\nexport type AcsAudioSafety = \"safe\" | \"degraded\" | \"unsafe\"\n/**\n * Health of the glasses WHEP subscription feeding the call. `failed` = ICE dropped or\n * the WHEP endpoint went away while the ACS call may still be `connected`. Native\n * rebuilds it on its own with backoff; the host can force one via `restartVideoSource`.\n */\nexport type AcsMediaSourceState = \"idle\" | \"connecting\" | \"live\" | \"failed\"\n\nexport type AcsMeetingParticipantState = \"idle\" | \"connecting\" | \"connected\" | \"lobby\" | \"hold\" | \"disconnected\"\n\nexport type AcsMeetingParticipant = {\n  id: string\n  displayName: string | null\n  state: AcsMeetingParticipantState\n  isMuted: boolean\n  isSpeaking: boolean\n}\n\nexport type AcsMeetingState = {\n  state: MeetingPhase\n  muted: boolean\n  error?: string\n  meetingUrl?: string\n  provider?: \"acs-teams\"\n  audioSource?: AcsAudioSource\n  activeStream?: AcsActiveStream\n  audioSafety?: AcsAudioSafety\n  mediaSource?: AcsMediaSourceState\n  /** Native receiver diagnostic, including the reason a local WHIP offer was rejected. */\n  mediaSourceReason?: string\n  /** ACS disconnect diagnostics, emitted when the final disconnected state arrives. */\n  endReason_code?: number\n  endReason_subcode?: number\n  /** Local WHIP endpoint, available after a SoftAP join or `rebindSoftApIngest`. */\n  ingestUrl?: string\n  /** Remote roster, including participant state, mute state and speaking updates. */\n  participants?: AcsMeetingParticipant[]\n}\n\nexport type AcsOutgoingVideo = {\n  width: number\n  height: number\n  fps: number\n  maxBitrateBps: number\n}\n\nexport type AcsMeetingJoinOptions = {\n  meetingUrl: string\n  token: string\n  identityMode?: \"guest\" | \"teams-user\"\n  whepUrl?: string\n  videoSource?: {type: \"whep\"; url: string} | {type: \"softap\"; bindAddress: string}\n  displayName?: string\n  /** \"glasses\" sends WHEP PCM. \"phone\" uses the ACS local mic (handset or BT). */\n  audioSource?: AcsAudioSource\n  /**\n   * Hold outgoing PCM this many ms before ACS. SoftAP+LC3 sets this in the host\n   * because BLE audio reaches the phone before SoftAP video.\n   */\n  audioDelayMs?: number\n  /** Dump WHEP PCM to a WAV in cache for P4 verification. */\n  dumpPcmWav?: boolean\n  /** When omitted, native keeps 1280×720@15 / 2.5 Mbps. */\n  video?: AcsOutgoingVideo\n}\n\nexport type AcsIncomingPcmEvent = {\n  base64: string\n  sampleRate: number\n  channels: number\n}\n\nexport type AcsMeetingModuleEvents = {\n  onState: (state: AcsMeetingState) => void\n  onIncomingPcm: (pcm: AcsIncomingPcmEvent) => void\n}\n"]}
+{"version":3,"file":"AcsMeeting.types.js","sourceRoot":"","sources":["../src/AcsMeeting.types.ts"],"names":[],"mappings":"","sourcesContent":["export type MeetingPhase = \"idle\" | \"connecting\" | \"lobby\" | \"connected\" | \"disconnected\" | \"error\"\n\nexport type AcsAudioSource = \"glasses\" | \"phone\"\nexport type AcsActiveStream = \"none\" | \"virtual\" | \"local\"\nexport type AcsAudioSafety = \"safe\" | \"degraded\" | \"unsafe\"\n/**\n * Health of the glasses WHEP subscription feeding the call. `failed` = ICE dropped or\n * the WHEP endpoint went away while the ACS call may still be `connected`. Native\n * rebuilds it on its own with backoff; the host can force one via `restartVideoSource`.\n */\nexport type AcsMediaSourceState = \"idle\" | \"connecting\" | \"live\" | \"failed\"\n\nexport type AcsMeetingParticipantState = \"idle\" | \"connecting\" | \"connected\" | \"lobby\" | \"hold\" | \"disconnected\"\n\nexport type AcsMeetingParticipant = {\n  id: string\n  displayName: string | null\n  state: AcsMeetingParticipantState\n  isMuted: boolean\n  isSpeaking: boolean\n}\n\nexport type AcsMeetingState = {\n  state: MeetingPhase\n  muted: boolean\n  /** Whether ACS is sending the glasses camera. Resets to true on every join. */\n  videoEnabled?: boolean\n  error?: string\n  meetingUrl?: string\n  provider?: \"acs-teams\"\n  audioSource?: AcsAudioSource\n  activeStream?: AcsActiveStream\n  audioSafety?: AcsAudioSafety\n  mediaSource?: AcsMediaSourceState\n  /** Native receiver diagnostic, including the reason a local WHIP offer was rejected. */\n  mediaSourceReason?: string\n  /** ACS disconnect diagnostics, emitted when the final disconnected state arrives. */\n  endReason_code?: number\n  endReason_subcode?: number\n  /** Local WHIP endpoint, available after a SoftAP join or `rebindSoftApIngest`. */\n  ingestUrl?: string\n  /** Remote roster, including participant state, mute state and speaking updates. */\n  participants?: AcsMeetingParticipant[]\n}\n\nexport type AcsOutgoingVideo = {\n  width: number\n  height: number\n  fps: number\n  maxBitrateBps: number\n}\n\nexport type AcsMeetingJoinOptions = {\n  meetingUrl: string\n  token: string\n  identityMode?: \"guest\" | \"teams-user\"\n  whepUrl?: string\n  videoSource?: {type: \"whep\"; url: string} | {type: \"softap\"; bindAddress: string}\n  displayName?: string\n  /** \"glasses\" sends WHEP PCM. \"phone\" uses the ACS local mic (handset or BT). */\n  audioSource?: AcsAudioSource\n  /**\n   * Hold outgoing PCM this many ms before ACS. SoftAP+LC3 sets this in the host\n   * because BLE audio reaches the phone before SoftAP video.\n   */\n  audioDelayMs?: number\n  /** Dump WHEP PCM to a WAV in cache for P4 verification. */\n  dumpPcmWav?: boolean\n  /** When omitted, native keeps 1280×720@15 / 2.5 Mbps. */\n  video?: AcsOutgoingVideo\n}\n\nexport type AcsIncomingPcmEvent = {\n  base64: string\n  sampleRate: number\n  channels: number\n}\n\nexport type AcsMeetingModuleEvents = {\n  onState: (state: AcsMeetingState) => void\n  onIncomingPcm: (pcm: AcsIncomingPcmEvent) => void\n}\n"]}

package/build/AcsMeetingModule.d.ts

@@ -21,6 +21,11 @@ declare class AcsMeetingNativeModule extends NativeModule<AcsMeetingModuleEvents
         completed: boolean;
     }>;
     setMuted(muted: boolean): Promise<AcsMeetingState>;
+    /**
+     * Stop or resume the outgoing video stream (ACS `stopVideo`/`startVideo`). The call, the glasses
+     * media source and the preview tap stay up; frames are dropped before ACS while stopped.
+     */
+    setVideoEnabled(enabled: boolean): Promise<AcsMeetingState>;
     setAudioSource(source: "glasses" | "phone"): Promise<AcsMeetingState>;
     updateVideoSource(whepUrl: string): Promise<void>;
     /** Force a WHEP rebuild on the current URL (phone changed networks). */

package/build/AcsMeetingModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcsMeetingModule.d.ts","sourceRoot":"","sources":["../src/AcsMeetingModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAsB,MAAM,MAAM,CAAA;AAEtD,OAAO,KAAK,EAAC,qBAAqB,EAAE,sBAAsB,EAAE,eAAe,EAAC,MAAM,oBAAoB,CAAA;AAEtG,OAAO,OAAO,sBAAuB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;IAC/E,qBAAqB,IAAI,OAAO;IAChC,IAAI,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAC9D,iFAAiF;IACjF,YAAY,CAAC,OAAO,EAAE;QACpB,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,YAAY,CAAC,EAAE,OAAO,GAAG,YAAY,CAAA;KACtC,GAAG,OAAO,CAAC,eAAe,CAAC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IACtB,gBAAgB,CAAC,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACvD;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAC,CAAC;IAC1E,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAClD,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IACrE,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACjD,wEAAwE;IACxE,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IACnC;;;;OAIG;IACH,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IACrC,4EAA4E;IAC5E,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACpE,uFAAuF;IACvF,4BAA4B,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1C,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IACnC,uBAAuB,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IACzC,+BAA+B,CAAC,IAAI,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAC;IACjG,qEAAqE;IACrE,kBAAkB,IAAI,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC;IACnE,QAAQ,IAAI,OAAO,CAAC,eAAe,CAAC;CACrC;;AAED,wBAA8E"}
+{"version":3,"file":"AcsMeetingModule.d.ts","sourceRoot":"","sources":["../src/AcsMeetingModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAsB,MAAM,MAAM,CAAA;AAEtD,OAAO,KAAK,EAAC,qBAAqB,EAAE,sBAAsB,EAAE,eAAe,EAAC,MAAM,oBAAoB,CAAA;AAEtG,OAAO,OAAO,sBAAuB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;IAC/E,qBAAqB,IAAI,OAAO;IAChC,IAAI,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAC9D,iFAAiF;IACjF,YAAY,CAAC,OAAO,EAAE;QACpB,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,YAAY,CAAC,EAAE,OAAO,GAAG,YAAY,CAAA;KACtC,GAAG,OAAO,CAAC,eAAe,CAAC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IACtB,gBAAgB,CAAC,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACvD;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAC,CAAC;IAC1E,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAClD;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAC3D,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IACrE,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACjD,wEAAwE;IACxE,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IACnC;;;;OAIG;IACH,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IACrC,4EAA4E;IAC5E,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACpE,uFAAuF;IACvF,4BAA4B,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1C,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IACnC,uBAAuB,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IACzC,+BAA+B,CAAC,IAAI,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAC;IACjG,qEAAqE;IACrE,kBAAkB,IAAI,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC;IACnE,QAAQ,IAAI,OAAO,CAAC,eAAe,CAAC;CACrC;;AAED,wBAA8E"}

package/build/AcsMeetingModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcsMeetingModule.js","sourceRoot":"","sources":["../src/AcsMeetingModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,mBAAmB,EAAC,MAAM,MAAM,CAAA;AA4CtD,eAAe,mBAAmB,CAAyB,kBAAkB,CAAC,CAAA","sourcesContent":["import {NativeModule, requireNativeModule} from \"expo\"\n\nimport type {AcsMeetingJoinOptions, AcsMeetingModuleEvents, AcsMeetingState} from \"./AcsMeeting.types\"\n\ndeclare class AcsMeetingNativeModule extends NativeModule<AcsMeetingModuleEvents> {\n  supportsTeamsIdentity(): boolean\n  join(options: AcsMeetingJoinOptions): Promise<AcsMeetingState>\n  /** Sign in to ACS before SoftAP so Teams is not resolved through glasses DNS. */\n  prepareAgent(options: {\n    token: string\n    displayName?: string\n    identityMode?: \"guest\" | \"teams-user\"\n  }): Promise<AcsMeetingState>\n  leave(): Promise<void>\n  admitParticipant?(participantId: string): Promise<void>\n  /**\n   * Leave, and resolve only once the hang-up, the agent disposal, and the network releases have\n   * finished. Use this explicit barrier across platforms; Android `leave()` only queues cleanup.\n   */\n  leaveAndAwait(options: {timeoutMs: number}): Promise<{completed: boolean}>\n  setMuted(muted: boolean): Promise<AcsMeetingState>\n  setAudioSource(source: \"glasses\" | \"phone\"): Promise<AcsMeetingState>\n  updateVideoSource(whepUrl: string): Promise<void>\n  /** Force a WHEP rebuild on the current URL (phone changed networks). */\n  restartVideoSource(): Promise<void>\n  /**\n   * SoftAP: destroy the current ingest listener generation and bind a new one.\n   * Resolves with the new URL the glasses must publish to. Rejects rather than\n   * reuse a stale listener.\n   */\n  rebindSoftApIngest(): Promise<string>\n  /** SoftAP: join the glasses hotspot; resolves to the phone's IPv4 on it. */\n  joinScopedNetwork(ssid: string, passphrase: string): Promise<string>\n  /** iOS: verify DHCP against the gateway advertised by the glasses before resolving. */\n  joinScopedNetworkWithGateway?(ssid: string, passphrase: string, gateway: string): Promise<string>\n  beginTrace(traceId: string): Promise<void>\n  leaveScopedNetwork(): Promise<void>\n  cancelScopedNetworkJoin?(): Promise<void>\n  awaitDefaultNetworkAfterHotspot?(): Promise<{usable: boolean; detail: string; transport: string}>\n  /** SoftAP: TCP-probe the hotspot gateway over the scoped network. */\n  probeScopedGateway(): Promise<{reachable: boolean; detail: string}>\n  getState(): Promise<AcsMeetingState>\n}\n\nexport default requireNativeModule<AcsMeetingNativeModule>(\"MentraAcsMeeting\")\n"]}
+{"version":3,"file":"AcsMeetingModule.js","sourceRoot":"","sources":["../src/AcsMeetingModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,mBAAmB,EAAC,MAAM,MAAM,CAAA;AAiDtD,eAAe,mBAAmB,CAAyB,kBAAkB,CAAC,CAAA","sourcesContent":["import {NativeModule, requireNativeModule} from \"expo\"\n\nimport type {AcsMeetingJoinOptions, AcsMeetingModuleEvents, AcsMeetingState} from \"./AcsMeeting.types\"\n\ndeclare class AcsMeetingNativeModule extends NativeModule<AcsMeetingModuleEvents> {\n  supportsTeamsIdentity(): boolean\n  join(options: AcsMeetingJoinOptions): Promise<AcsMeetingState>\n  /** Sign in to ACS before SoftAP so Teams is not resolved through glasses DNS. */\n  prepareAgent(options: {\n    token: string\n    displayName?: string\n    identityMode?: \"guest\" | \"teams-user\"\n  }): Promise<AcsMeetingState>\n  leave(): Promise<void>\n  admitParticipant?(participantId: string): Promise<void>\n  /**\n   * Leave, and resolve only once the hang-up, the agent disposal, and the network releases have\n   * finished. Use this explicit barrier across platforms; Android `leave()` only queues cleanup.\n   */\n  leaveAndAwait(options: {timeoutMs: number}): Promise<{completed: boolean}>\n  setMuted(muted: boolean): Promise<AcsMeetingState>\n  /**\n   * Stop or resume the outgoing video stream (ACS `stopVideo`/`startVideo`). The call, the glasses\n   * media source and the preview tap stay up; frames are dropped before ACS while stopped.\n   */\n  setVideoEnabled(enabled: boolean): Promise<AcsMeetingState>\n  setAudioSource(source: \"glasses\" | \"phone\"): Promise<AcsMeetingState>\n  updateVideoSource(whepUrl: string): Promise<void>\n  /** Force a WHEP rebuild on the current URL (phone changed networks). */\n  restartVideoSource(): Promise<void>\n  /**\n   * SoftAP: destroy the current ingest listener generation and bind a new one.\n   * Resolves with the new URL the glasses must publish to. Rejects rather than\n   * reuse a stale listener.\n   */\n  rebindSoftApIngest(): Promise<string>\n  /** SoftAP: join the glasses hotspot; resolves to the phone's IPv4 on it. */\n  joinScopedNetwork(ssid: string, passphrase: string): Promise<string>\n  /** iOS: verify DHCP against the gateway advertised by the glasses before resolving. */\n  joinScopedNetworkWithGateway?(ssid: string, passphrase: string, gateway: string): Promise<string>\n  beginTrace(traceId: string): Promise<void>\n  leaveScopedNetwork(): Promise<void>\n  cancelScopedNetworkJoin?(): Promise<void>\n  awaitDefaultNetworkAfterHotspot?(): Promise<{usable: boolean; detail: string; transport: string}>\n  /** SoftAP: TCP-probe the hotspot gateway over the scoped network. */\n  probeScopedGateway(): Promise<{reachable: boolean; detail: string}>\n  getState(): Promise<AcsMeetingState>\n}\n\nexport default requireNativeModule<AcsMeetingNativeModule>(\"MentraAcsMeeting\")\n"]}

package/build/AcsMeetingModule.web.d.ts

@@ -13,6 +13,7 @@ declare const _default: {
         completed: boolean;
     }>;
     setMuted(_muted: boolean): Promise<AcsMeetingState>;
+    setVideoEnabled(_enabled: boolean): Promise<AcsMeetingState>;
     setAudioSource(_source: "glasses" | "phone"): Promise<AcsMeetingState>;
     updateVideoSource(_whepUrl: string): Promise<void>;
     restartVideoSource(): Promise<void>;

package/build/AcsMeetingModule.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcsMeetingModule.web.d.ts","sourceRoot":"","sources":["../src/AcsMeetingModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,qBAAqB,EAAE,eAAe,EAAC,MAAM,oBAAoB,CAAA;;mBAOvD,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;2BAGxC;QAC3B,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,YAAY,CAAC,EAAE,OAAO,GAAG,YAAY,CAAA;KACtC,GAAG,OAAO,CAAC,eAAe,CAAC;aAGb,OAAO,CAAC,IAAI,CAAC;4BAGE;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAC,CAAC;qBAG1D,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;4BAG3B,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;gCAG1C,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;0BAG5B,OAAO,CAAC,IAAI,CAAC;0BAGb,OAAO,CAAC,MAAM,CAAC;6BAGZ,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;0BAGhD,OAAO,CAAC,IAAI,CAAC;0BACb,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC;gBAGvD,OAAO,CAAC,eAAe,CAAC;;;;;;AAvC5C,wBA8CC"}
+{"version":3,"file":"AcsMeetingModule.web.d.ts","sourceRoot":"","sources":["../src/AcsMeetingModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,qBAAqB,EAAE,eAAe,EAAC,MAAM,oBAAoB,CAAA;;mBAOvD,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;2BAGxC;QAC3B,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,YAAY,CAAC,EAAE,OAAO,GAAG,YAAY,CAAA;KACtC,GAAG,OAAO,CAAC,eAAe,CAAC;aAGb,OAAO,CAAC,IAAI,CAAC;4BAGE;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAC,CAAC;qBAG1D,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;8BAGzB,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;4BAGpC,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;gCAG1C,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;0BAG5B,OAAO,CAAC,IAAI,CAAC;0BAGb,OAAO,CAAC,MAAM,CAAC;6BAGZ,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;0BAGhD,OAAO,CAAC,IAAI,CAAC;0BACb,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC;gBAGvD,OAAO,CAAC,eAAe,CAAC;;;;;;AA1C5C,wBAiDC"}

package/build/AcsMeetingModule.web.js

@@ -17,6 +17,9 @@ export default {
     async setMuted(_muted) {
         unavailable();
     },
+    async setVideoEnabled(_enabled) {
+        unavailable();
+    },
     async setAudioSource(_source) {
         unavailable();
     },

package/build/AcsMeetingModule.web.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcsMeetingModule.web.js","sourceRoot":"","sources":["../src/AcsMeetingModule.web.ts"],"names":[],"mappings":"AAEA,SAAS,WAAW;IAClB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;AACxD,CAAC;AAED,eAAe;IACb,KAAK,CAAC,IAAI,CAAC,QAA+B;QACxC,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,YAAY,CAAC,QAIlB;QACC,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,KAAK;QACT,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,aAAa,CAAC,QAA6B;QAC/C,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,MAAe;QAC5B,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,cAAc,CAAC,OAA4B;QAC/C,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACtC,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,kBAAkB;QACtB,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,kBAAkB;QACtB,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,iBAAiB,CAAC,KAAa,EAAE,WAAmB;QACxD,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,kBAAkB,KAAmB,CAAC;IAC5C,KAAK,CAAC,kBAAkB;QACtB,OAAO,EAAC,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,0BAA0B,EAAC,CAAA;IAC/D,CAAC;IACD,KAAK,CAAC,QAAQ;QACZ,OAAO,EAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAC,CAAA;IACtC,CAAC;IACD,WAAW;QACT,OAAO,EAAC,MAAM,KAAI,CAAC,EAAC,CAAA;IACtB,CAAC;IACD,eAAe,KAAI,CAAC;CACrB,CAAA","sourcesContent":["import type {AcsMeetingJoinOptions, AcsMeetingState} from \"./AcsMeeting.types\"\n\nfunction unavailable(): never {\n  throw new Error(\"ACS meeting is not available on web\")\n}\n\nexport default {\n  async join(_options: AcsMeetingJoinOptions): Promise<AcsMeetingState> {\n    unavailable()\n  },\n  async prepareAgent(_options: {\n    token: string\n    displayName?: string\n    identityMode?: \"guest\" | \"teams-user\"\n  }): Promise<AcsMeetingState> {\n    unavailable()\n  },\n  async leave(): Promise<void> {\n    unavailable()\n  },\n  async leaveAndAwait(_options: {timeoutMs: number}): Promise<{completed: boolean}> {\n    unavailable()\n  },\n  async setMuted(_muted: boolean): Promise<AcsMeetingState> {\n    unavailable()\n  },\n  async setAudioSource(_source: \"glasses\" | \"phone\"): Promise<AcsMeetingState> {\n    unavailable()\n  },\n  async updateVideoSource(_whepUrl: string): Promise<void> {\n    unavailable()\n  },\n  async restartVideoSource(): Promise<void> {\n    unavailable()\n  },\n  async rebindSoftApIngest(): Promise<string> {\n    unavailable()\n  },\n  async joinScopedNetwork(_ssid: string, _passphrase: string): Promise<string> {\n    unavailable()\n  },\n  async leaveScopedNetwork(): Promise<void> {},\n  async probeScopedGateway(): Promise<{reachable: boolean; detail: string}> {\n    return {reachable: false, detail: \"no scoped network on web\"}\n  },\n  async getState(): Promise<AcsMeetingState> {\n    return {state: \"idle\", muted: false}\n  },\n  addListener() {\n    return {remove() {}}\n  },\n  removeListeners() {},\n}\n"]}
+{"version":3,"file":"AcsMeetingModule.web.js","sourceRoot":"","sources":["../src/AcsMeetingModule.web.ts"],"names":[],"mappings":"AAEA,SAAS,WAAW;IAClB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;AACxD,CAAC;AAED,eAAe;IACb,KAAK,CAAC,IAAI,CAAC,QAA+B;QACxC,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,YAAY,CAAC,QAIlB;QACC,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,KAAK;QACT,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,aAAa,CAAC,QAA6B;QAC/C,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,MAAe;QAC5B,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,eAAe,CAAC,QAAiB;QACrC,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,cAAc,CAAC,OAA4B;QAC/C,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACtC,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,kBAAkB;QACtB,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,kBAAkB;QACtB,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,iBAAiB,CAAC,KAAa,EAAE,WAAmB;QACxD,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,kBAAkB,KAAmB,CAAC;IAC5C,KAAK,CAAC,kBAAkB;QACtB,OAAO,EAAC,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,0BAA0B,EAAC,CAAA;IAC/D,CAAC;IACD,KAAK,CAAC,QAAQ;QACZ,OAAO,EAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAC,CAAA;IACtC,CAAC;IACD,WAAW;QACT,OAAO,EAAC,MAAM,KAAI,CAAC,EAAC,CAAA;IACtB,CAAC;IACD,eAAe,KAAI,CAAC;CACrB,CAAA","sourcesContent":["import type {AcsMeetingJoinOptions, AcsMeetingState} from \"./AcsMeeting.types\"\n\nfunction unavailable(): never {\n  throw new Error(\"ACS meeting is not available on web\")\n}\n\nexport default {\n  async join(_options: AcsMeetingJoinOptions): Promise<AcsMeetingState> {\n    unavailable()\n  },\n  async prepareAgent(_options: {\n    token: string\n    displayName?: string\n    identityMode?: \"guest\" | \"teams-user\"\n  }): Promise<AcsMeetingState> {\n    unavailable()\n  },\n  async leave(): Promise<void> {\n    unavailable()\n  },\n  async leaveAndAwait(_options: {timeoutMs: number}): Promise<{completed: boolean}> {\n    unavailable()\n  },\n  async setMuted(_muted: boolean): Promise<AcsMeetingState> {\n    unavailable()\n  },\n  async setVideoEnabled(_enabled: boolean): Promise<AcsMeetingState> {\n    unavailable()\n  },\n  async setAudioSource(_source: \"glasses\" | \"phone\"): Promise<AcsMeetingState> {\n    unavailable()\n  },\n  async updateVideoSource(_whepUrl: string): Promise<void> {\n    unavailable()\n  },\n  async restartVideoSource(): Promise<void> {\n    unavailable()\n  },\n  async rebindSoftApIngest(): Promise<string> {\n    unavailable()\n  },\n  async joinScopedNetwork(_ssid: string, _passphrase: string): Promise<string> {\n    unavailable()\n  },\n  async leaveScopedNetwork(): Promise<void> {},\n  async probeScopedGateway(): Promise<{reachable: boolean; detail: string}> {\n    return {reachable: false, detail: \"no scoped network on web\"}\n  },\n  async getState(): Promise<AcsMeetingState> {\n    return {state: \"idle\", muted: false}\n  },\n  addListener() {\n    return {remove() {}}\n  },\n  removeListeners() {},\n}\n"]}

package/ios/AcsFrameSender.swift

@@ -20,21 +20,23 @@ final class AcsFrameSender: NSObject {
         stream.delegate = self
     }
 
-    func send(_ pixelBuffer: CVPixelBuffer) {
+    /// True when the frame was handed to ACS; false when readiness, pacing or the send gate dropped it.
+    @discardableResult
+    func send(_ pixelBuffer: CVPixelBuffer) -> Bool {
         stateLock.lock()
         guard running, let stream else {
             stateLock.unlock()
-            return
+            return false
         }
         let fps = stream.format.framesPerSecond
         let now = CFAbsoluteTimeGetCurrent()
         if lastSent > 0, now - lastSent < 1.0 / Double(max(fps, 1)) {
             stateLock.unlock()
-            return
+            return false
         }
         guard let token = sendGate.acquire() else {
             stateLock.unlock()
-            return
+            return false
         }
         lastSent = now
         stateLock.unlock()
@@ -48,6 +50,7 @@ final class AcsFrameSender: NSObject {
             sendGate.release(token)
             if let error { NSLog("ACS-SPIKE send frame failed: \(error)") }
         }
+        return true
     }
 
     func detach() {

package/ios/AcsMeetingModule.swift

@@ -164,6 +164,19 @@ public class AcsMeetingModule: Module {
             session.setMuted(muted) { promise.resolve($0) }
         }
 
+        AsyncFunction("setVideoEnabled") { (enabled: Bool, promise: Promise) in
+            guard let session = self.session else {
+                promise.reject(AcsMeetingError("No active meeting"))
+                return
+            }
+            session.setVideoEnabled(enabled) { result in
+                switch result {
+                case let .success(state): promise.resolve(state)
+                case let .failure(error): promise.reject(error)
+                }
+            }
+        }
+
         AsyncFunction("setAudioSource") { (source: String, promise: Promise) in
             guard let session = self.session else {
                 promise.resolve(["state": "idle", "muted": false, "audioSource": source]); return
@@ -236,6 +249,9 @@ final class AcsMeetingSession {
     private lazy var applier = AudioPolicyApplier(controller: controller, scheduler: scheduler) { NSLog("ACS-SPIKE \($0)") }
     private var phase = "idle"
     private var muted = false
+    /// Whether ACS is sending `videoStream`. Only `setVideoEnabled` turns it off; every call starts on.
+    private var videoEnabled = true
+    private var videoStream: VirtualOutgoingVideoStream?
     private var meetingUrl: String?
     private var lastError: String?
     private var callEndReason: (code: Int, subcode: Int)?
@@ -315,6 +331,7 @@ final class AcsMeetingSession {
         var result: [String: Any] = [
             "state": phase,
             "muted": muted,
+            "videoEnabled": videoEnabled,
             "provider": "acs-teams",
             "audioSource": audioSource,
             "activeStream": controller.readActive().rawValue,
@@ -471,6 +488,7 @@ final class AcsMeetingSession {
         let videoOptions = RawOutgoingVideoStreamOptions()
         videoOptions.formats = [videoFormat]
         let videoStream = VirtualOutgoingVideoStream(videoStreamOptions: videoOptions)
+        self.videoStream = videoStream
         frameSender = AcsFrameSender()
         frameSender.attach(videoStream)
 
@@ -590,7 +608,12 @@ final class AcsMeetingSession {
             self?.feedOutgoingPcm(pcm, sampleRate: rate, channels: channels, generation: generation)
         }
         let source: DecodedGlassesMediaSource = sourceConfig.kind == .softap ? LocalWhipIngestSource() : WhepVideoSource()
-        source.onFrame = { [frameSender] buffer in frameSender.send(buffer) }
+        source.onFrame = { [frameSender] buffer in
+            // Preview first, deliberately: the tap must see frames the ACS sender's pacing and
+            // readiness gates would otherwise hide, and it cannot delay or break this call.
+            DecodedFrameTap.shared.offer(buffer)
+            if frameSender.send(buffer) { DecodedFrameTap.shared.recordAcsSend() }
+        }
         source.onPcm = { [weak self] pcm, rate, channels in
             self?.feedOutgoingPcm(pcm, sampleRate: rate, channels: channels, generation: generation)
         }
@@ -726,6 +749,46 @@ final class AcsMeetingSession {
         }
     }
 
+    /// Stop or resume the camera Teams receives without leaving the call. The glasses source, the
+    /// preview tap and the WHEP/WHIP transport keep running; `AcsFrameSender` drops frames while
+    /// ACS reports the stream stopped. `videoEnabled` only moves once ACS accepts the change.
+    func setVideoEnabled(_ next: Bool, completion: @escaping (Result<[String: Any], Error>) -> Void) {
+        queue.async {
+            guard let call = self.call, let stream = self.videoStream else {
+                completion(.failure(AcsMeetingError("No active meeting")))
+                return
+            }
+            guard self.videoEnabled != next else {
+                completion(.success(self.snapshotLocked()))
+                return
+            }
+            let generation = self.joinGeneration
+            let finished: (Error?) -> Void = { error in
+                self.queue.async {
+                    guard self.joinGeneration == generation, self.call === call else {
+                        completion(.failure(AcsMeetingError("The meeting ended before the camera changed")))
+                        return
+                    }
+                    if let error {
+                        NSLog("ACS-SPIKE setVideoEnabled=\(next) failed: \(error)")
+                        completion(.failure(error))
+                        return
+                    }
+                    NSLog("ACS-SPIKE setVideoEnabled=\(next)")
+                    self.videoEnabled = next
+                    let snapshot = self.snapshotLocked()
+                    self.onState(snapshot)
+                    completion(.success(snapshot))
+                }
+            }
+            if next {
+                call.startVideo(stream: stream, completionHandler: finished)
+            } else {
+                call.stopVideo(stream: stream, completionHandler: finished)
+            }
+        }
+    }
+
     func setAudioSource(_ source: String, completion: @escaping ([String: Any]) -> Void) {
         queue.async {
             if AcsAudioPolicy.parseSource(source) == nil {
@@ -1014,6 +1077,8 @@ final class AcsMeetingSession {
         pcmBridge = nil
         outgoingReady = false
         muted = false
+        videoEnabled = true
+        videoStream = nil
         audioSource = "glasses"
         lastSafety = .degraded
         meetingUrl = nil

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/acs-meeting",
-  "version": "3.3.0-dev.328",
+  "version": "3.3.0-dev.329",
   "description": "MentraOS native ACS Teams meeting module (WHEP decode → ACS raw media)",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -32,7 +32,7 @@
   },
   "dependencies": {
     "@expo/config-plugins": "~55.0.10",
-    "@mentra/glasses-media": "3.3.0-dev.328"
+    "@mentra/glasses-media": "3.3.0-dev.329"
   },
   "devDependencies": {
     "expo-module-scripts": "^55.0.2",

package/src/AcsMeeting.types.ts

@@ -23,6 +23,8 @@ export type AcsMeetingParticipant = {
 export type AcsMeetingState = {
   state: MeetingPhase
   muted: boolean
+  /** Whether ACS is sending the glasses camera. Resets to true on every join. */
+  videoEnabled?: boolean
   error?: string
   meetingUrl?: string
   provider?: "acs-teams"

package/src/AcsMeetingModule.ts

@@ -19,6 +19,11 @@ declare class AcsMeetingNativeModule extends NativeModule<AcsMeetingModuleEvents
    */
   leaveAndAwait(options: {timeoutMs: number}): Promise<{completed: boolean}>
   setMuted(muted: boolean): Promise<AcsMeetingState>
+  /**
+   * Stop or resume the outgoing video stream (ACS `stopVideo`/`startVideo`). The call, the glasses
+   * media source and the preview tap stay up; frames are dropped before ACS while stopped.
+   */
+  setVideoEnabled(enabled: boolean): Promise<AcsMeetingState>
   setAudioSource(source: "glasses" | "phone"): Promise<AcsMeetingState>
   updateVideoSource(whepUrl: string): Promise<void>
   /** Force a WHEP rebuild on the current URL (phone changed networks). */

package/src/AcsMeetingModule.web.ts

@@ -24,6 +24,9 @@ export default {
   async setMuted(_muted: boolean): Promise<AcsMeetingState> {
     unavailable()
   },
+  async setVideoEnabled(_enabled: boolean): Promise<AcsMeetingState> {
+    unavailable()
+  },
   async setAudioSource(_source: "glasses" | "phone"): Promise<AcsMeetingState> {
     unavailable()
   },