Spotify音乐控制服务

搜索Spotify

• 描述：在Spotify上搜索曲目、专辑、艺术家或播放列表
• 参数:
  • query （string）：搜索词
  • type （string）：要搜索的项目类型（曲目、专辑、艺术家、播放列表）
  • limit （number，可选）：返回的最大结果数（10-50）
• 退货：匹配项目及其ID、名称和其他详细信息的列表
• 示例: searchSpotify("bohemian rhapsody", "track", 20)

立即开始播放

• 描述：获取有关Spotify上当前播放曲目的信息
• 参数：无
• 退货：包含曲目名称、艺术家、专辑、播放进度、持续时间和播放状态的对象
• 示例: getNowPlaying()

获取我的播放列表

• 描述：获取当前用户在Spotify上的播放列表列表
• 参数:
  • limit （数字，可选）：要返回的播放列表的最大数量（默认值：20）
  • offset （数字，可选）：要返回的第一个播放列表的索引（默认值：0）
• 退货：一系列包含ID、名称、曲目计数和公开状态的播放列表
• 示例: getMyPlaylists(10, 0)

获取播放列表曲目

• 描述：获取特定Spotify播放列表中的曲目列表
• 参数:
  • playlistId （string）：播放列表的Spotify ID
  • limit （数字，可选）：要返回的最大曲目数（默认值：100）
  • offset （数字，可选）：要返回的第一个曲目的索引（默认值：0）
• 退货：包含ID、姓名、艺术家、专辑、持续时间和添加日期的曲目数组
• 示例: getPlaylistTracks("37i9dQZEVXcJZyENOWUFo7")

最近播放

• 描述：从Spotify检索最近播放的曲目列表。
• 参数:
  • limit （number，可选）：指定要返回的最大曲目数的数字。
• 退货：如果找到曲目，它会返回最近播放的曲目的格式化列表，否则会显示一条消息：“您在Spotify上没有最近播放的任何曲目”。
• 示例: getRecentlyPlayed({ limit: 10 })

最近播放

• 描述：从Spotify检索最近播放的曲目列表。
• 参数:
  • limit （number，可选）：指定要返回的最大曲目数的数字。
• 退货：如果找到曲目，它会返回最近播放的曲目的格式化列表，否则会显示一条消息：“您在Spotify上没有最近播放的任何曲目”。
• 示例: getRecentlyPlayed({ limit: 10 })

获得关注的艺术家

• 描述：检索用户在Spotify上关注的艺术家列表。
• 参数:
  • after （string，可选）：上一个请求中的最后一个艺术家ID。分页光标。
  • limit （数量，可选）：返回的艺术家的最大数量（1-50）。
• 退货：如果找到艺术家，它会返回一个已关注艺术家的格式化列表，否则会显示一条消息：“您在Spotify上没有关注任何艺术家”。
• 示例: getFollowedArtists({ limit: 10 })

getUserTopItems

• 描述：检索用户的顶级艺术家或曲目列表。
• 参数:
  • type （string）：要获得顶部的项目类型。必须是“艺术家”或“曲目”。
  • time_range （string）：顶部项目的时间范围。必须是“短期”、“中期”或“长期”。
  • limit （数字，可选）：要返回的最大项目数（1-50）。
  • offset （数字，可选）：要返回的第一个项目的索引。默认为0。
• 退货：如果找到项目，它会返回一个格式化的顶级项目列表，否则会显示一条消息：“您在Spotify上没有任何顶级项目”。
• 示例: getUserTopItems({ type: "artists", time_range: "short_term", limit: 10 })

play音乐

• 描述：开始在Spotify上播放曲目、专辑、艺术家或播放列表
• 参数:
  • uri （字符串，可选）：要播放的项目的Spotify URI（覆盖类型和id）
  • type （字符串，可选）：要播放的项目类型（曲目、专辑、艺术家、播放列表）
  • id （字符串，可选）：要播放的项目的Spotify ID
  • deviceId （字符串，可选）：要播放的设备的ID
• 退货：成功状态
• 示例: playMusic({ uri: "spotify:track:6rqhFgbbKwnb9MLmUQDhG6" })
• 替代: playMusic({ type: "track", id: "6rqhFgbbKwnb9MLmUQDhG6" })

pause播放

• 描述：暂停Spotify上当前播放的曲目
• 参数:
  • deviceId （字符串，可选）：要暂停的设备的ID
• 退货：成功状态
• 示例: pausePlayback()

跳转到下一步

• 描述：跳到当前播放队列中的下一首曲目
• 参数:
  • deviceId （字符串，可选）：设备的ID
• 退货：成功状态
• 示例: skipToNext()

跳转到上一个

• 描述：跳到当前播放队列中的上一首曲目
• 参数:
  • deviceId （字符串，可选）：设备的ID
• 退货：成功状态
• 示例: skipToPrevious()

创建播放列表

• 描述：在Spotify上创建新的播放列表
• 参数:
  • name （string）：新播放列表的名称
  • description （字符串，可选）：播放列表的描述
  • public （布尔值，可选）：播放列表是否应公开（默认值：false）
• 退货：具有新播放列表ID和URL的对象
• 示例: createPlaylist({ name: "Workout Mix", description: "Songs to get pumped up", public: false })

addTracksToPlaylist

• 描述：将曲目添加到现有的Spotify播放列表
• 参数:
  • playlistId （string）：播放列表的ID
  • trackUris （array）：要添加的跟踪URI或ID的数组
  • position （数字，可选）：插入轨迹的位置
• 退货：成功状态和快照ID
• 示例: addTracksToPlaylist({ playlistId: "3cEYpjA9oz9GiPac4AsH4n", trackUris: ["spotify:track:4iV5W9uYEdYUVa79Axb7Rh"] })

addToQueue

• 描述：将曲目、专辑、艺术家或播放列表添加到当前播放队列
• • 参数:
  • uri （字符串，可选）：要添加到队列中的项目的Spotify URI（覆盖类型和id）
  • type （字符串，可选）：要排队的项目类型（曲目、专辑、艺术家、播放列表）
  • id （字符串，可选）：要排队的项目的Spotify ID
  • deviceId （string，可选）：要排队的设备的ID
• 退货：成功状态
• 示例: addToQueue({ uri: "spotify:track:6rqhFgbbKwnb9MLmUQDhG6" })
• 替代: addToQueue({ type: "track", id: "6rqhFgbbKwnb9MLmUQDhG6" })