songlist
歌单相关 API
get_detail
async
get_detail(songlist_id: int, dirid: int = 0, num: int = 10, page: int = 1, onlysong: bool = False, tag: bool = True, userinfo: bool = True)
获取歌单详细信息和歌曲
参数 | 描述 |
---|---|
songlist_id
|
歌单 ID
类型:
|
dirid
|
歌单 dirid
类型:
|
num
|
返回数量
类型:
|
page
|
页码
类型:
|
onlysong
|
是否仅返回歌曲信息(优先级最大)
类型:
|
tag
|
是否返回歌单的标签信息
类型:
|
userinfo
|
是否返回歌单创建者的用户信息
类型:
|
源代码位于: qqmusic_api/songlist.py
get_songlist
async
获取歌单中所有歌曲列表
参数 | 描述 |
---|---|
songlist_id
|
歌单 ID
类型:
|
dirid
|
歌单 dirid
类型:
|
源代码位于: qqmusic_api/songlist.py
create
async
create(dirname: str, *, credential: Credential | None = None)
添加歌单, 重名会在名称后面添加时间戳
参数 | 描述 |
---|---|
dirname
|
歌单名称
类型:
|
credential
|
凭证
类型:
|
返回 | 描述 |
---|---|
创建的歌单基本信息 |
源代码位于: qqmusic_api/songlist.py
delete
async
delete(dirid: int, *, credential: Credential | None = None)
删除歌单
参数 | 描述 |
---|---|
dirid
|
歌单id
类型:
|
credential
|
凭证
类型:
|
返回 | 描述 |
---|---|
是否删除成功若不存在则返回False |
源代码位于: qqmusic_api/songlist.py
add_songs
async
添加歌曲到歌单
参数 | 描述 |
---|---|
dirid
|
歌单 dirid
类型:
|
song_ids
|
歌曲 ID 列表 |
credential
|
凭证
类型:
|
返回 | 描述 |
---|---|
是否添加成功, 歌曲已存在返回False |
源代码位于: qqmusic_api/songlist.py
del_songs
async
删除歌单歌曲
参数 | 描述 |
---|---|
dirid
|
歌单 dirid
类型:
|
song_ids
|
歌曲 ID 列表 |
credential
|
凭证
类型:
|
返回 | 描述 |
---|---|
是否删除成功, 歌曲不存在返回False |