Skip to main content

NanoPlayer - Release History

Please find more about the MOQ playback mode feature in our documentation​

For easy-to-use migration follow our guide​

[5.0.8]​

Release Notes​

This release resolves an issue with growing memory allocation during MOQ playback if audio is remaining muted from playback start. The update is recommended for NanoPlayer 5.0.x users.

Changelog​

Fixed​

  • increasing memory allocation when MOQ playback is started and remains in muted state

[5.0.7]​

Release Notes​

This release improves layout consistency for playback. When the nanoplayer view is disabled (style.view: false), the CSS property object-fit: contain was added to the MOQ playback CanvasElement to align its default video scaling behavior (aspect ratio preservation and letterboxing) with the HTMLVideoElement. All playback modes now display consistently without additional configuration.

Changelog​

Fixed​

  • default CanvasElement behavior for MOQ playback with style.view: false adjusted to match HTMLVideoElement behavior in MSE/HLS playback, ensuring similar display across all playback modes

[5.0.6]​

Release Notes​

This release fixes an fullscreen issue with MOQ playback on iOS 26.4 and higher where the video isn't visible. THIS UPDATE IS MANDATORY FOR NANOPLAYER 5.0.X USERS AND SHOULD BE APPLIED ASAP.

Changelog​

Fixed​

  • video not visible in fullscreen mode with MOQ playback on iOS 26.4 and higher

[5.0.5]​

Release Notes​

This update resolves a slight audio delay in MOQ playback that could gradually become noticeable after repeated stream switches and improves the robustness of config.general.serverDomain parsing for edge cases. In addition, onReady metrics have been improved, and an inconsistency in error emission for malformed or missing source configurations has been fixed.

Changelog​

Fixed​

  • slight audio delay in MOQ playback that could gradually become noticeable after repeated stream switches
  • ensure a dedicated error with code 5004 is emitted consistently when the source configuration is missing or incomplete

Improved​

  • metrics for the onReady event
  • robustness of config.general.serverDomain parsing for edge cases

[5.0.4]​

Release Notes​

This release includes an improvement to the overall resilience of the player’s error handling and recovery. It resolves an issue that caused a black screen during error recovery in MSE and HLS playback modes. Furthermore, it fixes a playback start error that occurred when MOQ mode was enabled without a configured server.webtransport URL.

Changelog​

Fixed​

  • an issue causing a black screen during error recovery in MSE and HLS playback modes.
  • a playback start failure that occurred when MOQ mode was enabled but no server.webtransport URL was provided in the configuration.

Improved​

  • Enhanced overall resilience of error handling and recovery mechanisms.

[5.0.3]​

Release Notes​

This release includes fixes htmlFor loading timeout behavior and fast-start buffer management, along with improved screen wake behavior on mobile devices. The loading timeout now properly resets when updating sources during the loading state. Separately, fast-start buffer requests are now prevented during playback to avoid unnecessary buffering. Additionally, mobile devices will stay active during MOQ mode playback, with screen dimming and locking disabled by default through the new playback.enableWakeLock setting.

Changelog​

Fixed​

  • loading timeout is now correctly reinstated after updateSource is called in the loading state.
  • prevent fast-start buffer from being requested by updateSource while in the playing state.

Improved​

  • mobile devices no longer dim or lock the screen during playback in MOQ mode, ensuring consistent behavior across browsers and playback modes.
    • controlled via playback.enableWakeLock (default: enabled)

[5.0.2]​

Release Notes​

This update fixes an issue with secure token playback on iOS ≤ 17.1 in H5Live-HLS mode, resulting in error code 4200.

Changelog​

Fixed​

  • secure token playback failing with error 4200 on iOS ≤ 17.1 in H5Live-HLS mode

[5.0.1]​

Release Notes​

This update fixes occasional audio lag in MOQ playback mode that could occur when larger faststart buffers were received and removes an unintended log line via console.log.

Changelog​

Fixed​

  • occasional audio lag in MOQ playback mode when larger faststart buffers are received
  • unintended log line via console.log

[5.0.0]​

Release Notes​

BREAKING CHANGE​

This major release introduces Media over QUIC (MoQ) playback, bringing next-generation streaming with ultra-low latency and real-time playback powered by modern web technologies like QUIC and WebCodecs. This unlocks smoother, more interactive streaming experiences while still maintaining full compatibility with proven playback modes such as WebSocket/MSE and H5Live-HLS. Playback control has also been improved. You can now set the player volume directly at startup, and the player performs smarter connection checks to ensure QUIC compatibility before playback begins. We have optimized the default settings to deliver faster startup times, lower latency, and more reliable adaptive streaming. When multiple quality levels are available, the player will automatically use adaptive bitrate (ABR). Finally, we have cleaned up outdated and rarely used features. Flash player and legacy iOS ≤ 9 native-HLS fallback modes have been removed, configuration options have been simplified, and older scaling modes have been retired to ensure a more consistent playback experience.

Changelog​

Added​

  • Media over QUIC transport and playback mode

    • utilizing the benefits of latest web technologies including WebTransport/QUIC and WebCodecs
    • pushing the boundaries of interactive real-time streaming
    • keeping full support of production proven playback modes using WebSocket/MSE and H5Live-HLS

  • new config setting playback.enableMediaOverQuic

    • enabling/disabling the new MoQ playback mode
    • true/false, default: true

  • new config setting playback.enableQuicConnectionProbe

    • enabling/disabling performing a connection probe at setup call to test WebTransport/QUIC connectivity
    • true/false, default: true

  • new config setting playback.volume

    • enabling setting the player's volume directly at setup call
    • range between 0.0 and 1.0, default: 1.0

Changed​

  • default values htmlFor improved performance and usability
    • config.playback.latencyControlMode: from "classic" to "balancedadaptive"
    • config.playback.automute: from false to true
    • config.playback.faststart: from false to true
    • source.startIndex: from 0/highest to n-1/lowest
    • source.options.adaption.rule: from "none" to "deviationOfMean2"
      • enabling ABR playback if more than one stream/entry is available

Removed​

  • flash player fallback mode
  • native hls fallback mode (iOS version ≤ 9)
  • deprecated single source configuration via config.source.h5live object
    • remaining valid source configurations are config.source.group and config.source.entries
  • scaling modes "resize" and "original"

[4.31.1]​

Release Notes​

This release includes fixes for fast-start buffer management and hls playback error recovery. Fast-start buffer requests are now prevented during playback to avoid unnecessary buffering. Furthermore, it resolves an issue that caused a black screen during error recovery in HLS playback mode.

Changelog​

Fixed​

  • prevent fast-start buffer from being requested by updateSource while in the playing state.
  • an issue causing a black screen during error recovery in HLS playback mode.

[4.31.0]​

Release Notes​

In this release, we introduce the new config option metrics.serverDomain, which allows you to configure a custom white-label domain htmlFor nanoStream Cloud metrics and telemetry endpoints.

Changelog​

Added​

  • option metrics.serverDomain enabling to configure a custom white-label domain name htmlFor nanoStream Cloud metrics/telemetry endpoints

[4.30.1]​

Release Notes​

This update resolves an issue on iOS 18.4+ that prevented video playback from starting when using HLS fallback mode. The issue affected WebView-based iOS apps that load the web application from local content, e.g. app bundle.

Changelog​

Fixed​

  • resolved an issue on iOS 18.4+ that prevented video playback from starting when using HLS fallback mode

[4.30.0]​

Release Notes​

In this update, additional media and network capabilities are now logged in the onReady event. An issue was fixed where the player view was not correctly set up after a failed bintu source configuration. Additionally, an issue was resolved to prevent metrics and event duplication when multiple setup calls happen in quick succession.

Changelog​

Added​

  • log additional media and network capabilities in onReady event

Fixed​

  • removed an issue where the player view was not properly set up following a failed bintu source configuration
  • resolved an issue that could cause metrics and event duplication when multiple setup calls occurred in rapid succession

Please find more about the stream switching and abr feature in our documentation​

[4.29.0]​

Release Notes​

This release introduces a new configuration option htmlFor adaptive bitrate (ABR) setups.

You can now omit specific renditions in ABR configurations using the new config.source.options.adaption.omitRenditions parameter. This parameter accepts an array of predefined quality identifiers (e.g., "high", "medium", "low") or stream entry indexes (e.g., 0, 1, 2, etc.), providing greater flexibility in tailoring adaptive bitrate playback.

Additionally, an issue affecting the config.source.options.adaption.downStep value in group configurations has been resolved, ensuring proper functionality.

These updates enhance flexibility and reliability in ABR setups.

Changelog​

Added​

  • introduced an option to omit specific renditions in ABR multi-stream configurations via Bintu stream group or entries:
    • new parameter: config.source.options.adaption.omitRenditions (type: array)
    • accepted values include predefined quality identifiers (type: string) or stream entry indexes (type: number):
      • qualities: "high", "medium-high", "medium", "medium-low", "low"
      • indexes: 0, 1, 2, etc.
    • see the feature description htmlFor more details

Fixed​

  • resolved an issue where the config.source.options.adaption.downStep value was not applied correctly when using group configurations

[4.28.0]​

Release Notes​

This update introduces improved error observability and enhanced player responsiveness. Startup errors now include detailed insights, making it easier to identify and resolve playback issues during the initial loading phase, including the first 30 seconds of playback. For full details, refer to our Startup Errors Documentation. Additionally, the player’s resizing behavior has been optimized, ensuring a smoother experience when the container dimensions change. These enhancements ensure a more reliable and user-friendly experience.

Changelog​

Added​

  • enhanced observability with additional information in the error event when identified as a startup error:
    • errors occurring during playback attempts in the initial loading phase, including the first 30 seconds of playback
    • htmlFor details, see Startup Errors Documentation

Improved​

  • optimized resizing behavior during player container dimension changes

[4.27.0]​

Release Notes​

This version includes a more robust conditioning htmlFor initial switch up which results in a faster up switch while using ABR. Applies to all platforms including iOS17, iOS18 and higher.

Changelog​

Improved​

  • initial switch up time htmlFor ABR

[4.26.1]​

Release Notes​

With this patch version, we resolved an issue during player.setup that could cause an unhandled exception.

Changelog​

Fixed​

  • error condition during player.setup that could result in an unhandled exception

[4.26.0]​

Release Notes​

This version includes several improvements. Playback attempts on mobile devices failing due to visibility state hidden at load start will now result in a dedicated event 1009. This allows htmlFor clearer differentiation from other startup errors, such as network or stream issues 2003 Not enough media data received. Further we improved playback start behavior in iOS WebView apps, which require user interaction htmlFor video playback in their WebView settings. Now, if a playback attempt is rejected due to missing user interaction, the player will emit error 1005 early on, allowing the application to prompt the user htmlFor interaction more quickly. Refer to recommended settings htmlFor iOS WebView:. In general find more information about error codes here: API NanoPlayer..errorcode.

Changelog​

Improved​

  • playback attempts on mobile devices failing due to visibility state hidden will now result in a dedicated error event with code 1009 and message Playback failed because the player was in visibility state 'hidden' at load start.
    • allowing to distinguish from network or stream related startup errors, e.g. 2003 Not enough media data received.

Fixed​

  • playback start behaviour in iOS WebView apps requiring user interaction htmlFor video playback mediaTypesRequiringUserActionForPlayback
    • in case of a playback attempt rejected due to missing user interaction, the player will now emit error 1005 Playback must be initialized by user gesture. early on
    • this enables the application to handle the condition faster by asking the user to interact
    • see recommended settings htmlFor iOS WebView:nanoplayer WebView iOS

[4.25.1]​

Release Notes​

In this patch release we enhanced the observability of player metrics to better monitor and ensure quality of service when using the Bintu configuration.

Changelog​

Improved​

  • observability in player metrics htmlFor quality of service in case of bintu configuration being used

[4.25.0]​

Release Notes​

With this release, we've implemented handling htmlFor repeated switch stream failures by introducing cooldown functionality, thereby enhancing the robustness of stream switching. Additionally, we've strengthened access to video elements, ensuring more reliable and stable functionality. Furthermore, we've resolved issues related to preventing multiple 2004 errors and event order discrepancies when a bintu stream group is not live during setup. Lastly, we've addressed a random playback error occurring when keepConnection was enabled, ensuring a smoother playback experience.

Changelog​

Added​

  • handling in case of repeated switch stream fails via cooldown functionality

Improved​

  • hardening video element access

Fixed​

  • redundant 2004 error in case a bintu streamgroup is not live at setup
  • random playback error with keepConnection enabled

[4.24.3]​

Release Notes​

This patch release is enabling H5Live-HLS fallbacks when access to ManagedMediaSource API is denied htmlFor locally loaded webpages in iOS WKWebView.

Changelog​

Fixed​

  • H5Live-HLS fallback in case of a denied access to the ManagedMediaSource API htmlFor locally loaded webpages in iOS WKWebView

[4.24.2]​

Release Notes​

This patch release addresses an autoPlay issue occurring when the application called player.unmute() without user interaction context. This issue could result in black frames or errors during playback start if unmuted playback was not permitted. Further we enhanced the smoothness of stream switches specifically in H5Live-HLS mode, providing a better viewing experience htmlFor users.

Changelog​

Fixed​

  • autoPlay issue in case of application calling player.unmute() without user interaction context that could lead to black frames or errors during playback start if unmuted playback was not permitted

Improved​

  • smoothness during stream switches in H5Live-HLS mode

[4.24.1]​

Release Notes​

The update addresses an issue where playback would become stuck after repeated stream switches or pause/play actions in H5Live-HLS mode on iOS devices. Specifically, the fix resolves problems encountered with H5Live-HLS fallback when using locally loaded web pages in iOS WKWebView.

Changelog​

Fixed​

  • playback stuck after repeated stream switches or pause/play in H5Live-HLS mode on iOS
    • H5Live-HLS fallback with locally loaded web pages in iOS WKWebView

[4.24.0]​

Release Notes​

This release comes with several improvements. We added the use of a new lean response option via the Bintu API, which improves response times. Further we improved the latency recovery during playback on desktop platforms when transitioning from a hidden to visible state, enhancing user experience. Moreover, we implemented measures to prevent buffering when quality adaptations occur in streams ingested via WebRTC, ensuring smoother streaming experiences. Additionally we improved the detection of iOS desktop mode and application of background suspension, ensuring consistent behavior across browsers and modes on iOS devices. Also we addressed a bug where stream switching failed while in a paused state with keepConnection and forcePlay options enabled, improving overall functionality and stability. We added a fix regarding the unintended fallback behavior in latency control mode fastadaptive to balancedadaptive htmlFor Safari versions 17.4 and above on MacOS Sonoma. The fallback was introduced in version 4.23.1. As a last point we enabled H5Live-HLS fallbacks when access to ManagedMediaSource API is denied htmlFor locally loaded webpages in iOS WKWebView.

Changelog​

Improved​

  • utilizing new lean response option htmlFor configuration via bintu API htmlFor a faster response
  • faster latency recovery of playback via desktop when returning from hidden to visible state
  • prevent buffering in case of quality adaptions in streams ingested via webrtc
  • iOS desktop mode detection and application of background suspension to ensure consisent behaviour across browsers and modes on iOS
  • use H5Live-HLS fallback in case of a denied access to the ManagedMediaSource API htmlFor locally loaded webpages in iOS WKWebView

Fixed​

  • stream switch failing in paused state with keepConnection and forcePlay options enabled
  • remove unintended fallback htmlFor latency control mode fastadaptive to balancedadaptive htmlFor Safari 17.4+ on MacOS Sonoma (introduced in 4.23.1)

Please find more about the latency control modes feature in our documentation​

[4.23.1]​

Release Notes​

In this latest release, we're exited to introduce enhanced playback support through the Managed Media Source API (MMSE) htmlFor iOS 17.1 and above. By default, this feature provides an upgraded media playback experience in line with desktop and Android platforms, resulting in improved latency, faster start-up times, and an overall enhanced user experience. In the event that MMSE API is unsupported or disabled, H5live-HLS will seamlessly take over on iOS.

Moreover, we've expanded support htmlFor the latency control mode balancedadaptive across all iOS versions. This empowers users to achieve lower latency while ensuring a smooth playback experience on iOS devices. For more detailed information, refer to our comprehensive feature description in the documentation.

Additionally, this version includes a general enhancement to buffer and latency control htmlFor H5live-HLS playback on iOS. These improvements contribute to an even more refined and optimized playback experience.

Changelog​

Added​

  • support htmlFor playback via Managed Media Source API (MMSE) on iOS 17.1 and higher
    • media playback workflow similar to desktop and Android
    • replacing h5live-HLS
    • improving: latency, start-up time, general UX
  • support htmlFor playback with latency control mode balancedadaptive on iOS (all versions)
    • configuration fallback from fastadaptive to balancedadaptive mode
    • improving: latency (control)

Improved​

  • buffer and latency control on iOS (all versions)
    • workflow similar to desktop and Android

Fixed​

  • false positive warning event related to switch.method configuration on iOS
  • reconnect behaviour in keepConnection mode
  • adaptive bitrate control after error recovery on iOS
  • redundant adaptive bitrate control down step attempts

Please find more about the fast playback start feature in our documentation​

[4.22.3]​

Release Notes​

This version is improving the detection of supported browsers htmlFor iOS WebView apps with customized user agent strings.

Changelog​

Improved​

  • detection of supported browsers htmlFor iOS WebView apps with customized user agent strings

[4.22.2]​

Release Notes​

This release introduces crucial improvements and fixes to elevate your streaming experience. We have addressed issues that had impacted playback on iOS devices, ensuring a smoother experience across various scenarios. This update focuses on improving playback latencies, stream switch buffering on iOS, fullscreen layout issues, and occasional exceptions during player destruction on iOS.

Changelog​

Improved​

  • preventing higher playback latencies of some webrtc ingest streams that show frequent resolution adaptions

Fixed​

  • randomly occurring issue that could lead to repeated buffering after stream switches on iOS
  • fullscreen layout issue after entering fullscreen mode more than one time
    • affected screens with display ratios higher/wider than the player including mobile landscape orientation
    • the bottom of the video was partially out of the display area
    • (the issue has been introduced in v4.22.0)
  • non critical exception occurring occasionally during player.destroy on iOS

[4.22.1]​

Release Notes​

This version fixes a rare issue that could lead to incorrect startup stats, mainly occuring if the browser or tab was not visible in LOADING state.

Changelog​

Fixed​

  • issue with incorrect startup stats in LOADING state at visibility hidden

[4.22.0]​

Release Notes​

This version is introducing the new Fast Start Mode feature that enhances playback start-up times with nanoStream Cloud. This cutting-edge addition allows you to significantly reduce startup times when initiating playback. Fast Start Mode can be enabled using the configuration setting config.playback.faststart. Please note that it is disabled by default, so you have full control over its activation. The unused option config.source.options.switch.fastStart has been deprecated.

Furthermore we have improved the Adaptive Bitrate (ABR) initial switch-up behavior in case of degraded network conditions. In addition, a layout issue that occured after exiting fullscreen mode in Safari 16.5 macOS has been fixed.

Changelog​

Added​

  • fast start mode feature htmlFor improved playback start-up times with nanoStream Cloud
    • can be enabled via boolean config.playback.faststart, disabled by default
    • fast start related values in onStreamInfo and onPlay event

Improved​

  • initial ABR switch up behaviour in case of degraded network conditions

Fixed​

  • layout issue after exiting fullscreen mode in Safari 16.5 macOS

Removed​

  • deprecated unused option config.source.options.switch.fastStart

Please find more about the media error recovery feature in our documentation​

[4.21.0]​

Release Notes​

This release brings a range of enhancements and fixes to improve your experience. We have made adjustments to iOS buffer control to ensure best performance with iOS 17. All metrics events now include an event counter and an indication of Document.visibilityState to provide deeper insights into user interactions. Furthermore we've worked on enhancing iOS playback recovery. In case of network interruptions or degradations, the iOS playback will be recovered more smoothly. An issue has been resolved that previously led to a false positive PLAYING state on iOS during network interruptions. This will result in more accurate playback status representation. In addition we've addressed an issue that could occasionally lead to an incomplete or empty stats object in the onPlay event.

Changelog​

Added​

  • iOS 17 related adjustment in iOS buffer control
  • indication of Document.visibilityState in all metrics events
  • event counter in all metrics events

Improved​

  • iOS playback recovery in case of network interruptions or degradations

Fixed​

  • prevent false positive playing state in case of iOS network interruptions
  • issue that could cause an incomplete or empty stats object in the onPlay event

[4.20.4]​

Release Notes​

This version fixes an issue that occurred when attempting media error recovery immediately after a switch stream fail on iOS. The issue was introduced in version 4.20.2. Additionally, an issue related to the interactionrequired error with code 1005 on iOS has been resolved. The onStreamInfo event will now be fired correctly before the onError and onPause events. This problem was introduced with the release of version 4.20.3.

Furthermore, a minor issue regarding the automute feature at delayed play attempts without prior or direct user interaction has been fixed. The same applies to unmute attempts without user interaction during playback, that was started in muted state. These attempts will now result in muted playback or, in the case of automute being disabled, in error 1005.

Changelog​

Fixed​

  • issue in case of a media error recovery immediately after a switch stream fail
  • correct emitting of onStreamInfo in case of the error 1005 interactionrequired on iOS
  • automute behaviour at delayed play or unmute attempts without prior or direct user interaction on iOS

[4.20.3]​

Release Notes​

This version is fixing an issue in context of a media error occuring during an ongoing stream switch. The issue has been introduced in version 4.20.2.

Changelog​

Fixed​

  • issue in context of a media error occuring during an ongoing stream switch

[4.20.2]​

Release Notes​

This version is adding further improvements htmlFor error handling and automatic recovery on iOS. The improvements include detection and automatic recovery in cases of stalled video playback due to decoding issues and in cases of buffering errors that could formerly lead to playback stopping. For further informations see the feature description htmlFor media error recoveries and the errorcode definitions in the documentation.

Another improvement is related to updateSource API calls made during LOADING state. Until now, updateSource API calls made during LOADING state could run into a loading timeout, especially if initiated late in the loading phase. This will now be prevented by removing the loading timeout in case of an updateSource API call during LOADING state.

The current playback time values in onStats events are now increasing continuously without setbacks after stream switches and error recoveries on iOS to be consistent with other platforms.

Furthermore an issue related to failing rejections of unmuted autoPlay on iOS has been fixed. The issue has been introduced in version 4.19.

Changelog​

Added​

  • detection and automatic recovery of stalled video playback due to decoding issues on iOS
    • related error: 3005 - 'An error occurred while hls playback when decoding video.'
  • detection and automatic recovery of buffering errors on iOS
    • related error: 3101 - 'An error occurred while buffering on hls playback.'
  • see errorcode definitions
  • see feature description

Improved​

  • timeout handling in case of updateSource API calls during LOADING state
  • current playback time monotonically increasing after stream switches and recoveries on iOS

Fixed​

  • failing rejections of unmuted autoPlay on iOS

[4.19.2]​

Release Notes​

This version is introducing improvements htmlFor error handling and automatic recovery on iOS. Playback interruptions in context of stream switches in iOS low power mode have been fixed. Furthermore robustness htmlFor fullscreen handling in multi-player use cases has been increased. The improvement htmlFor classic playback on iOS 15 to avoid buffer impacts after adjusting latency has now been applied htmlFor iOS 16 as well. This was introduced in version 4.15.0.

Changelog​

Improved​

  • automatic error recovery during an ongoing stream switch on iOS
  • playback speed ~1.0 on iOS 16 as standard to reduce rebuffering effects after latency adjustment

Fixed​

  • playback interruptions in context of stream switches in iOS low power mode
  • fullscreen handling with multiple player instances
  • unreasoned configuration warnings htmlFor event handlers onServerInfo and onFullscreenChange
  • added fields id, player, version, state in onFullscreenChange event object

Please find more about the stream group configuration feature in our documentation​

Please find more about secure playback with JWT in our documentation​

[4.18.0]​

Release Notes​

This version is introducing two new features.

Utilizing the new bintu stream group feature, it is now possible to configure an entire set of ABR streams by passing only the corresponding bintu stream group id via the player source configuration. This allows a much easier configuration htmlFor ABR playback. All existing options that are part of the configuration remain unchanged.

Please find more about the stream group configuration feature in our documentation.

Furthermore, this version is adding support htmlFor the new secure playback using JSON Web Token (JWT). The new token type can contain playback permissions htmlFor one or more stream names. This way a single token can be used htmlFor all secure use cases. It can be applied with the current entries configuration and with the new group configuration.

Please find more about secure playback with JWT in our documentation.

Since this version, the nanoStream Player will not attempt to autoplay non live streams configured via bintu stream ID or bintu group ID after the setup call. Instead it will pause with reason 'sourcestreamstopped' and emit the error event 2004 with message 'The source stream has been stopped.'. This will enable the nanoStream Player to properly initialize in the setup method and allow users to reattempt playback even if the stream was not in live state at the time of the initialization.

Changelog​

Added​

  • stream group configuration via config.source.group object
  • support htmlFor secure playback using JSON Web Token (JWT)

Improved​

  • player setup with bintu stream ID or bintu group ID if the stream in not live

Please find more about the video processing feature in our documentation​

[4.17.0]​

Release Notes​

This version is adding a new public event to the player. The event onActiveVideoElementChange is emitted when the active video element htmlFor playback has been created and if the element has been changed in case of a stream switch on iOS. The event data is providing the activeVideoElement and the complete videoElementList. Having a reference to the activeVideoElement simplifies use cases like drawing or rendering images to a canvas or saving snapshots from the video. See the api description of the event and our docs feature entry htmlFor more information.

Changelog​

Added​

  • new public event onActiveVideoElementChange
    • is emitted when the active video element htmlFor playback has been created and if the element has been changed in case of a stream switch on iOS
    • provides the videoElementList {Array.HTMLVideoElement} and the activeVideoElement {HTMLVideoElement} in the event data
    • see the api description

[4.16.0]​

Release Notes​

This version adds the possibility to set a general H5Live server domain. A domain can be applied via config.source.general.serverDomain. This can be especially useful with configurations via source.defaults or bintu.streamid. By default, these configurations are using the standard geo-load-balanced domain namest. Please find further information in our documentation regarding this feature.

In addition an issue in relation to timed out stream switches has been fixed. Previously this could lead to a temporarily inconsistent internal stream state.

Changelog​

Added​

  • new config parameter config.source.general.serverDomain
    • will override/modify all h5live server domains

Fixed​

  • internal stream state after timed out stream switches

[4.15.0]​

Release Notes​

This version is adding improvements htmlFor ABR playback. It implements a cooldown mechanism to control the next up-switch. Too frequent up- & down-switches will be prevented. This improves the user experience especially in case of slight but frequent buffer impacts e.g. in case of limited network ressources. Furthermore this release includes an improvement htmlFor classic playback on iOS 15 to avoid buffer impacts after adjusting latency. Also the visual switching behaviour on iOS has been improved to prevent a possible black frame effect.

Changelog​

Added​

  • ABR upswitch cooldown mechanism to avoid too frequent up- & down-switches in certain scenarios

Improved​

  • playback speed ~1.0 on iOS 15 as standard to reduce rebuffering effects after latency adjustment
  • z-index only htmlFor video element switch on iOS to avoid black frame effect

Please find more about the latency control modes feature in our documentation​

[4.14.2]​

Release Notes​

This release is solving issues related to the center view player controls and the layout in fullscreen mode. Previously in case the bottom control bar was disabled, the center view player control did not trigger related actions. It occured after a resize of the player e.g. upon entering the fullscreen mode or mobile device rotation. Furthermore a fullscreen layout issue has been resolved. Before, parts of the player were not being rendered inside of the display area under following circumstances: If CSS padding was set on the player div and the player's aspect ratio did not match the form factor of the screen.

Changelog​

Fixed​

  • center view player controls not triggering related actions if the bottom control bar was disabled
    • the issue occurred after a resize of the player (e.g. mobile device rotation or entering fullscreen mode)
  • potential layout issue in fullscreen mode
    • if CSS padding was set on the player div and the player's aspect ratio did not match the form factor of the screen

[4.14.1]​

Release Notes​

This release introduces two new latency control modes targeting especially lowest latency use cases like live auctioning. The latency control mode can be selected via the added config.playback.latencyControlMode configuration parameter. The established latency control mode is available as the 'classic' option which remains to be the default mode. In addition the new latency control modes 'balancedadaptive' and 'fastadaptive' have been added. According to the current stream and network conditions they can adjust the latency adaptively. This allows to achieve a lower latency while keeping the playback experience smooth. Please find further information in our feature description in the documentation.

Changelog​

Added​

  • added latency control modes and related configuration parameter
    • configuration parameter: config.playback.latencyControlMode
    • string values: 'classic', 'balancedadaptive', 'fastadaptive'

Improved​

  • improved handling in case of video frames being dropped by the browser

Please find more about the source defaults feature in our documentation​

[4.13.3]​

Release Notes​

This version includes a fix htmlFor a potential CSS layout issue in iOS fullscreen mode, that could lead to page elements unintendedly being displayed above the video layer. The issue has been introduced in version 4.13.2.

Changelog​

Fixed​

  • CSS layout issue in iOS fullscreen mode

[4.13.2]​

Release Notes​

This version provides an improvement htmlFor iOS metadata processing. The new mode is preventing occasionally delayed metadata on iOS and is enabled by default. To go back to legacy mode it can be disabled by setting the new parameter config.playback.metadataLowDelay to false. Also an issue with changing the metadata connection at stream switch on iOS with switch method 'client' has been solved. Further this patch includes a fix htmlFor a potential css related layout issue in iOS fullscreen mode.

Changelog​

Improved​

  • modified metadata processing to prevent occasionally delayed metadata on iOS
    • can be disabled via new parameter config.playback.metadataLowDelay set to false
    • default: true

Fixed​

  • change metadata connection on iOS at stream switch with switch method 'client'
  • prevent iOS fullscreen layout issue by adding !important flag to position

[4.13.1]​

Release Notes​

This version includes a patch regarding the player's style.scaling configuration and updateSource. If style.scaling is set to a different value as default 'letterbox' e.g. 'crop' or 'fill' this setting will now always be preserved during an updateSource call. Before the player styling was falling back to default values after an server-side updateSource call if the new target stream name and the previous stream name were the same. Further an issue with updateSource in PAUSED state with source.options.switch.forcePlay set to false and ABR enabled is solved, preventing unintended switching in PAUSED state.

Changelog​

Fixed​

  • style.scaling with non-default value will be preserved during updateSource with server-side switch to the same stream
  • initial switch up interval with ABR configured source will be prevented from starting in PAUSED state

[4.13.0]​

Release Notes​

This version introduces the new source defaults feature that simplifies the source configuration by adding defaults.service to the config.source object. If a service is set, the h5live.server object and the h5live.rtmp.url in each entry can be omitted. In this case defaults will be applied internally. Values htmlFor h5live.server and/or h5live.rtmp.url that are defined explicitly in the entry have priority. The available value htmlFor defaults.service is 'bintu' htmlFor using the standard nanoStream Cloud. See our docs feature entry htmlFor more information. Furthermore this release includes improvements in preventing exceptions in case of DOM access restrictions or unreachable DOM elements. A last change is regarding the metrics module of the player. The minimum value of the metrics.statsInterval parameter has been raised to 5 seconds.

Changelog​

Added​

  • new config.source parameter defaults.service htmlFor simplifying configuration if the standard nanoStream Cloud is used

Improved​

  • handling of DOM access restrictions or unreachable DOM elements

Changed​

  • minimum value of metrics.statsInterval set from 1 to 5 seconds

[4.12.1]​

Release Notes​

This version is fixing a layout issue in fullscreen mode on iOS that occurred if special CSS position settings in the page are used. It could happen that the player becomes invisible at first fullscreen entering. Furthermore it is containing a minor fix related to config source params object and multi stream configuration.

Changelog​

Fixed​

  • player invisibility issue at fullscreen enter on iOS with special CSS position settings
  • config source params object usage with multi stream configuration

[4.12.0]​

Release Notes​

This version is adding the option to configure the minimum number steps during an ABR initialized switch down via the adaption.downStep parameter. Potential related use case are configurations containing a higher number of qualities or configurations with rather close rendition bitrates. The detection of the available buffer time has been improved htmlFor iOS in general and iOS 15 in particular. A timing related condition that could lead to buffering after a stream switch has been fixed. The start-buffer calculation in bufferDynamic mode has been fixed to prevent out of range values. Assigning null values to non mandatory configuration parameters will no longer lead to a setup error.

Changelog​

Added​

  • new option config.source.options.adaption.downStep

    • htmlFor ABR automatic 'deviationOfMean' and 'deviationOfMean2' only

    • allows to define the minimum number of steps during a ABR initialized down switch via the adaption object

    • if the number of remaining lower renditions is smaller than the value then the switch will be performed to the lowest rendition

    • default value is 1

    • e.g.:

      "adaption": {
          "rule": "deviationOfMean2",
          "downStep": 2
      }

Improved​

  • detection of the available buffer time htmlFor iOS in general and iOS 15 in particular
  • config warning message in case of wrong configured properties of an entry

Fixed​

  • timing related condition that could lead to buffering after a stream switch
  • start-buffer calculation in cooldown if bufferDynamic is enabled
    • prevent lower values than the original configured start buffer value
  • assigning null values to non mandatory configuration parameters will no longer lead to a setup error

[4.11.3]​

Release Notes​

This version is fixing a video layout issue on iOS that occurred in the integrated WebView of a major social media app. Furthermore it is containing a fix related to the display of the player control bar after tapping on older iOS versions 12 and lower. The issues have been introduced in version 4.10.6. Moreover an issue with poster scaling and aspect ratio changing of the player is solved.

Changelog​

Improved​

  • validation of parameter config.source.startIndex

Fixed​

  • video layout issue on iOS in the integrated WebView of a major social media app
  • display of the player control bar after tapping on older iOS versions 12 and lower
  • poster scaling while aspect ratio of the player is changing

[4.11.0]​

Release Notes​

This version is adding improvements to the fullscreen mode in general and in particular htmlFor iOS.

The player background color can now be customized htmlFor standard and fullscreen mode separately via the new configuration parameter config.style.fullScreenBackgroundColor. The default value is the standard background color config.style.backgroundColor.

The following improvements to the fullscreen mode have been added htmlFor iOS Safari and Chrome

  • Preventing the page body from becoming visible during orientation changes and zoom gestures
  • The fullscreen background color will be applied to the notch areas present on iPhone X/11/12
  • Improved up/down swipe handling to hide/show browser address bars
  • Improved layout calculation in Chrome iOS
  • Restoring the initial page scroll position when exiting fullscreen mode
  • Player borders will be hidden in fullscreen mode

Changelog​

Added​

  • separate fullscreen background color parameter config.style.fullScreenBackgroundColor

Improved​

  • fullscreen appearance in Safari and Chrome iOS
    • preventing the page body from becoming visible during orientation changes and zoom gestures
    • the fullscreen background color will be applied to the notch areas present on iPhone X/11/12
    • improved up/down swipe to hide/show browser address bars
    • layout calculation in Chrome iOS
    • restoring the initial page scroll position when exiting fullscreen mode
    • player borders will be hidden in fullscreen mode

Fixed​

  • script error in nanoplayer-multi demo page

Please find more about the media error recovery feature in our documentation​

[4.10.6]​

Release Notes​

This version implements a fix htmlFor an issue with the control bar appearing by tapping the player's surface on iOS. The control bar didn't appear by tap in PAUSED state with keepFrame disabled.

Changelog​

Fixed​

  • control bar appearing in PAUSED state with keepFrame disabled on iOS

[4.10.5]​

Release Notes​

This version provides a fix htmlFor an error related to the player view. The issue occured in case of a rejected setup call or if the config.playback object was not defined in the configuration. The player view is enabled by default (config.style.view=true).

Changelog​

Fixed​

  • prevent view initialization error in case of:
    • setup call rejection with error 5xxx
    • undefined config.playback object

[4.10.4]​

Release Notes​

This version implements an automatic recovery workflow htmlFor certain media errors that can occure during playback. Recoverable errors are 3003, 3100 and 1008. The allowed number of recoveries within 60 seconds (default: 3) can be customized by the new config parameter playback.mediaErrorRecoveries. Further the support of the native HTMLMediaElement attribute crossOrigin is added and can be set via the new config parameter playback.crossOrigin. The values can be 'anonymous', 'use-credentials' and 'not-set' (default).

Part of this release are minor adjustments htmlFor metrics and an improvement of the Mac OS version detection. Also an issue with the interaction of the style.keepFrame and the style.poster (since 4.9.1) functionality is fixed. Now after a pause the last frame will be kept instead of displaying the poster image with keepFrame enabled.

Changelog​

Added​

  • automatic recovery workflow htmlFor media errors
    • recoverable error codes:
      • 3003 (media decode error)
      • 3100 (media source ended)
      • 1008 (hls playback error)
    • new config parameter (number) playback.mediaErrorRecoveries, default: 3, to set the number of max recoveries within 60 seconds
    • recoveries will be indicated by an onWarning event
    • sample warning message:
      • 'Recovering from media error 3003, recovery 1/3 within the last 60 seconds (12 total).'
    • if threshold reached the error will be thrown followed by a pause with reason 'playbackerror'
    • see playback section in config
    • see feature description
  • support of native crossOrigin attribute htmlFor HTMLMediaElements (applies to all player-internal video & image elements)
    • new config parameter (string) playback.crossOrigin, default: 'not-set'
    • sets or disables the native "crossOrigin" attribute htmlFor all internal video elements and images (poster)
    • possible values are:
      • 'anonymous'
      • 'use-credentials'
      • 'not-set' (default), if used the attribute will not be added
    • see playback section in config

Improved​

  • minor adjustment htmlFor metrics
  • Mac OS version detection

Fixed​

  • keepFrame functionality while poster is set (Note: keepFrame is not supported on iOS)

[4.9.2]​

Release Notes​

This version comes with several small improvements and fixes. An infinite loop related to error code 1004 is now prevented. It occurred if play or pause was triggered before the player setup was finished. This non-critical error 1004 has been changed now to a warning. Further providing the correct Mac OS X version htmlFor player metrics has been improved and a wrong detection of unsupported Chromium browsers on Mac OS X has been fixed (introduced in 4.9.1). Also an error on iOS with the keepConnection option enabled has been fixed.

For the view a small fix htmlFor the style option config.style.audioPlayer related to the displayed height on mobile devices has been done.

Changelog​

Improved​

  • change non-critical error 1004 to warning "A pause call has been ignored since the player has not been set up successfully."
  • provide correct Mac OS X version to player metrics
  • correct player height on mobile devices if config.style.audioPlayer set to true

Fixed​

  • prevent infinite loop related to error code 1004 in case of play/pause before player is ready
  • unsupported browser detection htmlFor Chromium on Mac OS X if codecs not present (introduced in 4.9.1)
  • playback starts on iOS with config.playback.keepConnection set to true

[4.9.1]​

Release Notes​

This version introduces a redesign of the player internal icons and control bar appearance including customizable colors and transparency. The default color scheme is providing a more modern and familiar look and feel. The symbol color can be customized via the config.style.symbolColor parameter (default: "rgba(244,233,233,1)"). The control bar background color can be customized via the config.style.controlBarColor parameter (default: "rgba(0,0,0,0.5)"). The given color string can be a valid css (case insensitive) keyword, hex code with/without alpha, rgb, rgba, hsl or hsla. Example values: "white", "#ffffff", "rgba(237,125,14,0.5)". The highlighting of the clickable buttons can be disabled via config.style.buttonHighlighting=false. The animation of the clickable buttons can be disabled via config.style.buttonAnimation=false. Also the cursor at button mouseover (default: "pointer") can be customized over config.style.buttonCursor by passing a valid css cursor keyword or url.

Furthermore support htmlFor poster images has been added. Poster images can be applied via the config.style.poster parameter. The string has to be a relative or absolute path to a valid "img" element source like "./assets/poster.png" or "https://[YOURDOMAIN]**/assets/poster.gif".

Changelog​

Added​

  • redesign of the player internal icons and control bar appearance
  • customizable icon and control bar background colors and transparency
  • customizable button behaviour
  • support htmlFor poster images

Improved​

  • iOS desktop mode detection and handling in Safari and Chrome

Fixed​

  • setVolume method not applying the value 0/zero
  • use 'parentNode' instead of 'parentElement'

[4.8.1]​

Release Notes​

This version improves the compatibility of the player. The 'toLocaleTimeString' functionality was replaced to avoid potential issues with javascript polyfills.

Changelog​

Improved​

  • remove 'toLocaleTimeString' usage

[4.8.0]​

Release Notes​

This version introduces a new error code. In case the media element fires an error event without a specifc error code the new player error code 3200 with the message An unspecific media error occurred. will be passed in the onError event. Furthermore a WebSocket prototype polyfill is removed completely. This finally solves a compatibility issue with connection handling with angular/zone.

Changelog​

Improved​

  • add new error code 3200 - An unspecific media error occurred.
  • removed WebSocket prototype polyfill

Please find more about the fullscreen API feature in our documentation**​

[4.7.8]​

Release Notes​

This version patches minor issues. One patch addresses a compatibility issue with angular zone.js. The other one improves the behaviour of internal iframe handling on iOS in case of unavailability.

Changelog​

Improved​

  • check htmlFor WebSocket event listener manipulation, use default 'on' syntax internally
  • improved internal iframe handling on iOS in case of unavailibility

[4.7.6]​

Release Notes​

This version implements minor internal improvements htmlFor config validation and playback start. It also contains a fix related to playback suspension on iOS devices running Safari with activated desktop mode.

Furthermore, the default overlay controls are displayed properly on smaller screen widths.

Changelog​

Improved​

  • config validation and playback start
  • playback suspension on iOS devices and Safari with activated desktop mode
  • display of default overlay controls on smaller screen widths

[4.7.1]​

Release Notes​

This version implements the fullscreen API which enables to request and exit the player's fullscreen mode. The new public event 'onFullscreenChange' indicates that the fullscreen mode has been changed.

The animations and icons in the center of the player can now be independently enabled or disabled by setting the new style.centerView config property to either true or false.

Changelog​

Added​

  • fullscreen API
    • new public methods: 'requestFullscreen()' , 'exitFullscreen()'
    • new public event: 'onFullscreenChange'
  • enable / disable animations and icons in the center of the player independently with style.centerView config property

[4.6.1]​

Release Notes​

By enabling the source.options.switch.forcePlay config property a paused playback starts after the execution of a 'switchStream' or 'updateSource' request. This obviates the need htmlFor an additional play call. To improve the overall switching behavior paused switch completion has been added, meaning a pending 'switchStream' or 'updateSource' request will be completed as the player enters the paused state. The related completion event either 'switchStreamSuccess' or 'updateSourceSuccess' will be emitted to the application level.

This version prevents an occasional CPU load issue on Firefox. To provide additional information to the client metrics the new public event 'onServerInfo' has been added. Version 4.6.1 implements an updated version of the Bintu-Client API internally.

Changelog​

Added​

  • paused switch completion to complete pending 'switchStream' or 'updateSource' request as player enters paused state
  • public event 'onServerInfo'

Improved​

  • source.options.switch.forcePlay config property starts a paused playback after 'switchStream' or 'updateSource' request execution
  • prevent an occasional CPU load issue on Firefox
  • implement updated version of Bintu-Client API

[4.5.6]​

Release Notes​

This version contains improvements htmlFor stream swiching, buffering metrics validation and connection flags.

Changelog​

Improved​

  • stability of general stream switching
  • validation of buffering metrics
  • connection flags setting

[4.5.2]​

Release Notes​

This version contains a minor internal metrics adjustment.

Changelog​

Improved​

  • minor metrics adjustment

[4.5.1]​

Release Notes​

This version implements seamless ABR and stream switching htmlFor iOS and iPadOS devices which works with 2 video elements internally. In special use cases where external video elements are used htmlFor playback an array of maximal two external video element IDs can be provided via the playback.videoId config property. Important note: On iOS devices the default z-index of the video layer had to be changed from 0 to 1. In case of using custom controls or overlays please make sure to use a z-index > 1.

The new ABR mode, adaption rule, 'deviationOfMean2' has been added. The new rule is slightly less strict and especially recommended htmlFor streams that are already more volatile on the source/ingest side.

This version adjusts the default timeout htmlFor the update source request to 20 seconds to improve the overall switching behavior.

The style.displayMutedAutoplay config property is re-enabled which shows a muted audio symbol in case of muted autoplay. The style.displayMutedAutoplay option can be disabled to maintain the recent behaviour. The handling of mute states and autoPlay has been improved.

Changelog​

Added​

  • seamless ABR and stream switching htmlFor iOS and iPadOS devices
  • new adaption rule 'deviationOfMean2'

Improved​

  • iOS & iPadOS seamless stream switching needs 2 video elements internally. So htmlFor special use cases where existing video tags need to be used htmlFor playback an array of maximal two element Ids can be provided via the playback.videoId config property (NOT mandatory)
    • if 0 Ids are provided 2 video elements will be created internally
    • if 1 Id is provided the other video element will be created internally
  • set the default timeout htmlFor the update source request to 20 seconds to improve the overall switching behavior
    • can be configured via the source.options.switch.timeout config property (we advise to use default value)
  • re-enabled style.displayMutedAutoplay config property to show a muted audio symbol in case of muted autoPlay
  • handling of mute states and autoPlay

[4.3.2]​

Release Notes​

This version introduces the 'setAdaption' API to switch between adaption rules (ex. enable/disable ABR). Furthermore, this version implements optimizations htmlFor the ABR feature and minor internal, config and metrics adjustments. Additionally, this version prevents non-critical console errors during initialization and fixes a timeout error during client-side switchStream/updateSource.

Please find more about setAdaption API in our documentation.

Changelog​

Added​

  • 'setAdaption' API:
  • use to switch between adaption rules (ex. enable/disable ABR)

Improved​

  • ABR:
  • initial switch up htmlFor oscillating source streams
  • handle continuous buffering events
  • config:
  • adjust switchStream event registration
  • enable bintu multi-stream configuration
  • minor metrics improvement
  • prevent non-critical console errors during initialization in 'hidden' state

Fixed​

  • timeout error during client-side switchStream/updateSource

[4.2.5]​

Release Notes​

This version handles the usage of metrics with the old deprecated single stream configuration over 'config.source.h5live'.

See our documentation htmlFor detailed information about the new stream configuration.

Changelog​

Fixed​

  • handle deprecated 'config.source.h5live' notation htmlFor correct metrics

[4.2.4]​

Release Notes​

This version removes a warning in case only a single stream is configured.

Changelog​

Improved​

  • remove adaption rule warning if only one entry configured

[4.2.3]​

Release Notes​

This version handles a timestamp offset caused by stream switching to make correct time operations.

Changelog​

Fixed​

  • note timestamp offset after stream switch

[4.2.2]​

Release Notes​

This version comes with further ABR and internal improvements and also corrects switch related parts.

Changelog​

Improved​

  • ABR suggestion performance
  • overall internal optimizations

Fixed​

  • always set new connection when updating source with new server
  • correct error object on initialization error when updating source

[4.2.1]​

Release Notes​

This version communicates additional switchStream and updateSource API related data to the metrics service. Furthermore, the ABR prediction cycle is improved to reduce load.

Changelog​

Improved​

  • additional switchStream and updateSource API event data to metrics
  • optimize ABR prediction cycle

[4.2.0]​

Release Notes​

This version implements the communication of switchStream and updateSource API events and data to the metrics service. In addition the internal 'streamInfo' event flow is improved and detailed stream information propagated through the event object.

Please find more about the stream switching & ABR feature in our documentation.

Changelog​

Added​

  • communication of switchStream and updateSource API events and data to metrics service

Improved​

  • internal 'streamInfo' event flow optimized
  • propagate additional stream information with 'streamInfo' event

[4.1.4]​

Release Notes​

This version contains a fix htmlFor an buffering state error on iOS if static buffer tweaks are set. Now higher 'min' values doesn't lead into unrecoverable buffering.

Changelog​

Fixed​

  • handle higher buffer tweak 'min' values in buffercontrol

[4.1.3]​

Release Notes​

This version implements a fix htmlFor an ‘Unhandled Promise Rejection’ error on iOS in the context of play/pause and updateSource/switchStream interactions. Furthermore, this version fixes a bug on MacOSX Mojave during buffer underrun where the playing state is not changed to ‘buffering’ which then breaks the playback.

Changelog​

Fixed​

  • ‘Unhandled Promise Rejection’ error on iOS during play/pause and updateSource/switchStream interactions
  • correctly detecting buffer underrun htmlFor MacOSX Mojave bug

[4.1.2]​

Release Notes​

This version implements a fix to support the regular config as well as an adaptive config to setup the player.

Changelog​

Fixed​

  • config assemble during player setup

[4.1.1]​

Release Notes​

This version implements fixes to support the initial switchUp on iOS devices.

Changelog​

Fixed​

  • handle pause reason 'playbackrestart' differently to fix initial switchUp on iOS
  • set prediction block during initial switchUp

[4.1.0]​

Release Notes​

This version introduces adaptive bitrate (ABR) playback where the player switches between a set of streams with different qualities to accommodate challenging network situations and avoid buffering and frame drops. A set of stream sources (entries) is expected inside the 'entries' array of the config's 'source' object. Each entry represents an indexed quality step starting with the highest quality at index 0. The 'startIndex' property sets the entry that should be used htmlFor inializing the playback. The config's 'source' object now holds an 'options' object to set the ABR 'rule' (algorithm) inside the 'adaption' object and the switch options inside the 'switch' object. To manually switch between entries the new 'switchStream' API is used which comes along with 4 new public events and error codes.

Please find more about the stream switching & ABR feature in our documentation.

Changelog​

Improved​

  • config object:
    • entries: keeps a set of indexed stream sources which represent a quality step
    • options:
      • adaption: set ABR rule
      • switch: set switch settings
    • startIndex: sets the entry used htmlFor inializing the playback
  • 'switchStream' API:
    • use to switch between entries
    • new public events: 'onSwitchStreamInit', 'onSwitchStreamSuccess', 'onSwitchStreamAbort' and 'onSwitchStreamFail'
    • new error code:
      • 1010: in case an invalid entry index is given as parameter over 'switchStream'
  • 'updateSource' API:
    • use to set a new source (ex. with different entries, adaption/switch options)
    • the updateSource method now uses the switch options set inside the config's source object instead of the parameters supplied via the method call

[4.0.8]​

Release Notes​

This version contains an improvement of the buffer state detection on Mac OS X Mojave and iOS. Non critical ‘Unhandled Promise Rejection’ logs on iOS during play/pause interactions are now being prevented.

Changelog​

Improved​

  • Buffer state detection on Mac OS X Mojave and iOS
  • Preventing non critical ‘Unhandled Promise Rejection’ logs on iOS during play/pause interactions

[4.0.7]​

Release Notes​

This version patches an issue with iOS 10 playing state detection and the buffer control htmlFor hls playback in general. Now playback stats will be correctly used htmlFor hls playback to indicate PLAYING and to control the buffer. This issue was introduced with the major player version 4 and doesn't effect older major versions (3 or less). Also a duplicated module declaration is removed to ensure stable builds and a small scope issue is fixed.

Changelog​

Fixed​

  • iOS 10 playing state detection and buffer control htmlFor hls in general by correct registering play stats event in buffercontrol
  • removed duplicated module declaration in mediasourcemanger
  • correct scope issue in onUpdateSourceInit in h5live.js

[4.0.4]​

Release Notes​

This version contains an improvement htmlFor the detection of supported browser types and versions. It furthermore contains an improvement htmlFor playback in iPadOS desktop browsing mode, to correctly detect H5Live MSE or LL-HLS modes htmlFor playback.

Changelog​

Improved​

  • improved supported browser version detection
  • improved playback in desktop browsing mode on iPadOS
  • changes applied from 3.18.6/3.18.7

[4.0.2]​

Release Notes​

BREAKING CHANGE​

The new nanoStream H5Live Player version 4 brings an updated stream switch feature. We improved the old 'updateSource' functionality by the possibility to switch to another stream by server-side switch and a better client-side switch. Now the switch to another source is much more smoother and faster. The old behaviour with stopping the player by reason 'playbackrestart' and restart playback with the new source is removed except htmlFor iOS.

Please find more about the new feature in our documentation.

Changelog​

Improved​

  • new 'updateSource' methods 'server' and 'client' htmlFor smoother and faster behaviour
  • 'updateSource' options object as param
  • new public events 'onUpdateSourceInit', 'onUpdateSourceInit', 'onUpdateSourceFail' and 'onUpdateSourceAbort'
  • new error codes 4005 and 4006

Removed​

  • pause/play update behaviour except htmlFor iOS

[3.18.7]​

Release Notes​

This version contains an improvement htmlFor the detection of supported browser types and versions.

Changelog​

Improved​

  • improved detection of supported browser types and versions

[3.18.6]​

Release Notes​

This version contains an improvement htmlFor playback in iPadOS desktop browsing mode, to correctly detect H5Live MSE or LL-HLS modes htmlFor playback.

Changelog​

Improved​

  • improved playback in desktop browsing mode on iPadOS

[3.18.5]​

Release Notes​

This version patches the usage of the 'params' object of the config source object. Now it isn't necessary to pass 'url' & 'stream' if no 'source.h5live.rtmp' object is present.

Changelog​

Fixed​

  • remove check htmlFor rtmp queries 'url' & 'stream' in 'params' object of the source config

[3.18.4]​

Release Notes​

This version fixes a small bug with buffer config validation.

Changelog​

Fixed​

  • use 'hasOwnProperty' in buffer config validation

[3.18.3]​

Release Notes​

This version brings an improvement htmlFor the playback stability under higher cpu/gpu load influence like heavy load in browsers caused by complex WebGL animations.

Changelog​

Improved​

  • optimized playback stability in case of high general cpu/gpu load

[3.18.2]​

Release Notes​

This release is adding two configuration options to the config.style section. style.backgroundColor allows custom background colors via the config. style.fullScreenControl allows to show/hide the full-screen button in the inline player controls.

Changelog​

Added​

  • new config parameter 'style.backgroundColor' to enable custom background colors in the player div
  • new config parameter 'style.fullScreenControl' to show or hide the full-screen button in the inline player controls
config.style.backgroundColor = 'black'
config.style.fullScreenControl = true

Improved​

  • browser version detection htmlFor Safari macOS

[3.18.1]​

Release Notes​

This release brings the possibility to allow H5Live low latency HLS playback as fallback htmlFor Safari on Mac OS X. If enabled the player will decide htmlFor Safari Mac OS X the playback method and utilize H5Live low latency HLS if appropriate. Another feature is that we added the quality stats to the metrics stats event. Also several little patches are included in this release. Now htmlFor bintu sources without explicit 'h5live' playout object in the response the rtmp object will be choosen and a missing server object in the h5live config will be catched. An 'undefined' error at destroy is fixed too. Now also playback will always be recovered on Edge if frames are dropped and the player is visible.

Changelog​

Added​

  • new config parameter 'playback.allowSafariHlsFallback' to enable selecting the playback method in Safari Mac OS X and utilize H5Live low latency HLS if appropriate (default:false)
config.playback.allowSafariHlsFallback = true
  • send quality values in metrics stats event

Fixed​

  • use bintu rtmp playout object in case h5live rtmp object isn't defined
  • catch missing server object in config
  • fix 'undefined' error at destroy
  • always recover playback on Edge at frame dropping if player is visible

[3.17.4]​

Release Notes​

This release improves and stabilizes the metrics play event stats collection, the playback stats collection and the general metrics event error handling. There are some checks added to avoid playback interupts in case of metrics collection errors. Further the stats object in the flash fallback is updated with all possible properties. Before this resulted in an error at metrics collection.

Changelog​

Improved​

  • catch errors in metrics module
  • check play event stats and playback stats in metrics module htmlFor consistancy

Fixed​

  • update stats object htmlFor flash fallback with all possible properties

[3.17.3]​

Release Notes​

This release contains several patches. One patch fixes a potential problem with autoPlay policies regarding the play promise implementation of certain browsers. The main problem were side effects with the promise wrapper of the player and some third party libs which manipulate promises. In this cases the promise always resolved, also in case of an play start error. Another patch addresses a bug in Microsoft Edge 18. We removed the 'MediaSource.isTypeSupported' check htmlFor all Edge versions because of an inconsistancy in Edge 18. Further a bug in the 'updateSource' function htmlFor iOS is fixed. Also now the full screen icon on Chrome changes correctly.

Changelog​

Fixed​

  • change media play promise wrapping to avoid side effects of promise manipulating third party libs
  • remove 'MediaSource.isTypeSupported' check htmlFor all Microsoft Edge versions
  • fix 'type undefined' error in 'updateSource' htmlFor iOS
  • fix full screen icon change on Chrome

[3.17.2]​

Release Notes​

This release patches an issue with metrics fields type. Now the fields 'accountId', 'accountKey', 'userId', 'eventId', and 'customField1' - 'customField10' must be of type String. If one of the mentioned fields has a different type, it will be silently converted to String.

Changelog​

Fixed​

  • convert metrics fields to String, if necessary

[3.17.1]​

Release Notes​

With this release comes a new feature. We added new error codes and pause reasons. The errors that can occure during 'loading', 'buffering' and 'playing' state are now more specific regarding the root cause. We added the error code 1009 htmlFor playback fail in case of visibility hidden e.g. open a link as unfocused tab (ctrl + click). In this case the pause reason is 'visibilityhidden'. Further not only error 2001 'stream not found' can happen with the loading timeout. If the stream was already connected and the stream info event was fired but not enough data was received the new error code 2003 will be fired. The new pause reason in this case is 'notenoughdata'. Another new error code is 2004 that will be fired if the source stream has been stopped. This can happen during 'loading', 'buffering' and 'playing' state and results in a pause with reason 'sourcestreamstopped'. The last new error is 3100, a media error, that will be fired if the media source extension (exclude iOS) changes it's state to 'ended'. The pause reason is 'playbackerror'. For further informations see the definitions htmlFor 'errorcode' (NanoPlayer API) and 'pausereason' (NanoPlayer API). In addition we improved the h5live support detection and fixed with the behaviour on error code 3003 (MEDIA_DECODE_ERROR). Now the player don't try to replay automatically.

Changelog​

Added​

  • new error codes:
    • 1009: Playback failed because the player was in visibility state 'hidden' at load start.
    • 2003: Not enough media data received. The stream was already connected and the stream info event was fired.
    • 2004: The source stream has been stopped.
    • 3100: The media source extension changed the state to 'ended'. NOT AVAILABLE FOR HLS PLAYBACK.
  • new pause reasons:
    • 'visibilityhidden': Paused because the player was not visible at load start.
    • 'notenoughdata': Paused by loading timeout. The stream was alive and connected but not enough data was received to start playback.
    • 'sourcestreamstopped': Paused because the source stream has been stopped.

Improved​

  • h5live support detection

Fixed​

  • don't restart on error code 3003 MEDIA_DECODE_ERROR

[3.16.0]​

Release Notes​

This release introduces new features and several patches. Now it's possible to configure playback timeouts via the new 'config.playback.timeouts' object. You can set timeouts htmlFor 'loading' and 'buffering' in a range of 10-60 seconds (default: 20) and htmlFor 'connecting' in a range of 5-30 seconds (default: 5). If the timeouts are reached, an error will be thrown and the player stops. Another feature addresses the metrics. Now also the 'LOADING' event will be sent. Furthermore if the player restarts in case of 'updateSource' while in playing state the pause event will be triggered with the new pause reason 'playbackrestart' before the replay attempt. The new version includes patches htmlFor the full screen functionality in general and htmlFor Internet Explorer (IE) in special. General the full screen icon changes now if exited by ESC and htmlFor IE the size is now correctly measured. Another patch fixes the volume change by the controls in IE. Two patches address the bintu service. The first one fixes a bug if the view is disabled and the bintu stream is not live or the services rejects. Now no view will be created in case of an bintu error. The other one enables to use 'updateSource' with a bintu source. In general now within the 'updateSource' promise the error handling is improved too. Further there are patches htmlFor displaying muted autoPlay correctly and hiding the playbutton in the middle if switching streams using 'updateSource' while playing.

Changelog​

Added​

  • new object 'config.playback.timeouts' to configure the timeouts htmlFor 'loading', 'buffering' and 'connecting' in seconds
config.playback.timeouts = {
    loading: 20,
    buffering: 20,
    connecting: 5
}
  • the LOADING event will be sent through metrics
  • new pause reason 'playbackrestart' in case of a pause htmlFor update source in playing state
  • updateSource error handling

Fixed​

  • full screen icon change if exited via ESC
  • IE full screen sizing
  • IE volume change via view controls
  • hide view in case of bintu setup error if disabled via 'config.style.view=false'
  • enable using a bintu source with 'updateSource'
  • hide middle playbutton in case of a playback restart via 'updateSource'
  • display muted autoPlay icon till first 'unmute'

[3.15.6]​

Release Notes​

This version addresses an issue with the full screen functionality on iOS Safari. The player now can go full screen within nested iframes. NOTE: The iframe(s) must have the attribute 'allowFullScreen="allowfullscreen|true"]**' or just 'allowfullscreen'. Another issue adressed is the handling of stable playback after viewport lost on IE/Edge. Here the detection is improved to prevent misbehaviour in case of not related framedropping.

Changelog​

Fixed​

  • enable full screen on iOS within nested iframe(s)
  • detection of IE/Edge viewport issue htmlFor stable playback

[3.15.5]​

Release Notes​

This release patches an issue with the config handling. Now a copy of the config will be used htmlFor the setup instead of pointer.

Changelog​

Fixed​

  • use only a copy of passed config object htmlFor setup

[3.15.4]​

Release Notes​

This release patches an issue with bintu sources. Now after a successful bintu call the parsed rtmp config will be passed correctly. This issue was introduced in version 3.15.3.

Changelog​

Fixed​

  • pass rtmp settings correctly in modified config object if bintu source is used

[3.15.3]​

Release Notes​

With this release come new features and some patches. One feature is about firing 'onError' with new error codes in case of a setup error. See the docs htmlFor more information (https://demo.nanocosmos.de/nanoplayer/docs/nanoplayer/NanoPlayer.html#toc21__anchor). Also a warnings will be fired if config properties are not valid or from wrong type. The other introduces a new metrics api which enables internal event logging and data aggregation with a nanocosmos backend. Please contact our sales team (mailto:sales@nanocosmos.de) htmlFor more information and see './js/nanoplayer-metrics-config.js' in the 'Demo Package'. This release also includes patches htmlFor IE/Edge regarding play stats and stable playback after viewport lost. Now also 'Windows 10' will be detected correctly and on 'Destroy' pause will be fired only if playing.

Changelog​

Added​

  • fire 'onError' if an error occure during setup
    • new error codes:
      • 5001: An exception was thrown during setup.
      • 5002: A forced tech is not supported by your browser.
      • 5003: The players source configuration is malformed or missing.
      • 5004: This browser does not fully support HTML5 and H5Live. Supported are: Chrome ≥ 54 (Windows, MacOSX, Android), Firefox ≥ 48 (Windows, MacOSX, Android), Microsoft Edge (Windows), Microsoft Internet Explorer 11 (at least Windows 8), Safari (MacOSX & at least iOS 10).
      • 5005: Configuration error. Could not create player, the rtmp configuration is missing or incomplete. Add an rtmp url and streamname to the configuration.
      • 5006: Configuration error. Could not create player, with this configuration an security token is required. Add an token to the configuration.
      • 5007: Configuration error. Could not create player, the websocket server configuration is missing.
      • 5008: Configuration error. Could not create player, the hls server configuration is missing.
      • 5009: Configuration error. Could not create player, the websocket server configuration htmlFor metadata is missing.
      • 5010: Could not embed player.
      • 5101: Could not find bintu stream. The stream is not live.
      • 5102: No bintu stream id passed.
      • 5103: Bintu service rejected.
      • 5201: Metrics configuration error. No metrics config object passed.
      • 5202: Metrics configuration error. Metrics config is not from type 'object'.
      • 5203: Metrics configuration error. Metrics config is empty.
      • 5204: Metrics configuration error. A custom property has no valid index number, the range is 1 to 10 e.g.'customField1'.
      • 5205: Metrics configuration error. A custom property is not indexed correctly, the range is 1 to 10 e.g.'customField1'.
      • 5206: Metrics configuration error. A custom property has an index out of range, the range is 1 to 10 e.g.'customField1'.
      • 5207: Metrics configuration error. A property is not valid.
      • 5208: Metrics configuration error. No credentials passed.
    • this codes will also be passed as property 'code' in the reject error object
    • see https://demo.nanocosmos.de/nanoplayer/docs/nanoplayer/NanoPlayer.html#toc21__anchor
  • fire 'onWarning' if a config property is not valid or from wrong type
  • added a new metrics api 
config.metrics = {
    accountId: 'myId',
    accountKey: 'sdfhe457zsjhnrtzd8',
    userId: 'myUserId',
    eventId: 'myEventId',
    statsInterval: 10,
    customField1: 'custom',
    customField2: 42,
    customField3: true
}

Fixed​

  • stable resume playback on IE/edge if video was out of viewport
  • calculate play stats on every 'play' htmlFor IE/Edge
  • detect Windows 10
  • pause on 'Destroy' only if playing

[3.14.1]​

Release Notes​

This version comes with some new features. The first one addresses the public 'onPlay' event. Now some startup stats will be passed in the event object. These values represent the different states during startup from 'connecting', 'connected', 'firstFragmentReceived', 'firstFrameRendered', 'playable' and at least 'playing', the total startup time. The second feature is the new public event 'onDestroy'. This event is fired when the player is destroyed. In relation to that new feature we introduced the new pause reason 'destroy'. If the player is playing on destroy, the player will be paused with this new reason.

Changelog​

Added​

{
    "stats": {
        "connecting": 0,
        "connected": 267,
        "firstFragmentReceived": 1865,
        "firstFrameRendered": 2028,
        "playable": 2029,
        "playing": 2448
    }
}
  • new public event 'onDestroy'

[3.13.5]​

Release Notes​

This version improves the demo page. One part is to use 'updateSource' htmlFor bintu multistream functionality.

Changelog​

Improved​

  • clean up demo ui
  • use 'updateSource' htmlFor bintu multistream switch
  • update player only if streams changed

[3.13.3]​

Release Notes​

This version addresses an issue with mimetype changes on 'updateSource'. Now it can be switched between different mimetypes e.g. video/audio and video only.

Changelog​

Fixed​

  • enable format (mimetype) changes htmlFor 'updateSource', e.g. switch between v/a and video only

[3.13.2]​

Release Notes​

This version brings a new feature. Now it's possible to change the source without call setup again. The new feature is available over the new public function 'player.updateSource', which is a Promise.

Changelog​

Added​

  • add new public function 'updateSource'
    • htmlFor changing the source at lifetime of the player without destroy/re-setup
    • the video element will be kept
    • pass the subobject 'source' of the config object
    • the Promise return's the new complete config
    • see docs
player.updateSource(source).then(function (config) {
    console.log('update source ok with config: ' + JSON.stringify(config));
}, function (error) {
    console.log(error);
});

[3.12.5]​

Release Notes​

This version corrects two small issues. The playback wasn't stopped on iOS on tab change. Now on every 'focus lost' on mobile devices the playback will be paused with reason 'playbacksuspended'. The second fix addresses the 'playback started' detection on iOS.

Changelog​

Fixed​

  • pause with reason 'playbacksuspended' if focus lost during tab change on iOS
  • playback started detection on iOS

[3.12.4]​

Release Notes​

In this version an issue with the loading icon is handled. The loading icon didn't disappear on play of video only streams. The issue was introduced with the previous version and only affected video only streams.

Changelog​

Fixed​

  • hide loading icon on play htmlFor video only streams

[3.12.3]​

Release Notes​

One part of this release addresses the correct indication of an audio symbol in case of muted autoPlay or audio only. The second issue that is adressed handles the muted state on reset after an unsuccessful (denied) muted autoPlay (automuted) on iOS. The last improvement is related to the behaviour in case of multiple destroy calls.

Changelog​

Fixed​

  • display audio symbol correct in case of audio only and muted autoPlay
  • fire unmute on iOS on reset after not allowed muted autoPlay (automuted)
  • fix destroy functionality if called multiple times in uninitialized state

[3.12.2]​

Release Notes​

This version fixes the default value of the new config option 'playback.automute'. It is disabled by default.

Changelog​

Fixed​

  • set 'config.playback.automute' to 'false' by default

[3.12.1]​

Release Notes​

This version fixes an issue related to repeated setup calls without destroy calls in between. Now during the setup call a destroy/clean up will be performed internally if required.

Changelog​

Fixed​

  • destroy player at begining of setup call
  • clean destroy

[3.12.0]​

Release Notes​

This version brings a new feature htmlFor autoplay. There is a new option 'config.playback.automute' (disabled by default) which enables muted autoPlay on browsers with autoPlay policies. In case the play call is rejected by a policy the player will be muted to autoplay. Another feature is the option 'config.style.displayMutedAutoplay' (enabled by default) which shows a muted symbol if playback was started with autoPlay and muted. There is also a small fix htmlFor detecting playing state on iOS.

Changelog​

Added​

  • enable auto muted playback with autoPlay set in case of browser autoPlay policy restriction
    • can be set via 'config.playback.automute', default: false
  • enable displaying a muted symbol on muted autoPlay
    • can be set via 'config.style.displayMutedAutoplay', default: true

Fixed​

  • playing state detection on iOS

[3.11.0]​

Release Notes​

This version introduces a new event 'onStreamInfoUpdate' to indicate stream format changes. The event object is the same like in 'onStreamInfo' with the changed values

Changelog​

Added​

  • new h5live event 'onStreamInfoUpdate' to indicate stream format changes

[3.10.3]​

Release Notes​

This version fixes a small bug with building the capabilities array.

Changelog​

Fixed​

  • capabilities array

[3.10.2]​

Release Notes​

This version fixes a small bug with es6 syntax.

Changelog​

Fixed​

  • remove es6 syntax

[3.10.1]​

Release Notes​

This version improves the config handling and enables setting rtmp values over the params object.

Changelog​

Fixed​

  • enable rtmp settings over 'config.source.h5live.params' without the 'config.source.h5live.rtmp' object
  • config handling

[3.10.0]​

Release Notes​

This version brings a new config option. It's now possible to add custom query params to the connection string. For this there is the new object 'config.source.h5live.params'. Parameters can be added as key/value pair e.g.:

config.source.h5live.params = {
    'url': 'rtmp://bintu-play.nanocosmos.de',
    'stream': 'dtHSa-aEWRT',
    'custom_param': 'very_custom'
}

In this example we pass directly the rtmp settings, 'url' and 'stream'. If a 'config.source.h5live.rtmp' object is declared, it will be overwritten. This will result htmlFor websocket in a connection string like this:

wss://bintu-play.nanocosmos.de/h5live/stream/?url=rtmp%3A%2F%2Fbintu-play.nanocosmos.de%3A80%2Fplay&stream=dtHSa-aEWRT&custom_param=very_custom&cid=405498&pid=43377944190

This version also contains fixes htmlFor a wrong buffering state detection on iOS and one htmlFor the view. In the view now a configured 'scaling' mode will be keeped over the whole lifetime of the player.

Changelog​

Added​

  • new h5live source object 'params' to pass custom comnnection query parameters
    • can be added as key/value pairs
config.source.h5live.params = {
    'url': 'rtmp://bintu-play.nanocosmos.de',
    'stream': 'dtHSa-aEWRT',
    'custom_param': 'very_custom'
}

Fixed​

  • buffering state detection on iOS
  • keep scaling mode at players lifetime

[3.9.7]​

Release Notes​

This version fixes a bug htmlFor secured playback on iOS. In case of an error the pause reason now will be correct.

Changelog​

Fixed​

  • correct pause reason htmlFor secured streams on iOS

[3.9.6]​

Release Notes​

This version brings several improvements and some fixes. Improvements are a better error message in case of an unsupported browser and the re-enabeling of buffer increase automation in case of significant frame dropping in Firefox to reach stable playback. Fixed are occasionally stream start problems in Firefox with streams encoded by the Open Broadcaster Software Studio and a wrong object path of the quality object as part of the stats event object.

Changelog​

Improved​

  • optimize setup error message in case that no supported tech is found
  • re-enable buffer increase automation htmlFor Firefox in case of frame drop

Fixed​

  • occasionally start problems in Firefox with streams encoded by the OBS (Open Broadcaster Software Studio)
  • fix path of the quality object in the stats event object

[3.9.2]​

Release Notes​

This version fixes a bug htmlFor Microsoft IE and Edge. Now connection errors will be parsed correctly.

Changelog​

Fixed​

  • correct connection error codes htmlFor Microsoft IE and Edge

[3.9.1]​

Release Notes​

This version fixes a bug in Safari Mac OS X. Now black blinking on startup will be prevented.

Changelog​

Fixed​

  • prevent black blinking at playback start htmlFor Safari Mac OS X

[3.9.0]​

Release Notes​

This version brings a new security option. It's now possible to secure streams and play them back savely with the NanoPlayer. After a stream is marked as secured, it's only possible to playback by giving the credentials via 'config.h5live.security'. New errors will thrown if the token is invalid/mismatching (4901), the service is rejected (4900), the credentials are incomplete or expired (4903) and the service is not found (4904).

Changelog​

Added​

  • enable stream security htmlFor h5live playback
    • htmlFor playback of secured nanostream cloud streams
    • can be set via the 'config.h5live.security' object (see doc htmlFor further info)
    • new error codes:
      • 4900: The security service has been rejected due an internal server error.
      • 4901: The security service denied access. The authentication token is invalid.
      • 4903: The security service denied access. The url is expired or a token parameter is missing (expires, token, or options).
      • 4904: The security service can not be found.
security: {
    token: 'ewr6tzv345zw4z7ezuw4cf3c', // The security service token.
    expires: '1519819200', // The time the token expires (system time).
    options: '15', // The security options.
    tag: 'anyTag' // The custom tag to decrypt the token.
}

[3.8.2]​

Release Notes​

This version brings a new feature and several patches. We now enable adaptive buffer handling. This can be enabled by setting the new 'config.tweaks.buffewrDynamic'. In case of short time bufferings the buffer will be stabilized. If stable playback is reached after a defined cooldown time, it will be tried to decrease the buffer till the original values. Please see documentation htmlFor further informations. The patches bring improvements htmlFor Microsoft Edge / IE and iOS. Also network related fixes are included.

Changelog​

Added​

  • enable adaptive buffer handling (iOS already has one)
    • can be set via the 'config.tweaks.bufferDynamic' object (see doc htmlFor further info)
    • disabled if no object is passed
    • detect multiple bufferings and increase buffer if necessary
    • if stable playback is detected a stepwise cooldown will be processed
bufferDynamic: {
    offsetThreshold: 2, //  The threshold time between two bufferings in seconds. If the measured value is lower, the buffer will be increased by offsetStep.
    offsetStep: 0.5, // The step to increase in seconds. Also the step to decrease in cooldown.
    cooldownTime: 10 // The time to check stable playback. If stable playback is detected, the buffer values will be decreased till original buffer values are reached.
}

Fixed​

  • reconnectable network error handling
  • buffer issue with Microsoft Surface
  • handle unexpected time jumps htmlFor hls
  • proper resuming on Microsoft Edge and Internet Explorer
  • only handle gaps in case playback is frozen
  • random access point handling htmlFor Microsoft Edge
  • try restart on media decode error only
  • hls stats collecting and buffer controlling

[3.7.2]​

Release Notes​

This version patches a bug. It fixes a loading timeout on second play call.

Changelog​

Fixed​

  • fix loading timeout on second play call

[3.7.1]​

Release Notes​

This version patches a bug on iOS. It fixes the pausing in the case that the player losts it's focus.

Changelog​

Fixed​

  • pausing on lost focus htmlFor iOS

[3.7.0]​

Release Notes​

This version brings new features. A new member variable is added, 'player.id'. Its a unique string of 11 characters to identify the player instance. Additionally this player id will be passed through the event object of all public events as 'event.id'. Now the player version will be passed as 'event.version' too. In the stream info event additionally the stream url will be passed as 'event.data.streamInfo.url'.

Changelog​

Added​

  • new player member variable 'player.id', a unique string created on instantiation
  • pass 'id' and 'version' of the player through every event as 'evt.id' and 'evt.version'
  • add the complete stream url as 'url' to the stream info event object ('evt.data.streamInfo.url')

Fixed​

  • fire pause normal only once

[3.6.7]​

Release Notes​

This version contains a patch htmlFor the reconnection functionality. A reconnect will be done after a calculated delay.

Changelog​

Fixed​

  • fix start reconnect after given delay

[3.6.6]​

Release Notes​

This version contains patches htmlFor mobile playback, especially htmlFor iOS. A potentially performance impairing issue in the internal processing on iOS has been removed. If config.playback.forceTech is set to 'h5live', h5live playback will now be forced htmlFor all platforms including iOS. The nanocosmos logo has been removed from the flash fallback module. Automatic pausing on lost focus has been added htmlFor Android too.

Changelog​

Added​

  • handle 'playback suspended' also on Android (iOS since 2.7.1) in case of lost focus / menu by pausing the player

Changed​

  • buffer removing (shorter)
  • removed 'nano' logo from flash fallback swf file

Fixed​

  • prevent multiple event registering on iOS
  • play/pause functionality over middle play button on iOS
  • stats collection on iOS
  • add errorcode htmlFor RECONNECTION_CONFIG_INVALID
  • disable play recovering htmlFor mobile
  • fix forcing tech 'h5live' on iOS

[3.5.2]​

Release Notes​

This version contains a patch htmlFor the full screen functionality. Now full screen will only be exited, if the full screen element is the player instance. Before it exited every full screen on destroy without a check.

Changelog​

Fixed​

  • full screen handling

[3.5.1]​

Release Notes​

This release brings new features. There are new statistics available via the 'onStats' event. Now the bitrate in Bit/s will be measured and also the network framerate in fps. For both it will be measured the current value over one second and the minimum, maximum and average over the last 10 seconds. They are accessable over the 'event.data.stats.bitrate' and the 'event.data.stats.framerate' objects. This feature is not available on iOS and the values are always '0' in this case. Another feature is auto rotation htmlFor mobile streams from our nanoStream Mobile Apps. Its enabled if 'playback.metadata' is set to true.

Changelog​

Added​

  • new stats objects 'bitrate' and 'framerate' (network framerate) in 'onStats' event (NOT AVAILABLE FOR HLS PLAYBACK)
  • auto rotation htmlFor mobile streams from nanoStream Mobile Apps if 'playback.metadata=true'

Fixed​

  • remove unwanted currentTarget from 'event.data' object

[3.4.1]​

Release Notes​

This version contains patches htmlFor iOS full screen functionality if meta tag 'viewport' is set and the autoPlay policy of Safari 11, where only muted autoPlay is allowed.

Changelog​

Improved​

  • handle autoPlay policy of Safari 11 by checking user gesture requirement (muted autoPlay allowed)

Fixed​

  • iOS full screen functionality if meta tag 'viewport' is set

[3.4.0]​

Release Notes​

This version contains improved connectivity and latency htmlFor iOS 11 compared to iOS 10, and a workaround htmlFor an internal iOS11 system issue. It is highly recommended to use this version to avoid potentially higher network load and degraded user experience htmlFor iOS 11 users.

Changelog​

Improved​

  • connectivity and latency htmlFor iOS 11

[3.3.4]​

Release Notes​

This version includes a fix htmlFor the muted state of the player, if the player will be set up muted. The state wasn't changed and no event was fired. Now the 'onMuted' event fires immediately with the setuo promise.

Changelog​

Fixed​

  • change muted state and 'onMuted' event firing within the setup promise

[3.3.3]​

Release Notes​

This version includes a fix htmlFor the flash fallback. It fixes an undefined error on setuo if container div id is different than 'playerDiv'.

Changelog​

Fixed​

  • undefined error with flash fallback player on setuo if container div id is different then 'playerDiv'

[3.3.2]​

Release Notes​

This release brings many features. We introduce the new 'keepConnection' functionality (supported with h5live server 1.8.0.0 and higher). This enables to have always a connection to the h5live server (websocket only), also if the player is not playing. Another main feature is the new reconnect logic. It enables reconnects to the h5live server in case of recoverable network errors. If the player is playing, the playback resumes after a successful reconnect. Related to the reconnect we added the value 'connectDelay' to the event 'onLoading', that if positive and not zero indicates that a reconnect is imminent. Also now the network error 4503: service unavailable will be dispatched and passed through the 'onError' event. For diagnostics of the websocket connection we now use 'performance.mark()' to log different states of the connection with timestamps. In this release are also several fixes. There are fixes htmlFor the scaling functionality, the h5live source parsing with bintu rtmp playout object only and at least we removed flash test embed on player load.

Changelog​

Added​

  • enable always keep connected htmlFor websocket to the h5live server (h5live server 1.8.0.0 and higher)
    • can be set via 'config.playback.keepConnection'
    • default: false
  • enable reconnect in case of recoverable network errors (see docs), not supported on iOS with metadata disabled
    • can be set via the 'config.playback.reconnect' object
    • new player states 'RECONNECTION_IMMINENT' (13) and 'CONNECTION_ERROR' (14)
    • default:
reconnect: {
    minDelay: 2, //  The minimum time to reconnect in seconds. The lowest possible value is 1 sec.
    maxDelay: 10, // The maximum time to reconnect in seconds.
    delaySteps: 10, // This number of steps till the maximum delay should reached.
    maxRetries: 10 // The maximum count of reconnect tries. If set to zero no reconnect will be done.
}
  • add property 'connectDelay' to the 'event.data' object of 'onLoading'
    • the delay in milliseconds before start connecting to the server
    • positive if a reconnect is imminent, otherwise zero
  • dispatch network error 4503: service unavailable
  • add performance marks with timestamps (see our documentation htmlFor more information), the middle part of the name string is the elementId of the player container (not supported on Safari 11 OSX and iOS):
    • 'nano.[playerDivId]**.connecting'
    • 'nano.[playerDivId]**.connected'
    • 'nano.[playerDivId]**.disconnected'
    • 'nano.[playerDivId]**.resuming'
    • 'nano.[playerDivId]**.firstFragmentReceived'
    • 'nano.[playerDivId]**.firstFrameRendered'
  • new public event 'onWarning' with a warning message

Fixed​

  • remove flash test embed on player load
  • enable h5live source with bintu rtmp playout object only
  • fix missing scaling config property

[3.2.2]​

Changelog​

Improved​

  • start logic htmlFor IE/Edge

[3.2.1]​

Changelog​

Improved​

  • buffer removal check

[3.2.0]​

Release Notes​

In this release we added the opportunity to create an audio player without video functionality. This can be enabled by setting in the style object of the config the new property 'audioPlayer' to 'true', htmlFor example 'config.style.audioPlayer = true'. Controls can be enabled/disabled. The size can be customized via 'width' and 'height'. Default is 640px * 51px.

Changelog​

Added​

  • enable the creation of an audio player without video functionality via 'config.style.audioPlayer = true'
    • controls can be enabled/disabled
    • the size can be customized via 'width' and 'height'
    • default is 640px * 51px

[3.1.0]​

Release Notes​

With this release comes improvements htmlFor the playback on iOS devices. We introduce an adaptive buffer control depending on the buffer requirements of the iOS video element to achieve smooth playback while attempting to keep the latency as low possible. The adaptive buffer control is enabled by default htmlFor iOS clients. There is a direct correlation between the integrity of the rtmp source stream and the buffer requirements.

The second improvement is that it's now possible to configure the buffer settings also htmlFor iOS devices directly. If the buffer tweaks will be set via config, the adaptive buffer control will be disabled and the given value will be used as discret values.

Changelog​

Added​

  • adaptive buffer control related to the buffer requirements on iOS
  • enable setting buffer tweaks via config htmlFor iOS as discret values
  • buffering detection htmlFor iOS

[3.0.11]​

Release Notes​

The main improvements of this release are getting more stability in play detection and pausing behaviour.

Changelog​

Fixed​

  • user gesture required detection htmlFor mobile
  • hide media errors if pausing/paused
  • enable usage of event handler functions without defining an event object parameter
  • video tag destroy

[3.0.10]​

Changelog​

Fixed​

  • remove source correctly on pause to disable multiple stream connections (iOS)
  • check media source htmlFor mime type support
  • fix playback suspension with video only streams in Chrome > 57 on lost page focus

[3.0.9]​

Release Notes​

The main improvements of this release are getting more stability htmlFor resuming after pause.

Changelog​

Improved​

  • stable playback resuming after pause
  • resume playback also if PLAY is called while pausing
  • replace deprecated unescape/escape with decodeURIComponent/encodeURIComponent

[3.0.4]​

Changelog​

Improved​

  • stream start

[3.0.3]​

Changelog​

Fixed​

  • preventing the stream position from moving back in time on iOS devices
  • signalling of pause state reasons

[3.0.2]​

Release Notes​

BREAKING CHANGE​

The automatic fallback to the nanoStream Cloud h5live server has been removed. As a result providing the h5live.server configuration object is now mandatory, except if the server configuration is done through the bintu API by providing a bintu source. For playback from the nanoStream Cloud without the bintu API the following values have to be set.

source.h5live.server.websocket = 'wss://bintu-h5live.nanocosmos.de:443/h5live/stream';
source.h5live.server.hls = 'https://bintu-h5live.nanocosmos.de:443/h5live/http/playlist.m3u8';
source.h5live.server.progressive = 'https://bintu-h5live.nanocosmos.de:443/h5live/http/stream.mp4';

For the On-Premise setup this server values have to be replaced with the own server urls.

BREAKING CHANGE​

The seperate configuration of the rtmp url htmlFor the fallback to flash player, the source.rtmp object, has been removed. Instead the rtmp url and stream name from the source.h5live.rtmp object will be used in this case.

Since this version the last video frame can be kept displayed after pausing the player, instead of displaying a black frame. The related configuration option is 'style.keepFrame' = [true/false]**, which is enabled by default.

Support htmlFor playback of audio only streams has been added (at least server version 1.7 required). An audio symbol can be displayed during the playback of an audio only stream. The related configuration option is 'style.displayAudioOnly' = [true/false]**, which is enabled by default.

Changelog​

Added​

  • add audio only support
  • add new public event 'onStreamInfo' with an streamInfo object about audio/video in the stream
  • change player behaviour to always keep frame
  • new config flag 'style.keepFrame' (default = true)
  • new config flag 'style.displayAudioOnly' (default = true)
  • add new state PAUSING to protect pausing phase
  • new server event onRandomAccessPoint to enable stable seeking to keyframes in IE/Edge

Removed​

  • removed external code from source code incl. config etc.
  • removed rtmp source htmlFor flash, instead use the rtmp object from h5live source as fallback
  • removed nanocosmos server defaults

Fixed​

  • adjusted minimum buffer htmlFor ie/edge
  • more stable start behaviour
  • frame drop handling only htmlFor Firefox
  • destroy player on new setup call

[2.8.1]​

Release Notes​

The main changes of this release are adding quality metrics htmlFor firefox to detect frame dropping and handling by buffer increasing. Fixed is the user gesture error on playback start by tapping on the interaction playbutton on Android 5/6. Fixed is the playback start on start buffer.

  • Added quality handler htmlFor firefox with frame drop detection/handling.

  • Fixed user gesture error on Android 5/6.

  • Fixed is the playback start on start buffer.

Changelog​

Added​

  • quality handler with quality measuring and frame drop detection/handling (Firefox)

Fixed​

  • start playback on start buffer
  • removed deprecated single/double tap logic
  • added simple click event

[2.7.1]​

Release Notes​

The main changes of this release are improvements htmlFor playback on safari. The stream does not stops anymore in case of large gaps in buffer or unexpected pause calls. It is added a handling to keep low latency playback in case of multiple buffered ranges by a seek over buffer gaps (exclude iOS).

  • Added a handling to prevent playback stopping on unexpected pause calls.

  • Added a handling to seek over buffer gaps to keep low latency playback. This does not apply htmlFor iOS.

Changelog​

Added​

  • handle 'playback suspended' on iOS in case of lost focus / menu by pausing the player
  • added new pause reason, state & errorcode htmlFor 'playback suspended'
  • tweak buffer times

Fixed​

  • google map parsing in multiplayer demo

[2.4.1]​

Changelog​

Added​

  • google maps to nanoplayer-multi demo
  • player capabilities
  • enable video tag re-use

[2.3.8]​

Changelog​

Added​

  • remove doubleclick interaction
  • click on player let controls appear
  • click on playbutton starts playback
  • disable mobile autoPlay in demo
  • buffer value change htmlFor stable playback on IE/Edge, framerate dependent

[2.3.4]​

Changelog​

Added​

  • add multiplayer
  • online flashplayer path htmlFor snippet
  • buffer improvement htmlFor ios
  • webpack build
    • native script tag, require, commonjs
  • separate demo html's htmlFor native and require load
  • destroy function
  • native hls playback enabled htmlFor safari
  • remove online dependency htmlFor flashplayer (relative path)
  • remove online dependency htmlFor external code (must load separately else not supported)
  • controls
    • play/pause
    • time
    • mute/unmute
    • volume
    • full screen
  • config option to set flashplayer path (default is html root)
  • events htmlFor mute/unmute/volumechange
  • buffer control htmlFor ios
  • general IE/Edge support, more buffer
  • playback watcher to detect if playback started (user gesture required on mobile)
  • new pause reason/state/error

Fixed​

  • ignore force param in demo
  • check config htmlFor source object
  • docs
  • removing players in multiplayer
  • default server error
  • seek instead of increase speed in buffer control htmlFor IE/Edge

[2.0.3]​

Changelog​

Added​

  • scaling
    • play with different video scaling modes
    • letterbox, crop, fill, original, resize
  • responsive
    • view (playbutton/buffersign/errorsign) sizing should depend on player size (small/bigger player -> smaller/bigger signs)
  • interaction
    • try to scroll or move while mouse pressed should do nothing
    • play/pause per click/touch
    • full screen per doubleclick/doubletouch
  • (ie/edge), more buffer on lower framerates

Fixed​

  • interactive handler
  • reset connection
  • scaling resize
  • scaling iOS
  • interaction touch/left mouse only

[1.5.4]​

Changelog​

Added​

  • ios 10 metadata
  • enable/disable metadata
  • playbutton, buffersign
  • configuration errors

Fixed​

  • cross domain load
Last updated on