Change Log for Web Player SDK

2026-02-13

• New properties in the MediaPlayer module to optimize stream buffering for different network conditions: burstTime and hlsBufferLength. See Embed the TD Web Player SDK.

2024-08-15

• New Stream Status code: HLS_STREAM_GEOBLOCKED.

• This new code replaces the following codes: STREAM_GEO_BLOCKED, STREAM_GEO_BLOCKED_ALTERNATE, and STREAM_GEO_BLOCKED_NO_ALTERNATE.

• The above changes are part of an update to how geo-blocking is done; previously it was handled by the Stream Access component, but now it is handled in the back end by the Media Gateway (MG). Aside from the status codes, there should be no change in how your player responds to geo-blocking and alternate content.

2024-04-17

• Support added for changing podcast playback speed: player.changePlayBackRate(rate)

2023-06-08

• Updates to Using Google Analytics to reflect the upcoming Google deprecation of "Universal tracking ID."

• As of July 1, 2023 you must use GA4 tags instead of universal tracking ID!

2023-03-13

• New information in Using Timeshift Radio.

• Three new properties for the ad-break-cue-point event: adVast, vastUrl, and duration.

2023-02-01

• New section: Using Timeshift Radio.

• Old time-shift events removed from Web Player SDK Events, and new timeshift-info event added.

2022-06-17

• New object added to MediaPlayer module: streamWhileMuted.

2022-01-25

• Fix stream stopping on Android mobile browsers when the phone goes into sleep mode.

• Sort Now Playing Data, by timestamp if the cue_time_start property is not included.

2022-01-11

• message field added to the stream-status event. Use case: message added to event for LIVE_FAILED (when stream is not available). Message is: "PIPELINE_ERROR_DECODE: Failed to send audio packet for decoding: <details>

2021-09-30

• Two new status codes added to stream-status event. (STREAM_GEO_BLOCKED_ALTERNATE and STREAM_GEO_BLOCKED_NO_ALTERNATE.)

2021-09-07

• Added more information about Time shift.

2021-07-09

• Added the ability to override the default Google Analytics category, using the category property.

2021-05-13

• All references to Flash removed. (Flash support has ended.)

2021-04-22

• Added support for Google Analytics. See Using Google Analytics.

• Implemented TCFv2 (transparency and consent framework).

• Support for Microsoft Internet Explorer ended. The final version that supported IE is:
  https://sdk.listenlive.co/web/2.9.34/td-sdk.min.js

2020-09-03

• New section: Using Auto-play.

2020-07-21

• forceHls and forceHlsts added to MediaPlayer properties.

2020-07-06

• OnDemand player controls changed to work as they did previously; Pause and Mute do not stop the stream/file.

• VAST Wrapper support added.

• Bug fixes:

  • Fixed multiple streams playing when switching between OnDemand and live stream players.

  • Fixed companion ads being cleared too quickly.

2020-05-18

• SDK now checks for an existing <script> tag before embedding the HTML content returned by the ad.

• Bug fix: Chrome on Android did not stop the session when pause was clicked from the lock screen.

2020-03-06

• geoTargeting property added to MediaPlayer module.

2020-02-28

• Title changed from "Player SDK" to "Web Player SDK."

• Mute, Pause, and Stop functions are all the same; they stop the stream. Similarly, Unmute, Resume, and Play functions are all the same; they start the playback of the stream. No action is required to enable this change in your v. 29 web players, but Triton Digital suggests you make the following cosmetic changes for the best listener experience: (Update: this only applies to live streaming. For on-demand players, mute and pause reverted to the original behaviors on 2020-07-06.)

  • Icons and/or tool tips on your Play/Pause button should instead show Play/Stop icons/tool tips.

  • If your player has a Mute/Unmute button, remove it.

• PLAY_NOT_ALLOWED code and status message added to stream-status event in MediaPlayer.

• Bug fix: previously, geo-blocking would fail if the station being blocked did not have alternative content to offer during the block. This has been fixed.

2019-09-27

• audioAdaptive property added to the MediaPlayer module.

2019-05-13

• Added manual GDPR override settings to MediaPlayer > idSync object.

2019-05-02

• Updated the player SDK initialization recommendation for Europe and Asia in SDK Endpoints.

2019-04-29

• Added playerServicesRegion property to JavaScript Configuration Object Structure MediaPlayer module to target a specific region for provisioning.

2017-09-11

• The definition for the techPriority property (in Embedding the TD Player SDK) has been updated to reflect the priority of HTML5 over Flash.

2017-08-24

• Example removed from JavaScript SDK Reference, under "player.playAd( adServerType, config )." ("//Call with volume" example removed because ad volume is no longer a valid property.)

2017-04-05

• Correction to event: custom-cue-point in TD Player SDK Events; the feature is available in both Flash and HTML5.

2017-03-29

• Seek features removed. Best Practices section added, including an item for avoiding user gesture errors on mobile.

2016-12-23

• Information about HTTPS support added.

2016-11-24

• Media Format Reference section added.