@distube/soundcloud

中文文档
2.0.4发布于 2024/10/27MITTypeScriptESM + CJS构建来源已验证近 30 天下载 3558

用于支持 SoundCloud 的 DisTube 提取器插件 .

中文使用文档
文档目录8 节
  1. 特性
  2. 安装
  3. 使用量
  4. 插件
  5. 搜索
  6. 文档
  7. 新的声音Cloud Plugin( [声音CloudPlugin 选项])
  8. 声音 CloudPlugin# search( 清, [类型], [限制])

npm peer dependency version npm GitHub Repo stars Discord

Buy Me a Coffee at ko-fi.com

@distube/声音云

用于支持 SoundCloud 的 DisTube 提取器插件 .

特性

  • 使用声云 API
  • 支持 SoundCloud 音轨、相册和播放列表
  • 在 SoundCloud 上搜索音轨/播放列表
  • 从 SoundCloud 直接播放音轨

安装

npm install @distube/soundcloud@latest

使用量

插件

import { Client } from "discord.js";
import { DisTube } from "distube";
import { SoundCloudPlugin } from "@distube/soundcloud";

const client = new Client();

const distube = new DisTube(client, {
  plugins: [new SoundCloudPlugin()],
});
const scPlugin = new SoundCloudPlugin();
scPlugin.search("A SoundCloud Playlist", "playlist", 3);

文档

新的声音Cloud Plugin( [声音CloudPlugin 选项])

  • SoundCloudPluginOptions.clientId [弦] (可选):你的账户的客户身份.
  • SoundCloudPluginOptions.oauthToken [弦] (可选):你的账户是Oauth代币. 曾用 SoundCloud Go+ 账户获取更多数据.
  • 如何获得 clientId 财务报告和审定财务报表 oauthToken? 吗? 看这里

示例

new SoundCloudPlugin({
  clientId: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  oauthToken: "0-000000-000000000-xxxxxxxxxxxxxx",
});

声音 CloudPlugin# search( 清, [类型], [限制])

搜索 SoundCloud 上的指定查询 .

  • 参数

    • query [字符串]搜索查询.
    • type [弦]:结果类型(track 或者说 playlist) (中文(简体) ). 默认是 track。 。 。 .
    • limit [整数]:限制结果. 默认是 10。 。 。 .
  • 回返a Promise<Song[]|Playlist[]>

    • 回返a Promise<Song[]> 若为 type 参数是: track
    • 回返a Promise<Playlist[]> 若为 type 参数是: playlist

版本与发布记录

@distube/soundcloud 共发布 22 个版本,首次发布于 2021/05/25;过去 12 个月发布了 0 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.0.4latest2024/10/272 年前
2.0.32024/07/102 年前
2.0.22024/06/292 年前
2.0.12024/06/052 年前
2.0.02024/06/052 年前
1.3.52024/05/232 年前

关于 @distube/soundcloud 的常见问题

@distube/soundcloud 是什么?

用于支持 SoundCloud 的 DisTube 提取器插件 .

如何安装 @distube/soundcloud?

在项目目录运行 npm install @distube/soundcloud,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:distube(5)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@distube/soundcloud 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@distube/soundcloud 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@distube/soundcloud 可以商用吗?

@distube/soundcloud 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@distube/soundcloud 的下载量有多少?

根据 npm 官方下载统计,@distube/soundcloud 在 2026/10/13 – 2026/11/11 这 30 天内被下载 3,558 次,日均约 119 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@distube/soundcloud 还在维护吗?

最新版本 2.0.4 发布于 2024/10/27(2 年前);至今共发布 22 个版本,其中过去 12 个月发布了 0 个;首次发布于 2021/05/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。