Skip to main content
Version: v1.2.0

Known Issues and Workarounds

  • Switching from landscape to portrait mode is buggy.

    Workaround: None.

  • The resolution reported in the HLS manifest is incorrect. It is set as the initially received resolution, which usually is much lower than what is possible and does not reflect any upscaling that happens during the duration of the webRTC connection.

    Workaround: None.

  • Broadcasting and viewing from a computer with an M1 CPU is buggy. You may see lower resolutions than expected and errors.

    Workaround: None.

  • Subsequent client instances created after the initial page is loaded may not respond to maxFramerate settings that are different from the first client instance.

    Workaround: Set StreamConfig only once, through the IVSBroadcastClient.create function when the first client instance is created.

  • On iOS, capturing multiple video device sources is not supported by WebKit.

    Workaround: Follow to track development progress.

  • On iOS, calling getUserMedia() once you already have a video source will stop any other video source retrieved using getUserMedia().

    Workaround: None.

  • WebRTC dynamically chooses the best bitrate and resolution for the resources that are available. Your stream will not be high quality if your hardware or network cannot support it. The quality of your stream may change during the broadcast as more or fewer resources are available.

    Workaround: Provide at least 200 kbps upload.

  • If Auto-Record to Amazon S3 is enabled for a channel and the Web Broadcast SDK is used, recording to the same S3 prefix may not work, as the Web Broadcast SDK dynamically changes bitrates and qualities.

    Workaround: None.

  • Minification can break builds when using the NPM distribution of the library. For example, the default minification options used by production builds result in a JavaScript error when creating the client.

    Workaround: Exclude the library from minification. For create-react-app specifically, to bypass this issue, enable profiling mode when doing a production build: npm run build -- --profile.

Safari Limitations

  • Denying a permissions prompt requires resetting the permission in Safari website settings at the OS level.
  • Safari does not natively detect all devices as effectively as Firefox or Chrome. For example, OBS Virtual Camera does not get detected.

Firefox Limitations