domlip94/soundcloudfetcher

SoundCloud API的简单PHP包装器

dev-master 2019-07-14 10:56 UTC

This package is auto-updated.

Last update: 2024-09-14 22:17:00 UTC


README

开始使用

开始使用最快的办法是使用Composer(现在是2019年)。

在您的命令行中执行以下命令以这样做

composer require domlip94/soundcloudfetcher

要使用,首先我们实例化类

$soundCloud = new SoundCloud([
    'client_id'     => null,
    'client_secret' => null
]);

client_secret通常不需要,但client_id是必需的。

可用方法

目前可用的方法只有解析和获取曲目数据,我打算很快添加更多方法。

或者,您也可以自己调用未定义的API方法(见下文。)

解析Soundcloud URL

这会将SoundCloud URL解析为一个整数曲目ID,您可能需要用于其他API调用。

它调用如下

$soundCloud->resolveSoundCloudUrl(TRACK_URL);

TRACK_URL参数显然是曲目链接,如下所示。

$soundCloud->resolveSoundCloudUrl('https://soundcloud.com/adamstuartfunston/af-podcast-014');

$soundCloud->resolveSoundCloudUrl($trackUrl);

然后返回

(int) 649287689

获取曲目数据

这将返回数组形式的曲目数据。

您可以选择返回特定的数组键,或者返回所有内容。

它调用如下

$soundCloud->fetchTrackData(TRACK_URL, ARRAY_KEYS_TO_RETURN);
  • ARRAY_KEYS_TO_RETURN必须是一个数组或null。

例如,

获取所有曲目数据
$soundCloud->fetchTrackData('https://soundcloud.com/adamstuartfunston/af-podcast-014');
获取曲目长度
$soundCloud->fetchTrackData('https://soundcloud.com/adamstuartfunston/af-podcast-014', [
    'duration'
]);
获取曲目标题和长度
$soundCloud->fetchTrackData('https://soundcloud.com/adamstuartfunston/af-podcast-014', [
    'title', duration'
]);

其他方法

在构建此功能时,只有基本功能可用。然而,上述两种方法调用执行调用相同的方法。

该方法如下

$soundCloud->doApiCall(API_METHOD, METHOD_ARGUMENTS);
  • API_METHOD是远程API方法端点。
  • METHOD_ARGUMENTS是我们将提供给SoundCloud API的参数数组。