domlip94 / soundcloudfetcher
SoundCloud API的简单PHP包装器
dev-master
2019-07-14 10:56 UTC
Requires
- php: >=7.3.0
- ext-curl: *
- ext-json: *
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的参数数组。