SoundCloud for Developers

Discover, connect and build

Upgrading to JavaScript SDK 2.0.0

To upgrade to the SoundCloud JavaScript SDK version 2.0.0, replace all references to:

connect.soundcloud.com/sdk.js

with:

connect.soundcloud.com/sdk-2.0.0.js

We've done our utmost to make the upgrade to version 2.0.0 as seamless as possible. Everything should work as it did before, but please be sure to test before deploying your application.

The SC.stream function now returns a completely rewritten Player object that responds to the following functions:

  • play()
  • stop()
  • pause()
  • seek(ms)
  • setVolume(volume)
  • getVolume()
  • getType()
  • getCurrentPosition()
  • getLoadedPosition()
  • getDuration()
  • getState()

JavaScript SDK version 1 is now deprecated and will be permanently replaced by version 2 on July 1, 2014.

On June 17, 2014, we will temporarily replace version 1 with version 2 between 10:00 and 11:00 UTC. We will do this again on June 24, 2014, between 18:00 and 19:00 UTC. These two upgrade tests will give you an opportunity to understand the impact of this change on your applications. To ensure a seamless transition for your users, we strongly encourage you to upgrade and perform internal tests in advance of these dates.

To receive notices before, during, and after these tests, follow @SoundCloudDev on Twitter.

If you have any questions about this upgrade, please feel free to email api-support@soundcloud.com.