rogerxavier's picture
Upload 258 files
0aee47a verified
raw
history blame
5.42 kB
"""
bilibili_api.audio
音频相关
"""
from enum import Enum
from typing import Union, Optional
from .utils.utils import get_api
from .utils.credential import Credential
from .utils.network import Api
API = get_api("audio")
class Audio:
"""
音频
Attributes:
credential (Credential): 凭据类
"""
def __init__(self, auid: int, credential: Union[Credential, None] = None):
"""
Args:
auid (int) : 音频 AU 号
credential (Credential | None, optional): 凭据. Defaults to None
"""
self.credential = credential if credential is not None else Credential()
self.__auid = auid
def get_auid(self) -> int:
return self.__auid
async def get_info(self) -> dict:
"""
获取音频信息
Returns:
dict: 调用 API 返回的结果
"""
api = API["audio_info"]["info"]
params = {"sid": self.__auid}
return (
await Api(**api, credential=self.credential).update_params(**params).result
)
async def get_tags(self) -> dict:
"""
获取音频 tags
Returns:
dict: 调用 API 返回的结果
"""
api = API["audio_info"]["tag"]
params = {"sid": self.__auid}
return (
await Api(**api, credential=self.credential).update_params(**params).result
)
async def get_download_url(self) -> dict:
"""
获取音频下载链接
Returns:
dict: 调用 API 返回的结果
"""
api = API["audio_info"]["download_url"]
params = {"sid": self.__auid, "privilege": 2, "quality": 2}
return (
await Api(**api, credential=self.credential).update_params(**params).result
)
async def add_coins(self, num: int = 2) -> dict:
"""
投币
Args:
num (int, optional): 投币数量。Defaults to 2.
Returns:
dict: 调用 API 返回的结果
"""
self.credential.raise_for_no_sessdata()
api = API["audio_operate"]["coin"]
data = {"sid": self.__auid, "multiply": num}
return await Api(**api, credential=self.credential).update_data(**data).result
# TODO: 音频编辑
class AudioList:
"""
歌单
Attributes:
credential (Credential): 凭据类
"""
def __init__(self, amid: int, credential: Union[Credential, None] = None):
"""
Args:
amid (int) : 歌单 ID
credential (Credential | None, optional): 凭据. Defaults to None.
"""
self.__amid = amid
self.credential = credential if credential is not None else Credential()
def get_amid(self) -> int:
return self.__amid
async def get_info(self) -> dict:
"""
获取歌单信息
Returns:
dict: 调用 API 返回的结果
"""
api = API["list_info"]["info"]
params = {"sid": self.__amid}
return (
await Api(**api, credential=self.credential).update_params(**params).result
)
async def get_tags(self) -> dict:
"""
获取歌单 tags
Returns:
dict: 调用 API 返回的结果
"""
api = API["list_info"]["tag"]
params = {"sid": self.__amid}
return (
await Api(**api, credential=self.credential).update_params(**params).result
)
async def get_song_list(self, pn: int = 1) -> dict:
"""
获取歌单歌曲列表
Args:
pn (int, optional): 页码. Defaults to 1
Returns:
dict: 调用 API 返回的结果
"""
api = API["list_info"]["song_list"]
params = {"sid": self.__amid, "pn": pn, "ps": 100}
return (
await Api(**api, credential=self.credential).update_params(**params).result
)
# TODO: 歌单编辑
async def get_user_stat(uid: int, credential: Union[Credential, None] = None) -> dict:
"""
获取用户数据(收听数,粉丝数等)
Args:
uid (int) : 用户 UID
credential (Credential | None, optional): 凭据. Defaults to None
Returns:
dict: 调用 API 返回的结果
"""
credential = credential if credential is not None else Credential()
api = API["audio_info"]["user"]
params = {"uid": uid}
return await Api(**api, credential=credential).update_params(**params).result
async def get_hot_song_list(
pn: int = 1, credential: Union[Credential, None] = None
) -> dict:
"""
获取热门歌单
Args:
pn(int, optional) : 页数. Defaults to 1
credential (Credential | None, optional): 凭据. Defaults to None
Returns:
dict: 调用 API 返回的结果
"""
credential = credential if credential is not None else Credential()
api = API["list_info"]["hot"]
params = {"pn": pn, "ps": 100}
return await Api(**api, credential=credential).update_params(**params).result