pycloudmusic
优雅的异步高性能 Python 音乐 API 库
开箱即用/简单/快速 Python >= 3.9
项目文档 (移动至 Github Pages): https://fengliufeseliud.github.io/pycloudmusic
快速入门
安装
使用 pip 即可安装 pycloudmusic
pip install pycloudmusic输出对象
pycloudmusic 下的所有对象被打印时都会格式化输出类所有变量， 方便查看对象数据
from pycloudmusic import Music163Api
import asyncio
async def main():
musicapi = Music163Api()
# 获取歌曲 421531
# https://music.163.com/#/song?id=421531
music = await musicapi.music(421531)
# 打印歌曲信息
print(music)
print("=" * 50)
asyncio.run(main())此处数据为打印歌单对象
可迭代对象
pycloudmusic 下的部分对象可以被迭代使用
如下获取歌单 PlayList 对象后可以直接 for in PlayList 对象， 将迭代返回按歌单曲目生成的 Music 对象
from pycloudmusic import Music163Api
import asyncio
async def main():
musicapi = Music163Api()
# 获取歌单 7487291782
# https://music.163.com/#/playlist?id=7487291782
playlist = await musicapi.playlist(7487291782)
# 打印歌单信息
print(playlist)
print("=" * 50)
# 打印歌单曲目
for music in playlist:
print(music.name, music.artist_str, music.id)
asyncio.run(main())因此可以使用推导式快速生成 task 列表下载歌单曲目
from pycloudmusic import Music163Api
import asyncio
async def main():
musicapi = Music163Api()
# 获取歌单 7487291782
# https://music.163.com/#/playlist?id=7487291782
playlist = await musicapi.playlist(7487291782)
# 创建任务
tasks = [asyncio.create_task(music.play()) for music in playlist]
# 等待任务
await asyncio.wait(tasks)
asyncio.run(main())模拟登录
pycloudmusic 支持邮箱登录， 二维码登录， 手机密码登录， 手机验证码登录
这里可以用邮箱登录长期保持 Cookie 有效性，邮箱登录不需要人为操作
from pycloudmusic import LoginMusic163
import asyncio
async def main():
login = LoginMusic163()
# 邮箱登录
code, cookie, musicapi = await login.email("you login email", "you login password")
# 验证登录
print("=" * 60)
print(code, cookie, musicapi)
print("=" * 60)
print(await musicapi.my())
asyncio.run(main())评论
pycloudmusic 支持网易云的所有评论， 对支持评论的对象使用 Music163Comment 的方法即可
"""获取歌曲评论"""
from pycloudmusic import Music163Api, Page
import asyncio
async def main():
musicapi = Music163Api()
# 获取歌曲
# https://music.163.com/song?id=1902224491&userid=492346933
music = await musicapi.music(1902224491)
# 按时间获取评论
async for comments in Page(music.comments, hot=False):
for comment in comments:
print(f"{comment.user_str}: {comment.content}")
asyncio.run(main())错误处理
API 返回 200 以外状态码触发 Music163BadCode 错误
错误对象.code 获取 API 状态码，错误对象.data 获取 API 数据
from pycloudmusic import Music163Api, Music163BadCode
import asyncio
async def main():
musicapi = Music163Api()
try:
playlist = await musicapi.playlist(7487291782)
except Music163BadCode as err:
print(err, err.code, err.data)
asyncio.run(main())代理设置
pycloudmusic 支持 proxy 时出现错误触发回调来更新 proxy
from pycloudmusic import Music163Api, set_proxy, set_proxy_callback
import asyncio
# 正常这里是多个 proxy ip
proxy = [
"http://117.114.149.66:55443"
]
# 设置 proxy
set_proxy(proxy[0])
# proxy 更新回调
def proxy_callback(err):
# 如果 proxy 时出现错误这里更新
# 第一个返回值新的 proxy ip
# 第二个返回值 aiohttp.BasicAuth proxy 身份验证, 没有为 None
return proxy[0], None
# 设置 proxy 更新回调
set_proxy_callback(proxy_callback)
async def main():
musicapi = Music163Api()
# 获取歌曲 421531
# https://music.163.com/#/song?id=421531
music = await musicapi.music(421531)
await music.play()
# 打印歌曲信息
print(music)
print("=" * 50)
asyncio.run(main())
