如何从Spotify获取当前播放轨道API端点的API请求
扫描二维码
随时随地手机看文章
音乐伴随着我们的日常生活,能够读出当前的播放信息,如标题、艺术家和专辑,直接打开了在显示器上显示这些数据的可能性,从而为桌子创造了创造性的装饰。有了ESP32和Spotify API,这些数据可以很容易地以各种方式检索和使用。在这篇博客文章中,您将学习到从Spotify获取当前播放轨道API端点的API请求的基础知识。
硬件:
主板采用ESP32芯片;例如:Dev Kit C V2或Dev Kit C V4 USB-C
软件:
如果您是第一次在Arduino IDE中编程ESP32,请复制Arduino IDE中的以下链接:File->Preferences->Additional boards manager
操作系统已经安装了该板的驱动程序(CP2102)。
Spotify API提供了各种API端点来检索信息或实现用户交互。要检索标题、艺术家、专辑和进度等数据,可以使用Get Current Playing Track API。
1.创建一个Spotify应用程序
为了能够使用Spotify API,您必须在Spotify开发者页面上登录您的Spotify帐户并打开仪表板(单击右上角的帐户)。在仪表板中,单击按钮Create App按钮,然后输入您选择的名称和描述。对于API类型,选择Web API。在成功配置Spotify应用程序后,您可以通过点击“查看客户端秘密”查看应用程序设置下的客户端ID和API密钥。
保存这两条信息。
2.授权
现在使用上一步中的ID在浏览器中打开链接。
一段时间后,一个窗口打开请求同意。同意后,浏览器现在提供一个响应,看起来像这样:
在这里保存代码(在搜索栏code=中)。此代码是一个授权令牌。现在您已经收到了授权码,必须通过API将其“交换”为请求令牌。您可以在文档中找到有关这方面的一般信息。
ESP32包中包含的HTTPclient库适合通过Arduino与API通信。作为json格式的服务器响应,解码为明文需要使用ArduinoJson库进行明文解码。
该库可以通过链接下载为.zip文件,并添加到Arduino IDE中Sketch>Include library >Add.ZIP library ....如果你使用的是PlatformIO,将以下内容复制到PlatformIO .ini文件中的lib_deps中:
3.请求刷新和访问令牌
初始调试时,授权令牌由最终程序中的API查询,程序代码如下:
在第一步中接收到的授权令牌在最后的程序中通过串行监视器传送到电路板上。首先,根据文档中的规范创建包含信息的HTTP标头和正文。然后通过POST将这些信息传输到Spotify服务器;如果接收到响应码200,则表示请求成功,可以暂时存储传输的数据并提取所需的信息。有关该过程的信息可以在以下文档页面上找到:Codeflow。
4.更新访问令牌
由于访问令牌仅在一小时的有限时间内有效,因此必须在过期后再次更新。与请求令牌的第一个请求一样,基本程序保持不变,只是现在使用第一步中的请求令牌而不是授权码。
5.请求数据
现在已经确保了当前访问令牌始终可用,您可以切换到查询相关信息。在文档页面的右侧是来自服务器的响应,其中包含您帐户的当前数据。这些数据可以使用以下程序从ESP32中检索:
首先,生成HTTP报头,然后使用POST命令将其发送到服务器。响应代码401表示访问令牌不再有效,必须更新。对于代码200,从JSON格式中提取接收到的数据并临时存储在相应的变量中。为了更好的可读性,时间被转换成秒,然后所有信息(标题、艺术家、专辑、持续时间、经过的时间和进度)都显示在串行监视器上。
6.最终方案
将最终程序加载到电路板上,并通过监视器输入授权令牌。串行监视器应该显示当前正在播放的歌曲的数据。
如果有任何问题,请将HTTP响应代码与文档中的各种代码进行比较。
程序说明:在setup()中检索保存的令牌。如果没有可用的令牌,则必须在串行监视器中输入它。因此,程序将等待,直到创建条目,然后将此代码保存在SPIFFS中。如果请求令牌已经存在,则使用它来请求访问令牌。使用上面生成的访问令牌在loop()中检索信息。接收到的数据然后在串行监视器中输出。如果HTTP请求返回代码401,这意味着访问令牌已经过期,必须更新;这是自动完成的。
该程序还包含三个辅助方法。base64Encode()方法将访问数据更改为API接口所需的base64格式。最后两个函数是存储和读取令牌,它们用于在flash中存储刷新令牌。存储的令牌即使在程序重新闪现之后也会保留,因此只需要在程序第一次启动时进行授权。
本文编译自hackster.io