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.
- optimize setup error message in case that no supported tech is found
- re-enable buffer increase automation for Firefox in case of frame drop
- 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
This version fixes a bug for Microsoft IE and Edge. Now connection errors will be parsed correctly.
- correct connection error codes for Microsoft IE and Edge
This version fixes a bug in Safari Mac OS X. Now black blinking on startup will be prevented.
- prevent black blinking at playback start for Safari Mac OS X
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).
- enable stream security for h5live playback
- for playback of secured nanostream cloud streams
- can be set via the 'config.h5live.security' object (see doc for 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.
}
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 for further informations. The patches bring improvements for Microsoft Edge / IE and iOS. Also network related fixes are included.
- enable adaptive buffer handling (iOS already has one)
- can be set via the 'config.tweaks.bufferDynamic' object (see doc for 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.
}
- reconnectable network error handling
- buffer issue with Microsoft Surface
- handle unexpected time jumps for hls
- proper resuming on Microsoft Edge and Internet Explorer
- only handle gaps in case playback is frozen
- random access point handling for Microsoft Edge
- try restart on media decode error only
- hls stats collecting and buffer controlling
This version patches a bug. It fixes a loading timeout on second play call.
- fix loading timeout on second play call
This version patches a bug on iOS. It fixes the pausing in the case that the player losts it's focus.
- pausing on lost focus for iOS
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'.
- 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')
- fire pause normal only once
This version contains a patch for the reconnection functionality. A reconnect will be done after a calculated delay.
- fix start reconnect after given delay
This version contains patches for mobile playback, especially for 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 for all platforms including iOS. The nanocosmos logo has been removed from the flash fallback module. Automatic pausing on lost focus has been added for Android too.
- handle 'playback suspended' also on Android (iOS since 2.7.1) in case of lost focus / menu by pausing the player
- buffer removing (shorter)
- removed 'nano' logo from flash fallback swf file
- prevent multiple event registering on iOS
- play/pause functionality over middle play button on iOS
- stats collection on iOS
- add errorcode for RECONNECTION_CONFIG_INVALID
- disable play recovering for mobile
- fix forcing tech 'h5live' on iOS
This version contains a patch for the fullscreen functionality. Now fullscreen will only be exited, if the fullscreen element is the player instance. Before it exited every fullscreen on destroy without a check.
- fullscreen handling
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 for mobile streams from our nanoStream Mobile Apps. Its enabled if 'playback.metadata' is set to true.
- new stats objects 'bitrate' and 'framerate' (network framerate) in 'onStats' event (NOT AVAILABLE FOR IOS)
- auto rotation for mobile streams from nanoStream Mobile Apps if 'playback.metadata=true'
- remove unwanted currentTarget from 'event.data' object
This version contains patches for iOS fullscreen functionality if meta tag 'viewport' is set and the autoplay policy of Safari 11, where only muted autoplay is allowed.
- handle autoplay policy of Safari 11 by checking user gesture requirement (muted autoplay allowed)
- iOS fullscreen functionality if meta tag 'viewport' is set
This version contains improved connectivity and latency for iOS 11 compared to iOS 10, and a workaround for an internal iOS11 system issue. It is highly recommended to use this version to avoid potentially higher network load and degraded user experience for iOS 11 users.
- connectivity and latency for iOS 11
This version includes a fix for 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.
- change muted state and 'onMuted' event firing within the setup promise
This version includes a fix for the flash fallback. It fixes an undefined error on setuo if container div id is different than 'playerDiv'.
- undefined error with flash fallback player on setuo if container div id is different then 'playerDiv'
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 for the scaling functionality, the h5live source parsing with bintu rtmp playout object only and at least we removed flash test embed on player load.
- enable always keep connected for 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 https://demo.nanocosmos.de/nanoplayer/docs/nanoplayer3/global.html#performancemarks),
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
- remove flash test embed on player load
- enable h5live source with bintu rtmp playout object only
- fix missing scaling config property
- start logic for IE/Edge
- buffer removal check
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', for example 'config.style.audioPlayer = true'. Controls can be enabled/disabled. The size can be customized via 'width' and 'height'. Default is 640px * 51px.
- 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
With this release comes improvements for 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 for 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 for 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.
- adaptive buffer control related to the buffer requirements on iOS
- enable setting buffer tweaks via config for iOS as discret values
- buffering detection for iOS
The main improvements of this release are getting more stability in play detection and pausing behaviour.
- user gesture required detection for mobile
- hide media errors if pausing/paused
- enable usage of event handler functions without defining an event object parameter
- video tag destroy
- remove source correctly on pause to disable multiple stream connections (iOS)
- check media source for mime type support
- fix playback suspension with video only streams in Chrome > 57 on lost page focus
The main improvements of this release are getting more stability for resuming after pause.
- stable playback resuming after pause
- resume playback also if PLAY is called while pausing
- replace deprecated unescape/escape with decodeURIComponent/encodeURIComponent
- stream start
- preventing the stream position from moving back in time on iOS devices
- signalling of pause state reasons
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://h5live.nanocosmos.de:443/h5live/stream';
source.h5live.server.hls = 'https://h5live.nanocosmos.de:443/h5live/http/playlist.m3u8';
source.h5live.server.progressive = 'https://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.
The seperate configuration of the rtmp url for 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 for 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.
- 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 external code from source code incl. config etc.
- removed rtmp source for flash, instead use the rtmp object from h5live source as fallback
- removed nanocosmos server defaults
- adjusted minimum buffer for ie/edge
- more stable start behaviour
- frame drop handling only for Firefox
- destroy player on new setup call
The main changes of this release are adding quality metrics for 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 for firefox with frame drop detection/handling.
-
Fixed user gesture error on Android 5/6.
-
Fixed is the playback start on start buffer.
- quality handler with quality measuring and frame drop detection/handling (Firefox)
- start playback on start buffer
- removed deprecated single/double tap logic
- added simple click event
The main changes of this release are improvements for 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 for iOS.
- handle 'playback suspended' on iOS in case of lost focus / menu by pausing the player
- added new pause reason, state & errorcode for 'playback suspended'
- tweak buffer times
- google map parsing in multiplayer demo
- google maps to nanoplayer-multi demo
- player capabilities
- enable video tag re-use
- remove doubleclick interaction
- click on player let controls appear
- click on playbutton starts playback
- disable mobile autoplay in demo
- buffer value change for stable playback on IE/Edge, framerate dependent
- add multiplayer
- online flashplayer path for snippet
- buffer improvement for ios
- webpack build
- native script tag, require, commonjs
- separate demo html's for native and require load
- destroy function
- native hls playback enabled for safari
- remove online dependency for flashplayer (relative path)
- remove online dependency for external code (must load separately else not supported)
- controls
- play/pause
- time
- mute/unmute
- volume
- fullscreen
- config option to set flashplayer path (default is html root)
- events for mute/unmute/volumechange
- buffer control for ios
- general IE/Edge support, more buffer
- playback watcher to detect if playback started (user gesture required on mobile)
- new pause reason/state/error
- ignore force param in demo
- check config for source object
- docs
- removing players in multiplayer
- default server error
- seek instead of increase speed in buffer control for IE/Edge
- 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
- fullscreen per doubleclick/doubletouch
- (ie/edge), more buffer on lower framerates
- interactive handler
- reset connection
- scaling resize
- scaling iOS
- interaction touch/left mouse only
- ios 10 metadata
- enable/disable metadata
- playbutton, buffersign
- configuration errors
- cross domain load