100ms Logo



Search docs

Release Notes

0.4.5 - 2022-10-06


  • Screenshare compatibility for iOS 16

0.4.3 - 2022-09-28


  • Session metadata API


  • Potential fix for a race condition where WebSocket message arriving post cleanup leading to a crash

0.4.2 - 2022-09-21


  • Audio coming from the earpiece instead of a speaker when joining with a non publishing role.
  • Fix missing headers compiler warning.

0.4.1 - 2022-09-09


  • HLS Extended metadata support
  • Zoom and pan gesture support for HMSVideoView can be enabled via isZoomAndPanEnabled property.


  • Headset microphone audio getting distorted when custom audio source is provided.

Breaking changes

  • Error reporting has been updating to match error codes on Android as well as to use iOS conventions for the error interface. See migration guide here for details.

0.3.3 - 2022-07-27


  • Support for local file playback and audio sharing
  • Support for Picture in Picture mode


  • Simplified HLS start API

0.3.2 - 2022-07-01


  • Add resolution variable in HMSRTMPConfig
  • Support message sending from REST API
  • Join performance improvements for large rooms


  • Reconnecting/reconnected callbacks triggered when new user joins
  • Fix HLS playback audio not routed to external speaker post role change

0.3.1 - 2022-05-31


  • Screenshare support
  • Virtual background
  • Custom video plugins API
  • Analytics capturing improvements

Breaking change

  • Removed tracksErrorAudioShouldBeSilenced error that was used to signal that other app is playing unmixable audio, it is now up to the app to detect for example using CallKit

0.2.13 - 2022-05-16


  • Local track state updates not being sent due to a bug in 0.2.12

0.2.12 - 2022-05-13


  • Track will not recover if it was unsubscribed from post being degraded

0.2.11 - 2022-04-28


  • Subscribe degradation improvements


  • onReconnected callback not fired in some scenarios

0.2.10 - 2022-04-21


  • Error 5000 returned when trying to rejoin from onError callback


  • Message in sendBroadcastMessage, sendDirectMessage and sendGroupMessage completion handlers will now have the timestamp set by the server instead of using local

0.2.9 - 2022-03-29


  • Network health callbacks in preview and mid call
  • Fix camera light going on for muted track post role change

0.2.8 - 2022-03-08


  • HMSHLSConfig constructor now takes HMSHLSRecordingConfig param to optionally enabled recording of HLS stream
  • hlsRecordingState property added to HMSRoom to show current recording state

0.2.7 - 2022-02-21


  • Recording/Streaming info will now have "started at" date
  • Room state and peer list are now available in preview mode (if enabled from dashboard) via on(room:update:) and on(peer:update:) callbacks in HMSPreviewListener


  • SDK interfering with apps querying device battery level

0.2.6 - 2022-01-28


  • Fixed connection issues for EU based rooms.

0.2.5 - 2022-01-20


  • Call stats API

0.2.4 - 2021-12-21


  • HLS Streaming API


  • Improved track switching delay in HMSVideoView


  • Track remove callback not fired in case of multiple auxiliary tracks were getting removed

0.2.3 - 2021-12-06


  • Microphone permission requested for view only role
  • Subscribe degradation not working
  • onError callback fired on non main thread for no mic/video permission error

0.2.2 - 2021-11-26


  • changeMetadata API
  • changeName API
  • setVolume API for HMSRemoteAudioTrack

0.2.1 - 2021-11-18

Breaking Change

  • requestedBy field has been made optional for HMSChangeTrackStateRequest, HMSRemovedFromRoomNotification, HMSRoleChangeRequest. It will be nil if request can originated from the REST API.
  • customerUserDescription field has been renamed to metadata in HMSPeer

0.1.6 - 2021-10-29


  • HMSLocalVideoTrack settings property is now properly reflecting cameraFacing state
  • Calling leave in preview mode no longer returns an error
  • Calling setMute on local video track stops camera access
  • Calling setMute on local tracks will now result in on(track: HMSTrack, update: HMSTrackUpdate, for peer: HMSPeer) callback fired for those tracks

0.1.5 - 2021-10-21

  • Removed Xcode 13 requirement

0.1.4 - 2021-10-13


  • Fixed leave call not taking effect

0.1.3 - 2021-10-11


  • hmsPeerStateDidChange notification added for convenience


  • Deprecated init(userName:userID:roomID:) of HMSConfig as same parameters are coming in the auth token

0.1.2 - 2021-09-30


  • preview(role:completion:) API added to support showing preview screen mid call

0.1.1 - 2021-09-23


  • changeRolesOfAllPeers API added to change roles of multiple peers at once
  • changeTrackState API variant added to mute/unmute multiple peers at once
  • startRTMPOrRecording and stopRTMPAndRecording APIs added to start/stop RTMP / browser recording


  • leave API now provides a completion handler that is called when leave operation has completed
  • HMSTrack source property type has been changed to String to allow custom track sources


  • onReconnecting callback was not firing upon network disconnect

0.0.12 - 2021-09-02


  • Swift package manager support
  • Bitcode support


  • Moved to xcframework

0.0.11 - 2021-08-25


  • HMSVideoView now has a mirror property that controls mirroring of the video.


  • changeRole API now can be used to change role of a local peer.

0.0.10 - 2021-08-17


  • Sending private and group messages APIs
  • Remove peer from a room API
  • Remote mute peer API
  • End room API
  • videoContentMode property added to HMSVideoView to allow selecting if content should fit or fill the view
  • videoTrack getter added HMSVideoView for convenience


  • send(message:) API renamed to sendBroadcastMessage

0.0.9 - 2021-08-05

  • Fixed individual track publish settings not respected during change role
  • Fixed wrong track source coming for trackRemoved update
  • Fixed button states not updating properly during role change in sample app

0.0.8 - 2021-07-26

  • HMSVideoView will auto pick the best fitting simulcast layer
  • Sample app will not show role change options if user does not have necessary permissions

0.0.7 - 2021-07-16

  • Added simulcast support
  • Added support for forced change role
  • HMSSpeaker now has a reference to HMSPeer instead of id

0.0.6 - 2021-07-09

  • Added capability to change role mid-call
  • Passing HMSRole object to peers
  • SDK checks for appropriate permissions before trying to publish audio & video
  • Corrected parsing of roles that do not subscribe to other roles

0.0.5 - 2021-07-02

  • Automatic video track switch off in bad network conditions.
  • Preview API added to the SDK, added preview screen to the sample app.

0.0.4 - 2021-06-25

  • Added Media Interruption Handling
  • Optimized network usage
  • Updated background to foreground transitions
  • Improved Error logging

0.0.3 - 2021-06-22

  • Removed private modules to fix installing failure

0.0.2 - 2021-06-16

  • Added Reconnection for reliability in bad network conditions
  • Handled network provider (WiFi to Mobile Data) transitions mid-call
  • Upgraded Data Source which apps can use to easily create customized views
  • Added descriptive Error Codes
  • Added Analytics to track SDK performance
  • Added default handing to app background/foreground transitions
  • Handled joining meetings in different roles
  • Multiple Sample App enhancements

0.0.1 - 2021-06-04

  • Simplified SDK interfaces that can power a fully-featured video conferencing application
    • join
    • leave
    • listeners for tracks/peers/other data
  • Features not covered in this release
    • Handling network disconnections (disconnect from wi-fi to 4g ends the call)
    • Handling subscription network degradations
    • Handling second order publish network degradations
    • Detailed analytics
    • Recording