@cloudflare/realtimekit-react-native 1.1.0 → 1.2.0-staging.1

package/lib/module/LocalMediaHandler.js

@@ -19,6 +19,19 @@ const {
 } = NativeModules;
 export const broadcastEmitter = new NativeEventEmitter(BroadcastEventEmitter);
 
+// ---------------------------------------------------------------------------
+// Meeting foreground service config
+// Set by LocalMediaHandler.configure() before the first init() call.
+// ---------------------------------------------------------------------------
+
+let _meetingServiceConfig = {
+  enabled: true,
+  title: 'In a call',
+  text: 'Tap to return to your meeting',
+  channelId: 'rtk_meeting',
+  channelName: 'Ongoing Meeting'
+};
+
 // eslint-disable-next-line no-shadow
 export let MediaEvents = /*#__PURE__*/function (MediaEvents) {
   MediaEvents[MediaEvents["AUDIO_TRACK_CHANGE"] = 0] = "AUDIO_TRACK_CHANGE";
@@ -45,26 +58,6 @@ var _broadcastEmitter = /*#__PURE__*/new WeakMap();
 var _broadcastStartedSubscription = /*#__PURE__*/new WeakMap();
 var _broadcastStoppedSubscription = /*#__PURE__*/new WeakMap();
 export default class LocalMediaHandler extends EventEmitter {
-  async configureForeground() {
-    if (Platform.OS !== 'android') return;
-    const val = await RTKHelper.isForegroundServiceRunning();
-    if (!val) {
-      if (Platform.Version >= 33) {
-        const res = await PermissionsAndroid.request(PermissionsAndroid.PERMISSIONS.POST_NOTIFICATIONS);
-        if (res !== PermissionsAndroid.RESULTS.GRANTED) {
-          console.warn('Permission required for screenshare notification');
-        }
-      }
-      if (Platform.Version >= 26) {
-        await RTKHelper.createNotificationChannel();
-      }
-      try {
-        await RTKHelper.startService();
-      } catch (e) {
-        console.warn('Failed to start foreground service', e);
-      }
-    }
-  }
   constructor(localMediaUtils) {
     super();
     _classPrivateFieldInitSpec(this, _localMediaUtils, void 0);
@@ -88,9 +81,15 @@ export default class LocalMediaHandler extends EventEmitter {
     _classPrivateFieldInitSpec(this, _broadcastStartedSubscription, void 0);
     _classPrivateFieldInitSpec(this, _broadcastStoppedSubscription, void 0);
     _defineProperty(this, "_handleAppStateChange", nextAppState => {
-      if (_classPrivateFieldGet(_appState, this).match(/inactive|background/) && nextAppState === 'active') {
-        BackgroundTimer.clearInterval(_classPrivateFieldGet(_interval, this));
-        _classPrivateFieldSet(_interval, this, null);
+      const prevAppState = _classPrivateFieldGet(_appState, this);
+      _classPrivateFieldSet(_appState, this, nextAppState);
+      if (prevAppState.match(/inactive|background/) && nextAppState === 'active') {
+        // App returned to foreground — stop the background keep-alive timer
+        // and kick the video track to recover the camera feed.
+        if (_classPrivateFieldGet(_interval, this) !== null) {
+          BackgroundTimer.clearInterval(_classPrivateFieldGet(_interval, this));
+          _classPrivateFieldSet(_interval, this, null);
+        }
         if (this.videoTrack) {
           this.videoTrack.enabled = false;
           setTimeout(() => {
@@ -99,16 +98,23 @@ export default class LocalMediaHandler extends EventEmitter {
             }
           }, 100);
         }
-      } else {
-        if (_classPrivateFieldGet(_interval, this) === null) {
-          if (this.screenShareEnabled || this._pendingScreenShare) {
-            this.configureForeground();
-          }
+      } else if (nextAppState.match(/inactive|background/)) {
+        // App moved to background — start a recurring no-op timer to keep the
+        // JS thread alive so WebRTC/native events continue to be processed.
+        // Clear any existing interval first to avoid accumulation.
+        if (_classPrivateFieldGet(_interval, this) !== null) {
+          BackgroundTimer.clearInterval(_classPrivateFieldGet(_interval, this));
         }
         _classPrivateFieldSet(_interval, this, BackgroundTimer.setInterval(() => {}, 1000));
-        _classPrivateFieldSet(_appState, this, nextAppState);
       }
     });
+    // Arrow function so `this` is stable — the same reference is used in both
+    // addEventListener (setScreenShareTracks) and removeEventListener
+    // (removeScreenShareTracks).  A regular method + .bind(this) creates a new
+    // function object on every call, making removeEventListener a no-op.
+    _defineProperty(this, "onScreenShareEnded", () => {
+      this.emit('SCREENSHARE_ENDED');
+    });
     _classPrivateFieldSet(_localMediaUtils, this, localMediaUtils);
     _classPrivateFieldSet(_broadcastEmitter, this, broadcastEmitter);
     _classPrivateFieldSet(_appState, this, '');
@@ -486,6 +492,11 @@ export default class LocalMediaHandler extends EventEmitter {
     if (Platform.OS === 'android') {
       _classPrivateFieldSet(_appStateSubscription, this, AppState.addEventListener('change', this._handleAppStateChange));
     }
+
+    // Start the meeting foreground service so Android keeps the app alive
+    // in the background during a call. The app is guaranteed to be in the
+    // foreground at this point (user just tapped join / setup screen).
+    await this.startMeetingService();
   }
   stopScreenShareTracks(tracks = {}) {
     const {
@@ -493,20 +504,22 @@ export default class LocalMediaHandler extends EventEmitter {
       video = true
     } = tracks;
     if (audio) {
-      var _this$screenShareTrac;
+      var _this$screenShareTrac, _this$screenShareTrac2;
       (_this$screenShareTrac = this.screenShareTracks) === null || _this$screenShareTrac === void 0 || (_this$screenShareTrac = _this$screenShareTrac.audio) === null || _this$screenShareTrac === void 0 || _this$screenShareTrac.stop();
+      (_this$screenShareTrac2 = this.screenShareTracks) === null || _this$screenShareTrac2 === void 0 || (_this$screenShareTrac2 = _this$screenShareTrac2.audio) === null || _this$screenShareTrac2 === void 0 || _this$screenShareTrac2.release();
     }
     if (video) {
-      var _this$screenShareTrac2;
-      (_this$screenShareTrac2 = this.screenShareTracks) === null || _this$screenShareTrac2 === void 0 || (_this$screenShareTrac2 = _this$screenShareTrac2.video) === null || _this$screenShareTrac2 === void 0 || _this$screenShareTrac2.stop();
+      var _this$screenShareTrac3, _this$screenShareTrac4;
+      (_this$screenShareTrac3 = this.screenShareTracks) === null || _this$screenShareTrac3 === void 0 || (_this$screenShareTrac3 = _this$screenShareTrac3.video) === null || _this$screenShareTrac3 === void 0 || _this$screenShareTrac3.stop();
+      (_this$screenShareTrac4 = this.screenShareTracks) === null || _this$screenShareTrac4 === void 0 || (_this$screenShareTrac4 = _this$screenShareTrac4.video) === null || _this$screenShareTrac4 === void 0 || _this$screenShareTrac4.release();
     }
     if (audio && video) {
       this.screenShareEnabled = false;
     }
   }
   removeScreenShareTracks(tracks) {
-    var _this$screenShareTrac3;
-    (_this$screenShareTrac3 = this.screenShareTracks.video) === null || _this$screenShareTrac3 === void 0 || _this$screenShareTrac3.removeEventListener('ended', this.onScreenShareEnded);
+    var _this$screenShareTrac5;
+    (_this$screenShareTrac5 = this.screenShareTracks.video) === null || _this$screenShareTrac5 === void 0 || _this$screenShareTrac5.removeEventListener('ended', this.onScreenShareEnded);
     this.stopScreenShareTracks(tracks);
     this.screenShareTracks = {
       audio: undefined,
@@ -538,7 +551,7 @@ export default class LocalMediaHandler extends EventEmitter {
     this.videoTrack = videoTrack;
   }
   setScreenShareTracks(tracks) {
-    var _this$screenShareTrac4;
+    var _this$screenShareTrac6;
     const {
       audio,
       video
@@ -550,10 +563,7 @@ export default class LocalMediaHandler extends EventEmitter {
       });
     }
     this.screenShareTracks = tracks;
-    (_this$screenShareTrac4 = this.screenShareTracks.video) === null || _this$screenShareTrac4 === void 0 || _this$screenShareTrac4.addEventListener('ended', this.onScreenShareEnded.bind(this));
-  }
-  onScreenShareEnded() {
-    this.emit('SCREENSHARE_ENDED');
+    (_this$screenShareTrac6 = this.screenShareTracks.video) === null || _this$screenShareTrac6 === void 0 || _this$screenShareTrac6.addEventListener('ended', this.onScreenShareEnded);
   }
   async disableAudio() {
     await this.toggleAudio();
@@ -679,53 +689,19 @@ export default class LocalMediaHandler extends EventEmitter {
       return;
     }
   }
-  async toggleScreenShare() {
-    if (this.screenShareEnabled && Platform.OS !== 'ios') {
-      this.removeScreenShareTracks();
-      try {
-        const val = await RTKHelper.isForegroundServiceRunning();
-        if (val) {
-          await RTKHelper.stopService();
-        }
-      } catch (e) {
-        console.warn('Failed to stop foreground service', e);
-      }
-      return;
-    }
-    if (Platform.OS === 'ios' && this.screenShareEnabled) {
-      NativeModules.RTKScreensharePickerView.showScreenSharePickerView();
-      _classPrivateFieldSet(_screenShareState, this, 'PENDING');
-      await new Promise((resolve, reject) => {
-        let timeoutId;
-        let time = 0;
-        timeoutId = setInterval(() => {
-          if (_classPrivateFieldGet(_screenShareState, this) === 'STOPPED') {
-            clearInterval(timeoutId);
-            resolve();
-          }
-          time = time + 100;
-          if (time > 20000) {
-            clearInterval(timeoutId);
-            reject('Timeout exceeded for disableScreenShare()');
-          }
-        }, 100);
-      });
-      return;
-    }
+  async enableScreenShare() {
+    // Guard: do nothing if already sharing or a consent dialog is in flight.
+    if (this.screenShareEnabled || this._pendingScreenShare) return;
     if (Platform.OS === 'android') {
       this._pendingScreenShare = true;
-      await this.configureForeground();
       try {
+        // getScreenShareTracks() manages the full flow:
+        // consent dialog → start MediaProjectionService → create MediaStream
         this.setScreenShareTracks(await LocalMediaUtils.getScreenShareTracks());
         this.screenShareEnabled = true;
       } catch (e) {
         console.warn('Failed to start screenshare', e);
         this.screenShareEnabled = false;
-        const val = await RTKHelper.isForegroundServiceRunning();
-        if (val) {
-          await RTKHelper.stopService();
-        }
-        this._pendingScreenShare = false;
       } finally {
         this._pendingScreenShare = false;
       }
@@ -750,11 +726,32 @@ export default class LocalMediaHandler extends EventEmitter {
       });
     }
   }
-  async enableScreenShare() {
-    await this.toggleScreenShare();
-  }
   async disableScreenShare() {
-    await this.toggleScreenShare();
+    // Guard: nothing to stop if not sharing and no consent dialog is pending.
+    if (!this.screenShareEnabled && !this._pendingScreenShare) return;
+    if (Platform.OS !== 'ios') {
+      this.removeScreenShareTracks();
+      return;
+    }
+
+    // iOS: trigger the broadcast picker to stop the extension.
+    NativeModules.RTKScreensharePickerView.showScreenSharePickerView();
+    _classPrivateFieldSet(_screenShareState, this, 'PENDING');
+    await new Promise((resolve, reject) => {
+      let timeoutId;
+      let time = 0;
+      timeoutId = setInterval(() => {
+        if (_classPrivateFieldGet(_screenShareState, this) === 'STOPPED') {
+          clearInterval(timeoutId);
+          resolve();
+        }
+        time = time + 100;
+        if (time > 20000) {
+          clearInterval(timeoutId);
+          reject('Timeout exceeded for disableScreenShare()');
+        }
+      }, 100);
+    });
   }
   getAllDevices() {
     return _classPrivateFieldGet(_localMediaUtils, this).availableDevices;
@@ -881,10 +878,45 @@ export default class LocalMediaHandler extends EventEmitter {
       this.emit('DEVICE_LIST_UPDATED', changedDevices);
     }
   }
+
+  /**
+   * Override the meeting foreground service config before the first meeting
+   * session.  Called by useRealtimeKitClient when keepAliveService is set.
+   */
+  static configure(config) {
+    _meetingServiceConfig = {
+      ..._meetingServiceConfig,
+      ...config
+    };
+  }
   static async init(_) {
     const localMediaUtils = await LocalMediaUtils.init();
     return new LocalMediaHandler(localMediaUtils);
   }
+  async startMeetingService() {
+    if (Platform.OS !== 'android') return;
+    if (!_meetingServiceConfig.enabled) return;
+
+    // Android 13+ (API 33): request POST_NOTIFICATIONS so the foreground-service
+    // notification appears in the shade.
+    if (Number(Platform.Version) >= 33) {
+      try {
+        await PermissionsAndroid.request(PermissionsAndroid.PERMISSIONS.POST_NOTIFICATIONS);
+      } catch (e) {
+        console.warn('Failed to request POST_NOTIFICATIONS permission', e);
+      }
+    }
+    try {
+      await RTKHelper.startMeetingService({
+        title: _meetingServiceConfig.title,
+        text: _meetingServiceConfig.text,
+        channelId: _meetingServiceConfig.channelId,
+        channelName: _meetingServiceConfig.channelName
+      });
+    } catch (e) {
+      console.warn('Failed to start KeepAliveService', e);
+    }
+  }
   emit(event, ...args) {
     return super.emit(event, ...args);
   }