React Native Core SDK
Compatibility: Works best with RealtimeKit React Native UI Kit 2.0.0 or later.
This is a major breaking release. Review all breaking changes below before upgrading.
Breaking changes
- Upgraded to
@cloudflare/realtimekitv2.0.0.
All breaking changes from Web Core v2.0.0 apply, including the complete redesign of the plugin API and removal of all deprecated APIs. - Requires React Native 0.84 or above and React 19 or above.
- Requires Expo 56 or above (for Expo users).
- Requires iOS 15.1 or above.
- Requires @cloudflare/react-native-webrtc v137.0.1 or above.
- Removed
RealtimeKitCoreimport in iOS Screenshare setup and added a Podfile installer script to automatically add references to the Screenshare related files. Refer documentation for iOS Screenshare setup. initClientreturn type changed fromPromise<RealtimeKitClient>toPromise<RealtimeKitClient | undefined>. Code that assumesinitClientalways returns a defined value must add a null check.
Features
Connected Meetingssupport: theuseRealtimeKitClienthook now automatically listens toconnectedMeetings.meetingChangedand hot-swaps the active client when switching between connected or breakout meetings.Background supportfor Android (enabled by default):- New exported type
KeepAliveServiceConfigto configure the Android meeting foreground service notification (title, body text, enable/disable). - New
useRealtimeKitClient({ keepAliveService })option to customize or disable the Android foreground notification. - New
useRealtimeKitClient({ resetOnLeave })option to reset client state on room leave.
- New exported type
Fixes
- Fixed an issue where the microphone did not work after being toggled if audio permission had not been granted before joining the meeting.
- Fixed an issue where the in-call notification on Android persisted after the meeting ended.
- Fixed an issue where screen sharing failed on the first attempt on Android 14 and above.
- Fixed an issue where stopping screen sharing did not properly clean up event listeners, which could cause screen sharing to malfunction in subsequent sessions.
Features
- Added a dedicated error code
0014for media (WebRTC) connection failures during room join, making it easier to distinguish media failures from socket and signaling failures.
Enhancements
- Init and join failures from
initMeeting()andmeeting.join()now surface specific error codes and descriptive messages instead of generic errors.
Fixes
- Fixed an issue where
ClientErrorobjects were wrapped inside each other when the SDK retried failed API requests, causing nested error messages and duplicateonErrorcallbacks.
Breaking changes
- Removed Hive SFU support. Only the Cloudflare SFU is supported going forward.
- The default base URI is now
realtime.cloudflare.com. CallinginitMeeting()with baseURI parameter set to adyte.iobase domain now throws an Error. RealtimeKitClientOptionsis renamed toRTKClientOptions.
Fixes
- Fixed an issue where sometimes after rejoining a meeting & upon stopping iOS screenshare, the app freezes.
Fixes
- Fixed the issue when leaving & rejoining a meeting causes the local media to stop working
- Fixed iOS screenshare stops broadcasting on Web when calling
meeting.self.disableScreenShare()but not clicking on 'Stop' on iOS Picker View.
Fixes
- Fixed bluetooth not showing in list/dropdown after rejoining meeting
- Fixed mobile active speaker not working after rejoining meeting
Breaking changes
- Starting from version v0.3.0, SDK now supports only React Native 0.77 and above.
Fixes
- Fixed 16KB page support in Android >=15
- Fixed foreground service failed to stop errors in Android
- Fixed bluetooth issues in iOS Devices
- Fixed android build issues due to deprecated jCenter in React Native 0.80 or higher
Fixes
- Fixed can't install multiple apps with expo sdk
- Fixed screenshare for Android in Expo with New Architecture enabled
- Fixed remote audio/video not working in group calls
Breaking changes
- Adding a
blob_provider_authoritystring resource is now mandatory. Refer to the installation instructions for more details.
Fixes
- Fixed audio switch to earpiece when leaving stage in Webinar
- Fixed types for useRealtimeKitClient options
- Fixed screenshare for Android in Expo
Fixes
- Fixed screenshare not working for Android 13 and later
- Fixed audio device switching not working
- Minor performance improvements