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.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.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
- see feature description
support htmlFor secure playback using JSON Web Token (JWT)
- see feature description

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
- enables event logging and data aggregation
- configurable via the new 'config.metrics' object, see https://demo.nanocosmos.de/nanoplayer/docs/nanoplayer/NanoPlayer.html#toc20__anchor
- disabled by default
- htmlFor more information contact our sales team: mailto:sales@nanocosmos.de
- NOTE: don't set if you have no account!
- NOTE: if 'Demo Package' is used see './js/nanoplayer-metrics-config.js'!

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

add startup stats to the public 'onPlay' event
- subobject 'stats' in 'event.data'
- keys: 'connecting', 'connected', 'firstFragmentReceived', 'firstFrameRendered', 'playable', 'playing'
- times in milliseconds relative to 'connecting'
- see https://demo.nanocosmos.de/nanoplayer/docs/nanoplayer/NanoPlayer.html#~event:onPlay
- an example 'event.data.stats' object:

{
    "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

HIGHLY RECOMMENDED

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

Please find more about the MOQ playback mode feature in our documentation
For easy-to-use migration follow our guide
[5.0.2]
- Release Notes
- Changelog
- Fixed
[5.0.1]
- Release Notes
- Changelog
- Fixed
[5.0.0]
- Release Notes
- BREAKING CHANGE
- Changelog
- Added
- Changed
- Removed
[4.31.0]
- Release Notes
- Changelog
- Added
[4.30.1]
- Release Notes
- Changelog
- Fixed
[4.30.0]
- Release Notes
- Changelog
- Added
- Fixed
Please find more about the stream switching and abr feature in our documentation
[4.29.0]
- Release Notes
- Changelog
- Added
- Fixed
[4.28.0]
- Release Notes
- Changelog
- Added
- Improved
[4.27.0]
- Release Notes
- Changelog
- Improved
[4.26.1]
- Release Notes
- Changelog
- Fixed
[4.26.0]
- Release Notes
- Changelog
- Improved
- Fixed
[4.25.1]
- Release Notes
- Changelog
- Improved
[4.25.0]
- Release Notes
- Changelog
- Added
- Improved
- Fixed
[4.24.3]
- Release Notes
- Changelog
- Fixed
[4.24.2]
- Release Notes
- Changelog
- Fixed
- Improved
[4.24.1]
- Release Notes
- Changelog
- Fixed
[4.24.0]
- Release Notes
- Changelog
- Improved
- Fixed
Please find more about the latency control modes feature in our documentation
[4.23.1]
- Release Notes
- Changelog
- Added
- Improved
- Fixed
Please find more about the fast playback start feature in our documentation
[4.22.3]
- Release Notes
- Changelog
- Improved
[4.22.2]
- Release Notes
- Changelog
- Improved
- Fixed
[4.22.1]
- Release Notes
- Changelog
- Fixed
[4.22.0]
- Release Notes
- Changelog
- Added
- Improved
- Fixed
Removed
Please find more about the media error recovery feature in our documentation
[4.21.0]
- Release Notes
- Changelog
- Added
- Improved
- Fixed
[4.20.4]
- Release Notes
- Changelog
- Fixed
[4.20.3]
- Release Notes
- Changelog
- Fixed
[4.20.2]
- Release Notes
- Changelog
- Added
- Improved
- Fixed
[4.19.2]
- Release Notes
- Changelog
- Improved
- Fixed
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
- Changelog
- Added
- Improved
Please find more about the video processing feature in our documentation
[4.17.0]
- Release Notes
- Changelog
- Added
[4.16.0]
- Release Notes
- Changelog
- Added
- Fixed
[4.15.0]
- Release Notes
- Changelog
- Added
- Improved
Please find more about the latency control modes feature in our documentation
[4.14.2]
- Release Notes
- Changelog
- Fixed
[4.14.1]
- Release Notes
- Changelog
- Added
- Improved
Please find more about the source defaults feature in our documentation
[4.13.3]
- Release Notes
- Changelog
- Fixed
[4.13.2]
- Release Notes
- Changelog
- Improved
- Fixed
[4.13.1]
- Release Notes
- Changelog
- Fixed
[4.13.0]
- Release Notes
- Changelog
- Added
- Improved
- Changed
[4.12.1]
- Release Notes
- Changelog
- Fixed
[4.12.0]
- Release Notes
- Changelog
- Added
- Improved
- Fixed
[4.11.3]
- Release Notes
- Changelog
- Improved
- Fixed
[4.11.0]
- Release Notes
- Changelog
- Added
- Improved
- Fixed
Please find more about the media error recovery feature in our documentation
[4.10.6]
- Release Notes
- Changelog
- Fixed
[4.10.5]
- Release Notes
- Changelog
- Fixed
[4.10.4]
- Release Notes
- Changelog
- Added
- Improved
- Fixed
[4.9.2]
- Release Notes
- Changelog
- Improved
- Fixed
[4.9.1]
- Release Notes
- Changelog
- Added
- Improved
- Fixed
[4.8.1]
- Release Notes
- Changelog
- Improved
[4.8.0]
- Release Notes
- Changelog
- Improved
Please find more about the fullscreen API feature in our documentation**
[4.7.8]
- Release Notes
- Changelog
- Improved
[4.7.6]
- Release Notes
- Changelog
- Improved
[4.7.1]
- Release Notes
- Changelog
- Added
[4.6.1]
- Release Notes
- Changelog
- Added
- Improved
[4.5.6]
- Release Notes
- Changelog
- Improved
[4.5.2]
- Release Notes
- Changelog
- Improved
[4.5.1]
- Release Notes
- Changelog
- Added
- Improved
[4.3.2]
- Release Notes
- Changelog
- Added
- Improved
- Fixed
[4.2.5]
- Release Notes
- Changelog
- Fixed
[4.2.4]
- Release Notes
- Changelog
- Improved
[4.2.3]
- Release Notes
- Changelog
- Fixed
[4.2.2]
- Release Notes
- Changelog
- Improved
- Fixed
[4.2.1]
- Release Notes
- Changelog
- Improved
[4.2.0]
- Release Notes
- Changelog
- Added
- Improved
[4.1.4]
- Release Notes
- Changelog
- Fixed
[4.1.3]
- Release Notes
- Changelog
- Fixed
[4.1.2]
- Release Notes
- Changelog
- Fixed
[4.1.1]
- Release Notes
- Changelog
- Fixed
[4.1.0]
- Release Notes
- Changelog
- Improved
[4.0.8]
- Release Notes
- Changelog
- Improved
[4.0.7]
- Release Notes
- Changelog
- Fixed
[4.0.4]
- Release Notes
- Changelog
- Improved
[4.0.2]
- Release Notes
- BREAKING CHANGE
- Changelog
- Improved
- Removed
[3.18.7]
- Release Notes
- Changelog
- Improved
[3.18.6]
- Release Notes
- Changelog
- Improved
[3.18.5]
- Release Notes
- Changelog
- Fixed
[3.18.4]
- Release Notes
- Changelog
- Fixed
[3.18.3]
- Release Notes
- Changelog
- Improved
[3.18.2]
- Release Notes
- Changelog
- Added
- Improved
[3.18.1]
- Release Notes
- Changelog
- Added
- Fixed
[3.17.4]
- Release Notes
- Changelog
- Improved
- Fixed
[3.17.3]
- Release Notes
- Changelog
- Fixed
[3.17.2]
- Release Notes
- Changelog
- Fixed
[3.17.1]
- Release Notes
- Changelog
- Added
- Improved
- Fixed
[3.16.0]
- Release Notes
- Changelog
- Added
- Fixed
[3.15.6]
- Release Notes
- Changelog
- Fixed
[3.15.5]
- Release Notes
- Changelog
- Fixed
[3.15.4]
- Release Notes
- Changelog
- Fixed
[3.15.3]
- Release Notes
- Changelog
- Added
- Fixed
[3.14.1]
- Release Notes
- Changelog
- Added
[3.13.5]
- Release Notes
- Changelog
- Improved
[3.13.3]
- Release Notes
- Changelog
- Fixed
[3.13.2]
- Release Notes
- Changelog
- Added
[3.12.5]
- Release Notes
- Changelog
- Fixed
[3.12.4]
- Release Notes
- Changelog
- Fixed
[3.12.3]
- Release Notes
- Changelog
- Fixed
[3.12.2]
- Release Notes
- Changelog
- Fixed
[3.12.1]
- Release Notes
- Changelog
- Fixed
[3.12.0]
- Release Notes
- Changelog
- Added
- Fixed
[3.11.0]
- Release Notes
- Changelog
- Added
[3.10.3]
- Release Notes
- Changelog
- Fixed
[3.10.2]
- Release Notes
- Changelog
- Fixed
[3.10.1]
- Release Notes
- Changelog
- Fixed
[3.10.0]
- Release Notes
- Changelog
- Added
- Fixed
[3.9.7]
- Release Notes
- Changelog
- Fixed
[3.9.6]
- Release Notes
- Changelog
- Improved
- Fixed
[3.9.2]
- Release Notes
- Changelog
- Fixed
[3.9.1]
- Release Notes
- Changelog
- Fixed
[3.9.0]
- Release Notes
- Changelog
- Added
[3.8.2]
- Release Notes
- Changelog
- Added
- Fixed
[3.7.2]
- Release Notes
- Changelog
- Fixed
[3.7.1]
- Release Notes
- Changelog
- Fixed
[3.7.0]
- Release Notes
- Changelog
- Added
- Fixed
[3.6.7]
- Release Notes
- Changelog
- Fixed
[3.6.6]
- Release Notes
- Changelog
- Added
- Changed
- Fixed
[3.5.2]
- Release Notes
- Changelog
- Fixed
[3.5.1]
- Release Notes
- Changelog
- Added
- Fixed
[3.4.1]
- Release Notes
- Changelog
- Improved
- Fixed
[3.4.0]
- Release Notes
- HIGHLY RECOMMENDED
- Changelog
- Improved
[3.3.4]
- Release Notes
- Changelog
- Fixed
[3.3.3]
- Release Notes
- Changelog
- Fixed
[3.3.2]
- Release Notes
- Changelog
- Added
- Fixed
[3.2.2]
- Changelog
- Improved
[3.2.1]
- Changelog
- Improved
[3.2.0]
- Release Notes
- Changelog
- Added
[3.1.0]
- Release Notes
- Changelog
- Added
[3.0.11]
- Release Notes
- Changelog
- Fixed
[3.0.10]
- Changelog
- Fixed
[3.0.9]
- Release Notes
- Changelog
- Improved
[3.0.4]
- Changelog
- Improved
[3.0.3]
- Changelog
- Fixed
[3.0.2]
- Release Notes
- BREAKING CHANGE
- BREAKING CHANGE
- Changelog
- Added
- Removed
- Fixed
[2.8.1]
- Release Notes
- Changelog
- Added
- Fixed
[2.7.1]
- Release Notes
- Changelog
- Added
- Fixed
[2.4.1]
- Changelog
- Added
[2.3.8]
- Changelog
- Added
[2.3.4]
- Changelog
- Added
- Fixed
[2.0.3]
- Changelog
- Added
- Fixed
[1.5.4]
- Changelog
- Added
- Fixed

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

For easy-to-use migration follow our guide​

[5.0.2]​

Release Notes​

Changelog​

Fixed​

[5.0.1]​

Release Notes​

Changelog​

Fixed​

[5.0.0]​

Release Notes​

BREAKING CHANGE​

Changelog​

Added​

Changed​

Removed​

[4.31.0]​

Release Notes​

Changelog​

Added​

[4.30.1]​

Release Notes​

Changelog​

Fixed​

[4.30.0]​

Release Notes​

Changelog​

Added​

Fixed​

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

[4.29.0]​

Release Notes​

Changelog​

Added​

Fixed​

[4.28.0]​

Release Notes​

Changelog​

Added​

Improved​

[4.27.0]​

Release Notes​

Changelog​

Improved​

[4.26.1]​

Release Notes​

Changelog​

Fixed​

[4.26.0]​

Release Notes​

Changelog​

Improved​

Fixed​

[4.25.1]​

Release Notes​

Changelog​

Improved​

[4.25.0]​

Release Notes​

Changelog​

Added​

Improved​

Fixed​

[4.24.3]​

Release Notes​

Changelog​

Fixed​

[4.24.2]​

Release Notes​

Changelog​

Fixed​

Improved​

[4.24.1]​

Release Notes​

Changelog​

Fixed​

[4.24.0]​

Release Notes​

Changelog​

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

For easy-to-use migration follow our guide

[5.0.2]

Release Notes

Changelog

Fixed

[5.0.1]

Release Notes

Changelog

Fixed

[5.0.0]

Release Notes

BREAKING CHANGE

Changelog

Added

Changed

Removed

[4.31.0]

Release Notes

Changelog

Added

[4.30.1]

Release Notes

Changelog

Fixed

[4.30.0]

Release Notes

Changelog

Added

Fixed

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

[4.29.0]

Release Notes

Changelog

Added

Fixed

[4.28.0]

Release Notes

Changelog

Added

Improved

[4.27.0]

Release Notes

Changelog

Improved

[4.26.1]

Release Notes

Changelog

Fixed

[4.26.0]

Release Notes

Changelog

Improved

Fixed

[4.25.1]

Release Notes

Changelog

Improved

[4.25.0]

Release Notes

Changelog

Added

Improved

Fixed

[4.24.3]

Release Notes

Changelog

Fixed

[4.24.2]

Release Notes

Changelog

Fixed

Improved

[4.24.1]

Release Notes

Changelog

Fixed

[4.24.0]

Release Notes

Changelog