如何使用Soundcloud JavaScript API加载无需client_id的私有曲目

云原生阿岚

2026-9-29

参数说明

你提到的路径中的s-tn8o48CxMd0确实是私有曲目共享密钥，只要链接携带该字段，就拥有对应私有曲目的访问权限，无需额外身份验证。
si参数是SoundCloud的分享来源追踪标记，仅用于平台统计分享链路数据，和曲目访问、加载逻辑完全无关，加载时可以直接删除该参数。

无client_id实现方案

优先推荐使用SoundCloud官方公开的嵌入式Widget API实现，该方案完全不需要自行申请client_id，仅依赖带共享密钥的私有链接即可完成加载，稳定性远高于使用第三方公开client_id的方案。

实现步骤

在页面中引入官方Widget API脚本：

<script src="https://w.soundcloud.com/player/api.js"></script>

编写私有曲目加载逻辑：

// 替换为你自己的私有曲目链接，可直接删除si参数
const PRIVATE_TRACK_URL = 'https://soundcloud.com/xx/yy/s-tn8o48CxMd0'
// 拼接嵌入播放器地址，参数和你原有配置保持对齐
const widgetUrl = `https://w.soundcloud.com/player/?url=${encodeURIComponent(PRIVATE_TRACK_URL)}&auto_play=false&show_artwork=true&single_active=false`
// 动态创建播放器iframe
const playerIframe = document.createElement('iframe')
playerIframe.setAttribute('width', '100%')
playerIframe.setAttribute('height', '166')
playerIframe.setAttribute('frameborder', '0')
playerIframe.setAttribute('allow', 'autoplay')
playerIframe.src = widgetUrl
// 插入到页面指定容器，示例为插入body，可替换为你自定义的DOM节点
document.body.appendChild(playerIframe)

// 初始化播放器控制器
const scPlayer = SC.Widget(playerIframe)
// 监听加载完成事件
scPlayer.bind(SC.Widget.Events.READY, () => {
  // 加载完成后可调用API控制播放、暂停、获取曲目信息等操作
  // 示例：播放曲目 scPlayer.play()
  console.log('私有曲目加载成功')
})