@naviedu/room-platform-react 0.0.41 → 0.0.43

package/index.d.ts

@@ -262,6 +262,7 @@ declare type RoomPlatformContextValue = {
     localCameraTrack: LocalVideoTrack | null;
     localMedia: RoomPlatformLocalMediaState;
     performAction: (name: RoomPlatformActionName, payload?: Record<string, string>) => Promise<void>;
+    reconcileLocalCameraAfterProcessor: (track: LocalVideoTrack) => Promise<void>;
     room: Room | null;
     setLocalMediaEnabled: (kind: RoomPlatformLocalMediaKind, enabled: boolean) => Promise<void>;
     status: RoomPlatformConnectionStatus;
@@ -696,7 +697,7 @@ declare type RoomPrivateRoomStatus = 'ringing' | 'active';
 
 export declare function useRoomPlatform(): RoomPlatformContextValue;
 
-declare function useRoomPlatformCameraBackground({ localVideoTrack }: UseRoomPlatformCameraBackgroundInput): {
+declare function useRoomPlatformCameraBackground({ localVideoTrack, onProcessorSettled, }: UseRoomPlatformCameraBackgroundInput): {
     state: RoomPlatformCameraBackgroundState;
     uploadItems: RoomPlatformCameraBackgroundUploadPreview[];
     uploadPreviewUrl: string;
@@ -713,6 +714,7 @@ declare function useRoomPlatformCameraBackground({ localVideoTrack }: UseRoomPla
 
 declare type UseRoomPlatformCameraBackgroundInput = {
     localVideoTrack: LocalVideoTrack | null;
+    onProcessorSettled?: (track: LocalVideoTrack) => void | Promise<void>;
 };
 
 export declare function useRoomPlatformMonitorViewer({ enabled, onStartError, performAction, }: RoomPlatformMonitorViewerProps): void;

package/index.esm.js

@@ -13569,6 +13569,18 @@ function toWhiteboardProviderProps(integration, roomId) {
     };
 }
 
+var roleFromMetadata = function(metadata) {
+    try {
+        var parsed = JSON.parse(metadata !== null && metadata !== void 0 ? metadata : '{}');
+        return typeof parsed.role === 'string' ? parsed.role : undefined;
+    } catch (unused) {
+        return undefined;
+    }
+};
+var isManagedParticipantRole = function(role) {
+    return role === 'student' || role === 'admin' || role === 'operator';
+};
+
 var RoomPlatformPrivateRoomContext = createContext(undefined);
 function useRoomPlatformPrivateRoomContext() {
     var context = useContext(RoomPlatformPrivateRoomContext);
@@ -14044,14 +14056,6 @@ var localMediaStateOf = function(room) {
         screenShare: room.localParticipant.isScreenShareEnabled
     };
 };
-var roleFromMetadata = function(metadata) {
-    try {
-        var parsed = JSON.parse(metadata !== null && metadata !== void 0 ? metadata : '{}');
-        return typeof parsed.role === 'string' ? parsed.role : undefined;
-    } catch (unused) {
-        return undefined;
-    }
-};
 var externalActorIdFromMetadata$2 = function(metadata) {
     try {
         var parsed = JSON.parse(metadata !== null && metadata !== void 0 ? metadata : '{}');
@@ -14096,12 +14100,15 @@ function RoomPlatformProvider(param) {
     var hasFirstSuccessfulConnectionRef = useRef(false);
     var cameraDesiredRef = useRef(false);
     var canonicalCameraTrackRef = useRef(null);
+    var managedCameraUpstreamDirtyRef = useRef(new WeakSet());
     var cameraTrackEndedHandlerRef = useRef(undefined);
+    var cameraTrackRestartedHandlerRef = useRef(undefined);
     var cameraCreationRef = useRef(undefined);
     var cameraTransitionRef = useRef(Promise.resolve());
     var cameraRevisionRef = useRef(0);
     var accessGenerationRef = useRef(0);
     var handleCameraEndedRef = useRef(undefined);
+    var handleCameraRestartedRef = useRef(undefined);
     var initialLaunchTokenRef = useRef(launchToken);
     var recoveryRef = useRef(undefined);
     var roomConnectionRef = useRef(null);
@@ -14341,11 +14348,117 @@ function RoomPlatformProvider(param) {
         cameraShouldBeForced
     ]);
     var cameraShouldCapture = useCallback(function(currentRoom, currentAccess) {
-        return !cameraRoomIsPrivate(currentRoom) && (cameraShouldBeForced(currentRoom) || cameraDesiredRef.current && canPreviewCamera(currentAccess.capabilities));
+        return !cameraRoomIsPrivate(currentRoom) && (isManagedParticipantRole(roleFromMetadata(currentRoom.localParticipant.metadata)) || cameraShouldBeForced(currentRoom) || cameraDesiredRef.current && canPreviewCamera(currentAccess.capabilities));
     }, [
         cameraRoomIsPrivate,
         cameraShouldBeForced
     ]);
+    var managedCameraShouldResume = useCallback(function(currentRoom, currentAccess) {
+        var _controlStateRef_current, _controlStateRef_current1;
+        return roleFromMetadata(currentRoom.localParticipant.metadata) === 'student' && (((_controlStateRef_current = controlStateRef.current) === null || _controlStateRef_current === void 0 ? void 0 : _controlStateRef_current.monitorActive) === true || ((_controlStateRef_current1 = controlStateRef.current) === null || _controlStateRef_current1 === void 0 ? void 0 : _controlStateRef_current1.activeSpeakerParticipantIdentity) === currentAccess.liveKit.participantIdentity);
+    }, []);
+    var reconcileManagedCameraUpstream = useCallback(function(track, currentRoom, currentAccess) {
+        return _async_to_generator$k(function() {
+            var shouldResume, error;
+            return _ts_generator$k(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        if (!isManagedParticipantRole(roleFromMetadata(currentRoom.localParticipant.metadata))) return [
+                            2,
+                            undefined
+                        ];
+                        shouldResume = managedCameraShouldResume(currentRoom, currentAccess);
+                        _state.label = 1;
+                    case 1:
+                        _state.trys.push([
+                            1,
+                            12,
+                            ,
+                            13
+                        ]);
+                        if (!managedCameraUpstreamDirtyRef.current.has(track)) return [
+                            3,
+                            6
+                        ];
+                        if (!shouldResume) return [
+                            3,
+                            3
+                        ];
+                        return [
+                            4,
+                            track.pauseUpstream()
+                        ];
+                    case 2:
+                        _state.sent();
+                        return [
+                            3,
+                            5
+                        ];
+                    case 3:
+                        return [
+                            4,
+                            track.resumeUpstream()
+                        ];
+                    case 4:
+                        _state.sent();
+                        _state.label = 5;
+                    case 5:
+                        return [
+                            3,
+                            7
+                        ];
+                    case 6:
+                        if (track.isUpstreamPaused === !shouldResume) {
+                            return [
+                                2,
+                                shouldResume && track.mediaStreamTrack.readyState === 'live' && !track.isUpstreamPaused
+                            ];
+                        }
+                        _state.label = 7;
+                    case 7:
+                        if (!shouldResume) return [
+                            3,
+                            9
+                        ];
+                        return [
+                            4,
+                            track.resumeUpstream()
+                        ];
+                    case 8:
+                        _state.sent();
+                        return [
+                            3,
+                            11
+                        ];
+                    case 9:
+                        return [
+                            4,
+                            track.pauseUpstream()
+                        ];
+                    case 10:
+                        _state.sent();
+                        _state.label = 11;
+                    case 11:
+                        managedCameraUpstreamDirtyRef.current.delete(track);
+                        return [
+                            3,
+                            13
+                        ];
+                    case 12:
+                        error = _state.sent();
+                        managedCameraUpstreamDirtyRef.current.add(track);
+                        throw error;
+                    case 13:
+                        return [
+                            2,
+                            shouldResume && track.mediaStreamTrack.readyState === 'live' && !track.isUpstreamPaused
+                        ];
+                }
+            });
+        })();
+    }, [
+        managedCameraShouldResume
+    ]);
     var cameraShouldPublish = useCallback(function(currentRoom, currentAccess) {
         return cameraShouldCapture(currentRoom, currentAccess) && cameraCanPublish(currentRoom, currentAccess);
     }, [
@@ -14354,7 +14467,9 @@ function RoomPlatformProvider(param) {
     ]);
     var removeCanonicalCameraTrack = useCallback(function(track, stop) {
         if (cameraTrackEndedHandlerRef.current) track.off(TrackEvent.Ended, cameraTrackEndedHandlerRef.current);
+        if (cameraTrackRestartedHandlerRef.current) track.off(TrackEvent.Restarted, cameraTrackRestartedHandlerRef.current);
         cameraTrackEndedHandlerRef.current = undefined;
+        cameraTrackRestartedHandlerRef.current = undefined;
         if (canonicalCameraTrackRef.current === track) canonicalCameraTrackRef.current = null;
         if (stop) track.stop();
         if (isMountedRef.current) {
@@ -14380,7 +14495,7 @@ function RoomPlatformProvider(param) {
         });
         var creation = function() {
             return _async_to_generator$k(function() {
-                var _roomConnectionRef_current, created, stillCurrent, ended, creationError;
+                var _roomConnectionRef_current, created, stillCurrent, ended, restarted, creationError;
                 return _ts_generator$k(this, function(_state) {
                     switch(_state.label){
                         case 0:
@@ -14415,9 +14530,20 @@ function RoomPlatformProvider(param) {
                                     return (_ref = (_handleCameraEndedRef_current = handleCameraEndedRef.current) === null || _handleCameraEndedRef_current === void 0 ? void 0 : _handleCameraEndedRef_current.call(handleCameraEndedRef, lifecycle, created)) !== null && _ref !== void 0 ? _ref : Promise.resolve();
                                 });
                             };
+                            restarted = function() {
+                                for(var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++){
+                                    args[_key] = arguments[_key];
+                                }
+                                var _ref;
+                                var _handleCameraRestartedRef_current;
+                                if (args.length > 0 && args[0] !== created) return;
+                                void ((_ref = (_handleCameraRestartedRef_current = handleCameraRestartedRef.current) === null || _handleCameraRestartedRef_current === void 0 ? void 0 : _handleCameraRestartedRef_current.call(handleCameraRestartedRef, lifecycle, created)) !== null && _ref !== void 0 ? _ref : Promise.resolve());
+                            };
                             canonicalCameraTrackRef.current = created;
                             cameraTrackEndedHandlerRef.current = ended;
+                            cameraTrackRestartedHandlerRef.current = restarted;
                             created.on(TrackEvent.Ended, ended);
+                            created.on(TrackEvent.Restarted, restarted);
                             if (isMountedRef.current) setLocalCameraTrack(created);
                             return [
                                 2,
@@ -14538,7 +14664,7 @@ function RoomPlatformProvider(param) {
     ]);
     var publishCanonicalCamera = useCallback(function(lifecycle, revision, generation, currentRoom) {
         return _async_to_generator$k(function() {
-            var _roomConnectionRef_current, currentAccess, track, publication, _roomConnectionRef_current1, latestAccess, canRetainForPreview, publication1, wasPublished, publishError, _roomConnectionRef_current2, latestAccess1, canRetain;
+            var _roomConnectionRef_current, currentAccess, track, _roomConnectionRef_current1, publication, managedCameraEnabled, latestAccess, canRetainForPreview, publication1, wasPublished, managedCameraEnabled1, publishError, _roomConnectionRef_current2, latestAccess1, canRetain;
             return _ts_generator$k(this, function(_state) {
                 switch(_state.label){
                     case 0:
@@ -14550,43 +14676,61 @@ function RoomPlatformProvider(param) {
                         if (!isLifecycleActive(lifecycle) || cameraRevisionRef.current !== revision || accessGenerationRef.current !== generation || ((_roomConnectionRef_current = roomConnectionRef.current) === null || _roomConnectionRef_current === void 0 ? void 0 : _roomConnectionRef_current.room) !== currentRoom || !cameraShouldPublish(currentRoom, currentAccess)) return [
                             2
                         ];
-                        publication = currentRoom.localParticipant.getTrackPublication(Track.Source.Camera);
-                        if ((publication === null || publication === void 0 ? void 0 : publication.track) === track) return [
-                            2
-                        ];
                         _state.label = 1;
                     case 1:
                         _state.trys.push([
                             1,
-                            7,
+                            10,
                             ,
-                            8
+                            11
                         ]);
+                        publication = currentRoom.localParticipant.getTrackPublication(Track.Source.Camera);
+                        if (!((publication === null || publication === void 0 ? void 0 : publication.track) === track)) return [
+                            3,
+                            3
+                        ];
                         return [
                             4,
-                            currentRoom.localParticipant.publishTrack(track)
+                            reconcileManagedCameraUpstream(track, currentRoom, currentAccess)
                         ];
                     case 2:
+                        managedCameraEnabled = _state.sent();
+                        if (isMountedRef.current && managedCameraEnabled !== undefined) {
+                            setLocalMedia(function(current) {
+                                return _object_spread_props$b(_object_spread$d({}, current), {
+                                    camera: managedCameraEnabled
+                                });
+                            });
+                        }
+                        return [
+                            2
+                        ];
+                    case 3:
+                        return [
+                            4,
+                            currentRoom.localParticipant.publishTrack(track)
+                        ];
+                    case 4:
                         _state.sent();
                         latestAccess = accessRef.current;
                         canRetainForPreview = Boolean(latestAccess && cameraDesiredRef.current && canPreviewCamera(latestAccess.capabilities) && cameraShouldCapture(currentRoom, latestAccess));
                         if (!(latestAccess && isLifecycleActive(lifecycle) && cameraRevisionRef.current === revision && accessGenerationRef.current === generation && !cameraShouldPublish(currentRoom, latestAccess))) return [
                             3,
-                            4
+                            6
                         ];
                         return [
                             4,
                             unpublishCanonicalCamera(canRetainForPreview)
                         ];
-                    case 3:
+                    case 5:
                         _state.sent();
                         return [
                             2
                         ];
-                    case 4:
+                    case 6:
                         if (!(!isLifecycleActive(lifecycle) || cameraRevisionRef.current !== revision || accessGenerationRef.current !== generation || ((_roomConnectionRef_current1 = roomConnectionRef.current) === null || _roomConnectionRef_current1 === void 0 ? void 0 : _roomConnectionRef_current1.room) !== currentRoom)) return [
                             3,
-                            6
+                            8
                         ];
                         publication1 = currentRoom.localParticipant.getTrackPublication(Track.Source.Camera);
                         wasPublished = (publication1 === null || publication1 === void 0 ? void 0 : publication1.track) === track;
@@ -14594,7 +14738,7 @@ function RoomPlatformProvider(param) {
                             4,
                             currentRoom.localParticipant.unpublishTrack(track, !canRetainForPreview)
                         ];
-                    case 5:
+                    case 7:
                         _state.sent();
                         if (!canRetainForPreview) removeCanonicalCameraTrack(track, !wasPublished);
                         else if (isMountedRef.current) setLocalMedia(function(current) {
@@ -14605,20 +14749,33 @@ function RoomPlatformProvider(param) {
                         return [
                             2
                         ];
-                    case 6:
-                        if (isMountedRef.current) setLocalMedia(function(current) {
-                            return _object_spread_props$b(_object_spread$d({}, current), {
-                                camera: true
+                    case 8:
+                        return [
+                            4,
+                            reconcileManagedCameraUpstream(track, currentRoom, currentAccess)
+                        ];
+                    case 9:
+                        managedCameraEnabled1 = _state.sent();
+                        if (isMountedRef.current) {
+                            setLocalMedia(function(current) {
+                                return _object_spread_props$b(_object_spread$d({}, current), {
+                                    camera: managedCameraEnabled1 !== null && managedCameraEnabled1 !== void 0 ? managedCameraEnabled1 : true
+                                });
                             });
-                        });
+                        }
                         return [
                             3,
-                            8
+                            11
                         ];
-                    case 7:
+                    case 10:
                         publishError = _state.sent();
+                        if (isMountedRef.current) setLocalMedia(function(current) {
+                            return _object_spread_props$b(_object_spread$d({}, current), {
+                                camera: false
+                            });
+                        });
                         latestAccess1 = accessRef.current;
-                        canRetain = isLifecycleActive(lifecycle) && latestAccess1 !== undefined && ((_roomConnectionRef_current2 = roomConnectionRef.current) === null || _roomConnectionRef_current2 === void 0 ? void 0 : _roomConnectionRef_current2.room) === currentRoom && cameraDesiredRef.current && canPreviewCamera(latestAccess1.capabilities) && cameraShouldCapture(currentRoom, latestAccess1);
+                        canRetain = isLifecycleActive(lifecycle) && latestAccess1 !== undefined && ((_roomConnectionRef_current2 = roomConnectionRef.current) === null || _roomConnectionRef_current2 === void 0 ? void 0 : _roomConnectionRef_current2.room) === currentRoom && (isManagedParticipantRole(roleFromMetadata(currentRoom.localParticipant.metadata)) || cameraDesiredRef.current) && canPreviewCamera(latestAccess1.capabilities) && cameraShouldCapture(currentRoom, latestAccess1);
                         if (!canRetain) removeCanonicalCameraTrack(track, true);
                         reportError(publishError, {
                             recoverable: true,
@@ -14626,9 +14783,9 @@ function RoomPlatformProvider(param) {
                         });
                         return [
                             3,
-                            8
+                            11
                         ];
-                    case 8:
+                    case 11:
                         return [
                             2
                         ];
@@ -14639,6 +14796,7 @@ function RoomPlatformProvider(param) {
         cameraShouldCapture,
         cameraShouldPublish,
         isLifecycleActive,
+        reconcileManagedCameraUpstream,
         removeCanonicalCameraTrack,
         reportError,
         unpublishCanonicalCamera
@@ -14823,6 +14981,76 @@ function RoomPlatformProvider(param) {
         publishCanonicalCamera,
         unpublishCanonicalCamera
     ]);
+    var handleCameraRestarted = useCallback(function(lifecycle, restartedTrack) {
+        return _async_to_generator$k(function() {
+            var connection, currentAccess, publication;
+            return _ts_generator$k(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        if (canonicalCameraTrackRef.current !== restartedTrack || !isLifecycleActive(lifecycle)) return [
+                            2
+                        ];
+                        connection = roomConnectionRef.current;
+                        currentAccess = accessRef.current;
+                        if (!connection || connection.disposed || !currentAccess) return [
+                            2
+                        ];
+                        publication = connection.room.localParticipant.getTrackPublication(Track.Source.Camera);
+                        if ((publication === null || publication === void 0 ? void 0 : publication.track) !== restartedTrack) return [
+                            2
+                        ];
+                        managedCameraUpstreamDirtyRef.current.add(restartedTrack);
+                        return [
+                            4,
+                            reconcileCanonicalCamera(lifecycle, cameraRevisionRef.current, accessGenerationRef.current)
+                        ];
+                    case 1:
+                        _state.sent();
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    }, [
+        isLifecycleActive,
+        reconcileCanonicalCamera
+    ]);
+    useEffect(function() {
+        handleCameraRestartedRef.current = handleCameraRestarted;
+    }, [
+        handleCameraRestarted
+    ]);
+    var reconcileLocalCameraAfterProcessor = useCallback(function(track) {
+        return _async_to_generator$k(function() {
+            var lifecycle, connection;
+            return _ts_generator$k(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        if (canonicalCameraTrackRef.current !== track) return [
+                            2
+                        ];
+                        lifecycle = lifecycleRef.current;
+                        connection = roomConnectionRef.current;
+                        if (!lifecycle || !connection || connection.disposed || !accessRef.current) return [
+                            2
+                        ];
+                        managedCameraUpstreamDirtyRef.current.add(track);
+                        return [
+                            4,
+                            reconcileCanonicalCamera(lifecycle, cameraRevisionRef.current, accessGenerationRef.current)
+                        ];
+                    case 1:
+                        _state.sent();
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    }, [
+        reconcileCanonicalCamera
+    ]);
     var disposeRoom = useCallback(function(connection) {
         var reconnectCompleted = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : false;
         if (!connection.disposed) {
@@ -15605,11 +15833,13 @@ function RoomPlatformProvider(param) {
         if (existingOperation !== undefined) return existingOperation;
         var operation = (function() {
             return _async_to_generator$k(function() {
-                var _controlStateRef_current, _accessRef_current, connection, currentAccess, hasTemporarySpeakerGrant, ringingPrivateRoom, participant, actorId, isRingingForActor, _ref, currentSnapshot, snapshot;
+                var _controlStateRef_current, _accessRef_current, connection, role, currentAccess, hasTemporarySpeakerGrant, ringingPrivateRoom, participant, actorId, isRingingForActor, _ref, currentSnapshot, snapshot;
                 return _ts_generator$k(this, function(_state) {
                     switch(_state.label){
                         case 0:
                             connection = roomConnectionRef.current;
+                            role = roleFromMetadata(connection === null || connection === void 0 ? void 0 : connection.room.localParticipant.metadata);
+                            if ((kind === 'camera' || kind === 'microphone') && isManagedParticipantRole(role)) throw new Error('ROOM_PLATFORM_MEDIA_MANAGED');
                             if (!(kind === 'camera')) return [
                                 3,
                                 2
@@ -16020,6 +16250,7 @@ function RoomPlatformProvider(param) {
             localCameraTrack: localCameraTrack,
             localMedia: localMedia,
             performAction: performAction,
+            reconcileLocalCameraAfterProcessor: reconcileLocalCameraAfterProcessor,
             room: room,
             setLocalMediaEnabled: setLocalMediaEnabled,
             status: status,
@@ -16037,6 +16268,7 @@ function RoomPlatformProvider(param) {
         localCameraTrack,
         localMedia,
         performAction,
+        reconcileLocalCameraAfterProcessor,
         room,
         setLocalMediaEnabled,
         status,
@@ -18685,6 +18917,8 @@ function RoomPlatformControlBar(param) {
     var currentParticipant = useRoomPresence().find(function(participant) {
         return participant.isLocal;
     });
+    var localRole = roleFromMetadata(room === null || room === void 0 ? void 0 : room.localParticipant.metadata);
+    var managedParticipant = isManagedParticipantRole(localRole);
     var localParticipantIsActiveSpeaker = Boolean(access && (controlState === null || controlState === void 0 ? void 0 : controlState.activeSpeakerParticipantIdentity) === access.liveKit.participantIdentity);
     var canPublishNow = Boolean((currentParticipant === null || currentParticipant === void 0 ? void 0 : currentParticipant.canPublishAudio) || hasCapability('media:publish_audio') || localParticipantIsActiveSpeaker);
     var hasPendingSpeakRequest = Boolean(access && (controlState === null || controlState === void 0 ? void 0 : controlState.raisedHandParticipantIdentities.includes(access.liveKit.participantIdentity)));
@@ -18801,7 +19035,7 @@ function RoomPlatformControlBar(param) {
                             className: trackButtonClassName$1,
                             "data-control-state": enabled ? 'on' : 'off',
                             "data-lk-enabled": enabled,
-                            disabled: !canPublishNow || !room || isLocalMediaPending(kind),
+                            disabled: managedParticipant || !canPublishNow || !room || isLocalMediaPending(kind),
                             onClick: function() {
                                 return void setLocalMediaEnabled(kind, !enabled).catch(function() {
                                     return undefined;
@@ -20803,7 +21037,7 @@ var processorModeKey = function(mode) {
     return mode.mode === 'background-blur' ? "".concat(mode.mode, ":").concat(mode.blurRadius) : "".concat(mode.mode, ":").concat(mode.imagePath);
 };
 function useRoomPlatformCameraBackground(param) {
-    var localVideoTrack = param.localVideoTrack;
+    var localVideoTrack = param.localVideoTrack, onProcessorSettled = param.onProcessorSettled;
     var _ref, _ref1;
     var _uploadItems_find, _uploadItems_;
     var isSupported = typeof window !== 'undefined' && supportsBackgroundProcessors();
@@ -20931,7 +21165,7 @@ function useRoomPlatformCameraBackground(param) {
     }, [
         clearUploadPreviewUrls
     ]);
-    var ensureProcessor = useCallback(function(track, mode) {
+    var ensureProcessor = useCallback(function(track, mode, notifySettled) {
         return _async_to_generator$e(function() {
             var modeKey, currentEntry, processor;
             return _ts_generator$e(this, function(_state) {
@@ -20957,22 +21191,47 @@ function useRoomPlatformCameraBackground(param) {
                         _state.label = 2;
                     case 2:
                         return [
-                            2
+                            2,
+                            false
                         ];
                     case 3:
                         processor = BackgroundProcessor(mode);
+                        _state.label = 4;
+                    case 4:
+                        _state.trys.push([
+                            4,
+                            ,
+                            6,
+                            8
+                        ]);
                         return [
                             4,
                             track.setProcessor(processor, true)
                         ];
-                    case 4:
+                    case 5:
                         _state.sent();
+                        return [
+                            3,
+                            8
+                        ];
+                    case 6:
+                        return [
+                            4,
+                            notifySettled === null || notifySettled === void 0 ? void 0 : notifySettled(track)
+                        ];
+                    case 7:
+                        _state.sent();
+                        return [
+                            7
+                        ];
+                    case 8:
                         processorByTrackRef.current.set(track, {
                             processor: processor,
                             modeKey: modeKey
                         });
                         return [
-                            2
+                            2,
+                            true
                         ];
                 }
             });
@@ -21031,7 +21290,7 @@ function useRoomPlatformCameraBackground(param) {
                     2,
                     enqueueProcessorOperation(function() {
                         return _async_to_generator$e(function() {
-                            var nextObjectUrl, mode, preset, imagePath, _settings_uploadAssetId, _asset_mirroredBlob, asset, processorBlob, previousObjectUrl;
+                            var nextObjectUrl, mode, preset, imagePath, _settings_uploadAssetId, _asset_mirroredBlob, asset, processorBlob, processorSettledInEnsure, previousObjectUrl;
                             return _ts_generator$e(this, function(_state) {
                                 switch(_state.label){
                                     case 0:
@@ -21044,9 +21303,9 @@ function useRoomPlatformCameraBackground(param) {
                                     case 1:
                                         _state.trys.push([
                                             1,
-                                            8,
+                                            10,
                                             ,
-                                            9
+                                            11
                                         ]);
                                         if (!(settings.mode === 'none')) return [
                                             3,
@@ -21113,10 +21372,22 @@ function useRoomPlatformCameraBackground(param) {
                                     case 6:
                                         return [
                                             4,
-                                            ensureProcessor(localVideoTrack, mode)
+                                            ensureProcessor(localVideoTrack, mode, onProcessorSettled)
                                         ];
                                     case 7:
+                                        processorSettledInEnsure = _state.sent();
+                                        if (!!processorSettledInEnsure) return [
+                                            3,
+                                            9
+                                        ];
+                                        return [
+                                            4,
+                                            onProcessorSettled === null || onProcessorSettled === void 0 ? void 0 : onProcessorSettled(localVideoTrack)
+                                        ];
+                                    case 8:
                                         _state.sent();
+                                        _state.label = 9;
+                                    case 9:
                                         previousObjectUrl = activeObjectUrlRef.current;
                                         activeObjectUrlRef.current = nextObjectUrl;
                                         if (previousObjectUrl && previousObjectUrl !== nextObjectUrl) {
@@ -21137,7 +21408,7 @@ function useRoomPlatformCameraBackground(param) {
                                             2,
                                             true
                                         ];
-                                    case 8:
+                                    case 10:
                                         _state.sent();
                                         if (nextObjectUrl && activeObjectUrlRef.current !== nextObjectUrl) {
                                             URL.revokeObjectURL(nextObjectUrl);
@@ -21154,7 +21425,7 @@ function useRoomPlatformCameraBackground(param) {
                                             2,
                                             false
                                         ];
-                                    case 9:
+                                    case 11:
                                         return [
                                             2
                                         ];
@@ -21169,7 +21440,8 @@ function useRoomPlatformCameraBackground(param) {
         enqueueProcessorOperation,
         ensureProcessor,
         isSupported,
-        localVideoTrack
+        localVideoTrack,
+        onProcessorSettled
     ]);
     var saveAndApply = useCallback(function(input) {
         return _async_to_generator$e(function() {
@@ -21564,7 +21836,7 @@ function useRoomPlatformCameraBackground(param) {
                             case 0:
                                 if (!localVideoTrack) return [
                                     3,
-                                    5
+                                    6
                                 ];
                                 _state.label = 1;
                             case 1:
@@ -21572,7 +21844,7 @@ function useRoomPlatformCameraBackground(param) {
                                     1,
                                     3,
                                     4,
-                                    5
+                                    6
                                 ]);
                                 return [
                                     4,
@@ -21582,20 +21854,26 @@ function useRoomPlatformCameraBackground(param) {
                                 _state.sent();
                                 return [
                                     3,
-                                    5
+                                    6
                                 ];
                             case 3:
                                 _state.sent();
                                 return [
                                     3,
-                                    5
+                                    6
                                 ];
                             case 4:
                                 processors.delete(localVideoTrack);
                                 return [
-                                    7
+                                    4,
+                                    onProcessorSettled === null || onProcessorSettled === void 0 ? void 0 : onProcessorSettled(localVideoTrack)
                                 ];
                             case 5:
+                                _state.sent();
+                                return [
+                                    7
+                                ];
+                            case 6:
                                 clearActiveObjectUrl();
                                 return [
                                     2
@@ -21608,7 +21886,8 @@ function useRoomPlatformCameraBackground(param) {
     }, [
         clearActiveObjectUrl,
         enqueueProcessorOperation,
-        localVideoTrack
+        localVideoTrack,
+        onProcessorSettled
     ]);
     useEffect(function() {
         var restore = function() {
@@ -29307,9 +29586,10 @@ var RoomPlatformConnectedWorkspace = function(props) {
     }));
 };
 var RoomPlatformWorkspace = function(props) {
-    var _useRoomPlatform = useRoomPlatform(), localCameraTrack = _useRoomPlatform.localCameraTrack, room = _useRoomPlatform.room;
+    var _useRoomPlatform = useRoomPlatform(), localCameraTrack = _useRoomPlatform.localCameraTrack, reconcileLocalCameraAfterProcessor = _useRoomPlatform.reconcileLocalCameraAfterProcessor, room = _useRoomPlatform.room;
     var cameraBackground = useRoomPlatformCameraBackground({
-        localVideoTrack: localCameraTrack
+        localVideoTrack: localCameraTrack,
+        onProcessorSettled: reconcileLocalCameraAfterProcessor
     });
     return room ? /*#__PURE__*/ jsx(RoomPlatformConnectedWorkspace, _object_spread_props(_object_spread({}, props), {
         cameraBackground: cameraBackground

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naviedu/room-platform-react",
-  "version": "0.0.41",
+  "version": "0.0.43",
   "type": "module",
   "main": "./index.esm.js",
   "module": "./index.esm.js",