rogerxavier's picture
Upload 258 files
0aee47a verified
raw history blame
No virus
45.5 kB
"""
bilibili_api.bangumi
番剧相关
概念:
+ media_id: 番剧本身的 ID,有时候也是每季度的 ID,如 https://www.bilibili.com/bangumi/media/md28231846/
+ season_id: 每季度的 ID
+ episode_id: 每集的 ID,如 https://www.bilibili.com/bangumi/play/ep374717
"""
import datetime
from enum import Enum
from typing import Any, List, Tuple, Union, Optional
from bilibili_api.utils.danmaku import Danmaku
from . import settings
from .video import Video
from .utils.utils import get_api
from .utils.credential import Credential
from .exceptions.ApiException import ApiException
from .utils.network import Api, get_session, HEADERS
from .utils.initial_state import (
get_initial_state,
get_initial_state_sync,
InitialDataType,
)
API = get_api("bangumi")
episode_data_cache = {}
class BangumiCommentOrder(Enum):
"""
短评 / 长评 排序方式
+ DEFAULT: 默认
+ CTIME: 发布时间倒序
"""
DEFAULT = 0
CTIME = 1
class BangumiType(Enum):
"""
番剧类型
+ BANGUMI: 番剧
+ FT: 影视
+ GUOCHUANG: 国创
"""
BANGUMI = 1
FT = 3
GUOCHUANG = 4
async def get_timeline(type_: BangumiType, before: int = 7, after: int = 0) -> dict:
"""
获取番剧时间线
Args:
type_(BangumiType): 番剧类型
before(int) : 几天前开始(0~7), defaults to 7
after(int) : 几天后结束(0~7), defaults to 0
"""
api = API["info"]["timeline"]
params = {"types": type_.value, "before": before, "after": after}
return await Api(**api).update_params(**params).result
class IndexFilter:
"""
番剧索引相关固定参数以及值
"""
class Type(Enum):
"""
索引类型
+ ANIME: 番剧
+ MOVIE: 电影
+ DOCUMENTARY: 纪录片
+ GUOCHUANG: 国创
+ TV: 电视剧
+ VARIETY: 综艺
"""
ANIME = 1
MOVIE = 2
DOCUMENTARY = 3
GUOCHUANG = 4
TV = 5
VARIETY = 7
class Version(Enum):
"""
番剧版本
+ ALL: 全部
+ MAIN: 正片
+ FILM: 电影
+ OTHER: 其他
"""
ALL = -1
MAIN = 1
FILM = 2
OTHER = 3
class Spoken_Language(Enum):
"""
配音
+ ALL: 全部
+ ORIGINAL: 原声
+ CHINESE: 中配
"""
ALL = -1
ORIGINAL = 1
CHINESE = 2
class Finish_Status(Enum):
"""
完结状态
+ ALL: 全部
+ FINISHED: 完结
+ UNFINISHED: 连载
"""
ALL = -1
FINISHED = 1
UNFINISHED = 0
class Copyright(Enum):
"""
版权方
+ ALL: 全部
+ EXCLUSIVE: 独家
+ OTHER: 其他
"""
ALL = -1
EXCLUSIVE = 3
OTHER = "1,2,4"
class Season(Enum):
"""
季度
+ ALL: 全部
+ SPRING: 春季
+ SUMMER: 夏季
+ AUTUMN: 秋季
+ WINTER: 冬季
"""
ALL = -1
WINTER = 1
SPRING = 4
SUMMER = 7
AUTUMN = 10
@staticmethod
def make_time_filter(
start: Optional[Union[datetime.datetime, str, int]] = None,
end: Optional[Union[datetime.datetime, str, int]] = None,
include_start: bool = True,
include_end: bool = False,
) -> str:
"""
生成番剧索引所需的时间条件
番剧、国创直接传入年份,为 int 或者 str 类型,如 `make_time_filter(start=2019, end=2020)`
影视、纪录片、电视剧传入 datetime.datetime,如 `make_time_filter(start=datetime.datetime(2019, 1, 1), end=datetime.datetime(2020, 1, 1))`
start 或 end 为 None 时则表示不设置开始或结尾
Args:
start (datetime, str, int): 开始时间. 如果是 None 则不设置开头.
end (datetime, str, int): 结束时间. 如果是 None 则不设置结尾.
include_start (bool): 是否包含开始时间. 默认为 True.
include_end (bool): 是否包含结束时间. 默认为 False.
Returns:
str: 年代条件
"""
start_str = ""
end_str = ""
if start != None:
if isinstance(start, datetime.datetime):
start_str = start.strftime("%Y-%m-%d %H:%M:%S")
else:
start_str = start
if end != None:
if isinstance(end, datetime.datetime):
end_str = end.strftime("%Y-%m-%d %H:%M:%S")
else:
end_str = end
# 是否包含边界
if include_start:
start_str = f"[{start_str}"
else:
start_str = f"({start_str}"
if include_end:
end_str = f"{end_str}]"
else:
end_str = f"{end_str})"
return f"{start_str},{end_str}"
class Producer(Enum):
"""
制作方
+ ALL: 全部
+ CCTV: CCTV
+ BBC: BBC
+ DISCOVERY: 探索频道
+ NATIONAL_GEOGRAPHIC: 国家地理
+ NHK: NHK
+ HISTORY: 历史频道
+ SATELLITE: 卫视
+ SELF: 自制
+ ITV: ITV
+ SKY: SKY
+ ZDF: ZDF
+ PARTNER: 合作机构
+ SONY: 索尼
+ GLOBAL_NEWS: 环球
+ PARAMOUNT: 派拉蒙
+ WARNER: 华纳
+ DISNEY: 迪士尼
+ DOMESTIC_OTHER: 国内其他
+ FOREIGN_OTHER: 国外其他
"""
ALL = -1
CCTV = 4
BBC = 1
DISCOVERY = 7
NATIONAL_GEOGRAPHIC = 14
NHK = 2
HISTORY = 6
SATELLITE = 8
SELF = 9
ITV = 5
SKY = 3
ZDF = 10
PARTNER = 11
DOMESTIC_OTHER = 12
FOREIGN_OTHER = 13
SONY = 15
GLOBAL_NEWS = 16
PARAMOUNT = 17
WARNER = 18
DISNEY = 19
class Payment(Enum):
"""
观看条件
+ ALL: 全部
+ FREE: 免费
+ PAID: 付费
+ VIP: 大会员
"""
ALL = -1
FREE = 1
PAID = "2,6"
VIP = "4,6"
class Area(Enum):
"""
地区
+ ALL: 全部
+ CHINA: 中国
+ CHINA_MAINLAND: 中国大陆
+ CHINA_HONGKONG_AND_TAIWAN: 中国港台
+ JAPAN: 日本
+ USA: 美国
+ UK: 英国
+ SOUTH_KOREA: 韩国
+ FRANCE: 法国
+ THAILAND: 泰国
+ GERMANY: 德国
+ ITALY: 意大利
+ SPAIN: 西班牙
+ ANIME_OTHER: 番剧其他
+ MOVIE_OTHER: 影视其他
+ DOCUMENTARY_OTHER: 纪录片其他
注意:各索引的 其他 表示的地区都不同
"""
ALL = "-1"
CHINA = "1,6,7"
CHINA_MAINLAND = "1"
CHINA_HONGKONG_AND_TAIWAN = "6,7"
JAPAN = "2"
USA = "3"
UK = "4"
SOUTH_KOREA = "8"
FRANCE = "9"
THAILAND = "10"
GERMANY = "15"
ITALY = "35"
SPAIN = "13"
ANIME_OTHER = "1,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70"
TV_OTHER = "5,8,9,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70"
MOVIE_OTHER = "5,11,12,14,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70"
class Style:
"""
风格,根据索引不同,可选的风格也不同
"""
class Anime(Enum):
"""
番剧风格
+ ALL: 全部
+ ORIGINAL: 原创
+ COMIC: 漫画改
+ NOVEL: 小说改
+ GAME: 游戏改
+ TOKUSATSU: 特摄
+ BUDAIXI: 布袋戏
+ WARM: 热血
+ TIMEBACK: 穿越
+ IMAGING: 奇幻
+ WAR: 战斗
+ FUNNY: 搞笑
+ DAILY: 日常
+ SCIENCE_FICTION: 科幻
+ MOE: 萌系
+ HEAL: 治愈
+ SCHOOL: 校园
+ CHILDREN: 儿童
+ NOODLES: 泡面
+ LOVE: 恋爱
+ GIRLISH: 少女
+ MAGIC: 魔法
+ ADVENTURE: 冒险
+ HISTORY: 历史
+ ALTERNATE: 架空
+ MACHINE_BATTLE: 机战
+ GODS_DEM: 神魔
+ VOICE: 声控
+ SPORT: 运动
+ INSPIRATION: 励志
+ MUSIC: 音乐
+ ILLATION: 推理
+ SOCIEITES: 社团
+ OUTWIT: 智斗
+ TEAR: 催泪
+ FOOD: 美食
+ IDOL: 偶像
+ OTOME: 乙女
+ WORK: 职场
"""
ALL = -1
ORIGINAL = 10010
COMIC = 10011
NOVEL = 10012
GAME = 10013
TOKUSATSU = 10102
BUDAIXI = 10015
WARM = 10016
TIMEBACK = 10017
IMAGING = 10018
WAR = 10020
FUNNY = 10021
DAILY = 10022
SCIENCE_FICTION = 10023
MOE = 10024
HEAL = 10025
SCHOOL = 10026
CHILDREN = 10027
NOODLES = 10028
LOVE = 10029
GIRLISH = 10030
MAGIC = 10031
ADVENTURE = 10032
HISTORY = 10033
ALTERNATE = 10034
MACHINE_BATTLE = 10035
GODS_DEMONS = 10036
VOICE = 10037
SPORTS = 10038
INSPIRATIONAL = 10039
MUSIC = 10040
ILLATION = 10041
SOCIETIES = 10042
OUTWIT = 10043
TEAR = 10044
FOODS = 10045
IDOL = 10046
OTOME = 10047
WORK = 10048
class Movie(Enum):
"""
电影风格
+ ALL: 全部
+ SKETCH: 短片
+ PLOT: 剧情
+ COMEDY: 喜剧
+ ROMANTIC: 爱情
+ ACTION: 动作
+ SCAIRIER: 恐怖
+ SCIENCE_FICTION: 科幻
+ CRIME: 犯罪
+ TIRILLER: 惊悚
+ SUSPENSE: 悬疑
+ IMAGING: 奇幻
+ WAR: 战争
+ ANIME: 动画
+ BIOAGRAPHY: 传记
+ FAMILY: 家庭
+ SING_DANCE: 歌舞
+ HISTORY: 历史
+ DISCOVER: 探险
+ DOCUMENTARY: 纪录片
+ DISATER: 灾难
+ COMIC: 漫画改
+ NOVEL: 小说改
"""
ALL = -1
SKETCH = 10104
PLOT = 10050
COMEDY = 10051
ROMANTIC = 10052
ACTION = 10053
SCAIRIER = 10054
SCIENCE_FICTION = 10023
CRIME = 10055
TIRILLER = 10056
SUSPENSE = 10057
IMAGING = 10018
WAR = 10058
ANIME = 10059
BIOAGRAPHY = 10060
FAMILY = 10061
SING_DANCE = 10062
HISTORY = 10033
DISCOVER = 10032
DOCUMENTARY = 10063
DISATER = 10064
COMIC = 10011
NOVEL = 10012
class GuoChuang(Enum):
"""
国创风格
+ ALL: 全部
+ ORIGINAL: 原创
+ COMIC: 漫画改
+ NOVEL: 小说改
+ GAME: 游戏改
+ DYNAMIC: 动态漫
+ BUDAIXI: 布袋戏
+ WARM: 热血
+ IMAGING: 奇幻
+ FANTASY: 玄幻
+ WAR: 战斗
+ FUNNY: 搞笑
+ WUXIA: 武侠
+ DAILY: 日常
+ SCIENCE_FICTION: 科幻
+ MOE: 萌系
+ HEAL: 治愈
+ SUSPENSE: 悬疑
+ SCHOOL: 校园
+ CHILDREN: 少儿
+ NOODLES: 泡面
+ LOVE: 恋爱
+ GIRLISH: 少女
+ MAGIC: 魔法
+ HISTORY: 历史
+ MACHINE_BATTLE: 机战
+ GODS_DEMONS: 神魔
+ VOICE: 声控
+ SPORT: 运动
+ INSPIRATION: 励志
+ MUSIC: 音乐
+ ILLATION: 推理
+ SOCIEITES: 社团
+ OUTWIT: 智斗
+ TEAR: 催泪
+ FOOD: 美食
+ IDOL: 偶像
+ OTOME: 乙女
+ WORK: 职场
+ ANCIENT: 古风
"""
ALL = -1
ORIGINAL = 10010
COMIC = 10011
NOVEL = 10012
GAME = 10013
DYNAMIC = 10014
BUDAIXI = 10015
WARM = 10016
IMAGING = 10018
FANTASY = 10019
WAR = 10020
FUNNY = 10021
WUXIA = 10078
DAILY = 10022
SCIENCE_FICTION = 10023
MOE = 10024
HEAL = 10025
SUSPENSE = 10057
SCHOOL = 10026
CHILDREN = 10027
NOODLES = 10028
LOVE = 10029
GIRLISH = 10030
MAGIC = 10031
HISTORY = 10033
MACHINE_BATTLE = 10035
GODS_DEMONS = 10036
VOICE = 10037
SPORTS = 10038
INSPIRATIONAL = 10039
MUSIC = 10040
ILLATION = 10041
SOCIETIES = 10042
OUTWIT = 10043
TEAR = 10044
FOODS = 10045
IDOL = 10046
OTOME = 10047
WORK = 10048
ANCIENT = 10049
class TV(Enum):
"""
电视剧风格
+ ALL: 全部
+ FUNNY: 搞笑
+ IMAGING: 奇幻
+ WAR: 战争
+ WUXIA: 武侠
+ YOUTH: 青春
+ SKETCH: 短剧
+ CITY: 都市
+ ANCIENT: 古装
+ SPY: 谍战
+ CLASSIC: 经典
+ EMOTION: 情感
+ SUSPENSE: 悬疑
+ INSPIRATION: 励志
+ MYTH: 神话
+ TIMEBACK: 穿越
+ YEAR: 年代
+ COUNTRYSIDE: 乡村
+ INVESTIGATION: 刑侦
+ PLOT: 剧情
+ FAMILY: 家庭
+ HISTORY: 历史
+ ARMY: 军旅
"""
ALL = -1
FUNNY = 10021
IMAGING = 10018
WAR = 10058
WUXIA = 10078
YOUTH = 10079
SKETCH = 10103
CITY = 10080
COSTUME = 10081
SPY = 10082
CLASSIC = 10083
EMOTION = 10084
SUSPENSE = 10057
INSPIRATIONAL = 10039
MYTH = 10085
TIMEBACK = 10017
YEAR = 10086
COUNTRYSIDE = 10087
INVESTIGATION = 10088
PLOT = 10050
FAMILY = 10061
HISTORY = 10033
ARMY = 10089
class Documentary(Enum):
"""
纪录片风格
+ ALL: 全部
+ HISTORY: 历史
+ FOODS: 美食
+ HUMANITIES: 人文
+ TECHNOLOGY: 科技
+ DISCOVER: 探险
+ UNIVERSE: 宇宙
+ PETS: 萌宠
+ SOCIAL: 社会
+ ANIMALS: 动物
+ NATURE: 自然
+ MEDICAL: 医疗
+ WAR: 战争
+ DISATER: 灾难
+ INVESTIGATIONS: 罪案
+ MYSTERIOUS: 神秘
+ TRAVEL: 旅行
+ SPORTS: 运动
+ MOVIES: 电影
"""
ALL = -1
HISTORY = 10033
FOODS = 10045
HUMANITIES = 10065
TECHNOLOGY = 10066
DISCOVER = 10067
UNIVERSE = 10068
PETS = 10069
SOCIAL = 10070
ANIMALS = 10071
NATURE = 10072
MEDICAL = 10073
WAR = 10074
DISATER = 10064
INVESTIGATIONS = 10075
MYSTERIOUS = 10076
TRAVEL = 10077
SPORTS = 10038
MOVIES = -10
class Variety(Enum):
"""
综艺风格
+ ALL: 全部
+ MUSIC: 音乐
+ TALK: 访谈
+ TALK_SHOW: 脱口秀
+ REALITY_SHOW: 真人秀
+ TALENT_SHOW: 选秀
+ FOOD: 美食
+ TRAVEL: 旅行
+ SOIREE: 晚会
+ CONCERT: 演唱会
+ EMOTION: 情感
+ COMEDY: 喜剧
+ PARENT_CHILD: 亲子
+ CULTURE: 文化
+ OFFICE: 职场
+ PET: 萌宠
+ CULTIVATE: 养成
"""
ALL = -1
MUSIC = 10040
TALK = 10091
TALK_SHOW = 10081
REALITY_SHOW = 10092
TALENT_SHOW = 10094
FOOD = 10045
TRAVEL = 10095
SOIREE = 10098
CONCERT = 10096
EMOTION = 10084
COMEDY = 10051
PARENT_CHILD = 10097
CULTURE = 10100
OFFICE = 10048
PET = 10069
CULTIVATE = 10099
class Sort(Enum):
"""
排序方式
+ DESC: 降序
+ ASC: 升序
"""
DESC = "0"
ASC = "1"
class Order(Enum):
"""
排序字段
+ UPDATE: 更新时间
+ DANMAKU: 弹幕数量
+ PLAY: 播放数量
+ FOLLOWER: 追番人数
+ SOCRE: 最高评分
+ ANIME_RELEASE: 番剧开播日期
+ MOVIE_RELEASE: 电影上映日期
"""
UPDATE = "0"
DANMAKU = "1"
PLAY = "2"
FOLLOWER = "3"
SCORE = "4"
ANIME_RELEASE = "5"
MOVIE_RELEASE = "6"
class IndexFilterMeta:
"""
IndexFilter 元数据
用于传入 get_index_info 方法
"""
class Anime:
def __init__(
self,
version: IndexFilter.Version = IndexFilter.Version.ALL,
spoken_language: IndexFilter.Spoken_Language = IndexFilter.Spoken_Language.ALL,
area: IndexFilter.Area = IndexFilter.Area.ALL,
finish_status: IndexFilter.Finish_Status = IndexFilter.Finish_Status.ALL,
copyright: IndexFilter.Copyright = IndexFilter.Copyright.ALL,
payment: IndexFilter.Payment = IndexFilter.Payment.ALL,
season: IndexFilter.Season = IndexFilter.Season.ALL,
year: str = -1,
style: IndexFilter.Style.Anime = IndexFilter.Style.Anime.ALL,
) -> None:
"""
Anime Meta
Args:
version (Index_Filter.Version): 类型,如正片、电影等
spoken_language (Index_Filter.Spoken_Language): 配音
area (Index_Filter.Area): 地区
finish_status (Index_Filter.Finish_Status): 是否完结
copyright (Index_Filter.Copryright): 版权
payment (Index_Filter.Payment): 付费门槛
season (Index_Filter.Season): 季度
year (str): 年份,调用 Index_Filter.make_time_filter() 传入年份 (int, str) 获取
style (Index_Filter.Style.Anime): 风格
"""
self.season_type = IndexFilter.Type.ANIME
self.season_version = version
self.spoken_language_type = spoken_language
self.area = area
self.is_finish = finish_status
self.copyright = copyright
self.season_status = payment
self.season_month = season
self.year = year
self.style_id = style
class Movie:
def __init__(
self,
area: IndexFilter.Area = IndexFilter.Area.ALL,
release_date: str = -1,
style: IndexFilter.Style.Movie = IndexFilter.Style.Movie.ALL,
payment: IndexFilter.Payment = IndexFilter.Payment.ALL,
) -> None:
"""
Movie Meta
Args:
area (Index_Filter.Area): 地区
payment (Index_Filter.Payment): 付费门槛
season (Index_Filter.Season): 季度
release_date (str): 上映时间,调用 Index_Filter.make_time_filter() 传入年份 (datetime.datetime) 获取
style (Index_Filter.Style.Movie): 风格
"""
self.season_type = IndexFilter.Type.MOVIE
self.area = area
self.release_date = release_date
self.style_id = style
self.season_status = payment
class Documentary:
def __init__(
self,
release_date: str = -1,
style: IndexFilter.Style.Documentary = IndexFilter.Style.Documentary.ALL,
payment: IndexFilter.Payment = IndexFilter.Payment.ALL,
producer: IndexFilter.Producer = IndexFilter.Producer.ALL,
) -> None:
"""
Documentary Meta
Args:
area (Index_Filter.Area): 地区
release_date (str): 上映时间,调用 Index_Filter.make_time_filter() 传入年份 (datetime.datetime) 获取
style (Index_Filter.Style.Documentary): 风格
producer (Index_Filter.Producer): 制作方
"""
self.season_type = IndexFilter.Type.DOCUMENTARY
self.release_date = release_date
self.style_id = style
self.season_status = payment
self.producer_id = producer
class TV:
def __init__(
self,
area: IndexFilter.Area = IndexFilter.Area.ALL,
release_date: str = -1,
style: IndexFilter.Style.TV = IndexFilter.Style.TV.ALL,
payment: IndexFilter.Payment = IndexFilter.Payment.ALL,
) -> None:
"""
TV Meta
Args:
area (Index_Filter.Area): 地区
payment (Index_Filter.Payment): 付费门槛
release_date (str): 上映时间,调用 Index_Filter.make_time_filter() 传入年份 (datetime.datetime) 获取
style (Index_Filter.Style.TV): 风格
"""
self.season_type = IndexFilter.Type.TV
self.area = area
self.release_date = release_date
self.style_id = style
self.season_status = payment
class GuoChuang:
def __init__(
self,
version: IndexFilter.Version = IndexFilter.Version.ALL,
finish_status: IndexFilter.Finish_Status = IndexFilter.Finish_Status.ALL,
copyright: IndexFilter.Copyright = IndexFilter.Copyright.ALL,
payment: IndexFilter.Payment = IndexFilter.Payment.ALL,
year: str = -1,
style: IndexFilter.Style.GuoChuang = IndexFilter.Style.GuoChuang.ALL,
) -> None:
"""
Guochuang Meta
Args:
version (Index_Filter.VERSION): 类型,如正片、电影等
finish_status (Index_Filter.Finish_Status): 是否完结
copyright (Index_Filter.Copyright): 版权
payment (Index_Filter.Payment): 付费门槛
year (str): 年份,调用 Index_Filter.make_time_filter() 传入年份 (int, str) 获取
style (Index_Filter.Style.GuoChuang): 风格
"""
self.season_type = IndexFilter.Type.GUOCHUANG
self.season_version = version
self.is_finish = finish_status
self.copyright = copyright
self.season_status = payment
self.year = year
self.style_id = style
class Variety:
def __init__(
self,
style: IndexFilter.Style.Variety = IndexFilter.Style.Variety.ALL,
payment: IndexFilter.Payment = IndexFilter.Payment.ALL,
) -> None:
"""
Variety Meta
Args:
payment (Index_Filter.Payment): 付费门槛
style (Index_Filter.Style.Variety): 风格
"""
self.season_type = IndexFilter.Type.VARIETY
self.season_status = payment
self.style_id = style
async def get_index_info(
filters: IndexFilterMeta = IndexFilterMeta.Anime(),
order: IndexFilter.Order = IndexFilter.Order.SCORE,
sort: IndexFilter.Sort = IndexFilter.Sort.DESC,
pn: int = 1,
ps: int = 20,
) -> dict:
"""
查询番剧索引,索引的详细参数信息见 `IndexFilterMeta`
请先通过 `IndexFilterMeta` 构造 filters
Args:
filters (Index_Filter_Meta, optional): 筛选条件元数据. Defaults to Anime.
order (BANGUMI_INDEX.ORDER, optional): 排序字段. Defaults to SCORE.
sort (BANGUMI_INDEX.SORT, optional): 排序方式. Defaults to DESC.
pn (int, optional): 页数. Defaults to 1.
ps (int, optional): 每页数量. Defaults to 20.
Returns:
dict: 调用 API 返回的结果
"""
api = API["info"]["index"]
params = {}
for key, value in filters.__dict__.items():
if value is not None:
if isinstance(value, Enum):
params[key] = value.value
else:
params[key] = value
if order in params:
if (
order == IndexFilter.Order.SCORE.value
and sort == IndexFilter.Sort.ASC.value
):
raise ValueError(
"order 为 Index_Filter.ORDER.SCORE 时,sort 不能为 Index_Filter.SORT.ASC"
)
# 必要参数 season_type、type
# 常规参数
params["order"] = order.value
params["sort"] = sort.value
params["page"] = pn
params["pagesize"] = ps
# params["st"] 未知参数,暂时不传
# params["type"] 未知参数,为 1
params["type"] = 1
return await Api(**api).update_params(**params).result
class Bangumi:
"""
番剧类
Attributes:
credential (Credential): 凭据类
"""
def __init__(
self,
media_id: int = -1,
ssid: int = -1,
epid: int = -1,
oversea: bool = False,
credential: Union[Credential, None] = None,
) -> None:
"""
Args:
media_id (int, optional) : 番剧本身的 ID. Defaults to -1.
ssid (int, optional) : 每季度的 ID. Defaults to -1.
epid (int, optional) : 每集的 ID. Defaults to -1.
oversea (bool, optional) : 是否要采用兼容的港澳台Api,用于仅限港澳台地区番剧的信息请求. Defaults to False.
credential (Credential | None, optional): 凭据类. Defaults to None.
"""
if media_id == -1 and ssid == -1 and epid == -1:
raise ValueError("需要 Media_id 或 Season_id 或 epid 中的一个 !")
self.credential = credential if credential else Credential()
# 处理极端情况
params = {}
self.__ssid = ssid
if self.__ssid == -1 and epid == -1:
api = API["info"]["meta"]
params = {"media_id": media_id}
meta = Api(**api, credential=credential).update_params(**params).result_sync
self.__ssid = meta["media"]["season_id"]
params["media_id"] = media_id
# 处理正常情况
if self.__ssid != -1:
params["season_id"] = self.__ssid
if epid != -1:
params["ep_id"] = epid
self.oversea = oversea
if oversea:
api = API["info"]["collective_info_oversea"]
else:
api = API["info"]["collective_info"]
resp = Api(**api, credential=credential).update_params(**params).result_sync
self.__raw = resp
self.__epid = epid
# 确认有结果后,取出数据
self.__ssid = resp["season_id"]
self.__media_id = resp["media_id"]
if "up_info" in resp:
self.__up_info = resp["up_info"]
else:
self.__up_info = {}
# 获取剧集相关
self.ep_list = resp.get("episodes")
self.ep_item = [{}]
# 出海 Api 和国内的字段有些不同
if self.ep_list:
if self.oversea:
self.ep_item = [
item for item in self.ep_list if item["ep_id"] == self.__epid
]
else:
self.ep_item = [
item for item in self.ep_list if item["id"] == self.__epid
]
def get_media_id(self) -> int:
return self.__media_id
def get_season_id(self) -> int:
return self.__ssid
def get_up_info(self) -> dict:
"""
番剧上传者信息 出差或者原版
Returns:
Api 相关字段
"""
return self.__up_info
def get_raw(self) -> Tuple[dict, bool]:
"""
原始初始化数据
Returns:
Api 相关字段
"""
return self.__raw, self.oversea
def set_media_id(self, media_id: int) -> None:
self.__init__(media_id=media_id, credential=self.credential)
def set_ssid(self, ssid: int) -> None:
self.__init__(ssid=ssid, credential=self.credential)
async def get_meta(self) -> dict:
"""
获取番剧元数据信息(评分,封面 URL,标题等)
Returns:
dict: 调用 API 返回的结果
"""
credential = self.credential if self.credential is not None else Credential()
api = API["info"]["meta"]
params = {"media_id": self.__media_id}
return await Api(**api, credential=credential).update_params(**params).result
async def get_short_comment_list(
self,
order: BangumiCommentOrder = BangumiCommentOrder.DEFAULT,
next: Union[str, None] = None,
) -> dict:
"""
获取短评列表
Args:
order (BangumiCommentOrder, optional): 排序方式。Defaults to BangumiCommentOrder.DEFAULT
next (str | None, optional) : 调用返回结果中的 next 键值,用于获取下一页数据。Defaults to None
Returns:
dict: 调用 API 返回的结果
"""
credential = self.credential if self.credential is not None else Credential()
api = API["info"]["short_comment"]
params = {"media_id": self.__media_id, "ps": 20, "sort": order.value}
if next is not None:
params["cursor"] = next
return await Api(**api, credential=credential).update_params(**params).result
async def get_long_comment_list(
self,
order: BangumiCommentOrder = BangumiCommentOrder.DEFAULT,
next: Union[str, None] = None,
) -> dict:
"""
获取长评列表
Args:
order (BangumiCommentOrder, optional): 排序方式。Defaults to BangumiCommentOrder.DEFAULT
next (str | None, optional) : 调用返回结果中的 next 键值,用于获取下一页数据。Defaults to None
Returns:
dict: 调用 API 返回的结果
"""
credential = self.credential if self.credential is not None else Credential()
api = API["info"]["long_comment"]
params = {"media_id": self.__media_id, "ps": 20, "sort": order.value}
if next is not None:
params["cursor"] = next
return await Api(**api, credential=credential).update_params(**params).result
async def get_episode_list(self) -> dict:
"""
获取季度分集列表,自动转换出海Api的字段,适配部分,但是键还是有不同
Returns:
dict: 调用 API 返回的结果
"""
if self.oversea:
# 转换 ep_id->id ,index_title->longtitle ,index->title
fix_ep_list = []
for item in self.ep_list:
item["id"] = item.get("ep_id")
item["longtitle"] = item.get("index_title")
item["title"] = item.get("index")
fix_ep_list.append(item)
return {"main_section": {"episodes": fix_ep_list}}
else:
credential = (
self.credential if self.credential is not None else Credential()
)
api = API["info"]["episodes_list"]
params = {"season_id": self.__ssid}
return (
await Api(**api, credential=credential).update_params(**params).result
)
async def get_episodes(self) -> List["Episode"]:
"""
获取番剧所有的剧集,自动生成类。
"""
global episode_data_cache
episode_list = await self.get_episode_list()
if len(episode_list["main_section"]["episodes"]) == 0:
return []
first_epid = episode_list["main_section"]["episodes"][0]["id"]
credential = self.credential if self.credential else Credential()
content_type = None
while content_type != InitialDataType.NEXT_DATA:
bangumi_meta, content_type = await get_initial_state(
url=f"https://www.bilibili.com/bangumi/play/ep{first_epid}",
credential=credential,
)
bangumi_meta["media_id"] = self.get_media_id()
episodes = []
for ep in episode_list["main_section"]["episodes"]:
episode_data_cache[ep["id"]] = {
"bangumi_meta": bangumi_meta,
"bangumi_class": self,
}
episodes.append(Episode(epid=ep["id"], credential=self.credential))
return episodes
async def get_stat(self) -> dict:
"""
获取番剧播放量,追番等信息
Returns:
dict: 调用 API 返回的结果
"""
credential = self.credential if self.credential is not None else Credential()
api = API["info"]["season_status"]
params = {"season_id": self.__ssid}
return await Api(**api, credential=credential).update_params(**params).result
async def get_overview(self) -> dict:
"""
获取番剧全面概括信息,包括发布时间、剧集情况、stat 等情况
Returns:
dict: 调用 API 返回的结果
"""
credential = self.credential if self.credential is not None else Credential()
if self.oversea:
api = API["info"]["collective_info_oversea"]
else:
api = API["info"]["collective_info"]
params = {"season_id": self.__ssid}
return await Api(**api, credential=credential).update_params(**params).result
async def set_follow(
bangumi: Bangumi, status: bool = True, credential: Union[Credential, None] = None
) -> dict:
"""
追番状态设置
Args:
bangumi (Bangumi) : 番剧类
status (bool, optional) : 追番状态. Defaults to True.
credential (Credential | None, optional): 凭据. Defaults to None.
Returns:
dict: 调用 API 返回的结果
"""
credential = credential if credential is not None else Credential()
credential.raise_for_no_sessdata()
api = API["operate"]["follow_add"] if status else API["operate"]["follow_del"]
data = {"season_id": bangumi.get_season_id()}
return await Api(**api, credential=credential).update_data(**data).result
async def update_follow_status(
bangumi: Bangumi, status: int, credential: Union[Credential, None] = None
) -> dict:
"""
更新追番状态
Args:
bangumi (Bangumi) : 番剧类
credential (Credential | None, optional): 凭据. Defaults to None.
status (int) : 追番状态 1 想看 2 在看 3 已看
Returns:
dict: 调用 API 返回的结果
"""
credential = credential if credential is not None else Credential()
credential.raise_for_no_sessdata()
api = API["operate"]["follow_status"]
data = {"season_id": bangumi.get_season_id(), "status": status}
return await Api(**api, credential=credential).update_data(**data).result
class Episode(Video):
"""
番剧剧集类
Attributes:
credential (Credential): 凭据类
video_class (Video) : 视频类
bangumi (Bangumi) : 所属番剧
"""
def __init__(self, epid: int, credential: Union[Credential, None] = None):
"""
Args:
epid (int) : 番剧 epid
credential (Credential, optional): 凭据. Defaults to None.
"""
global episode_data_cache
self.credential: Credential = credential if credential else Credential()
self.__epid: int = epid
if not epid in episode_data_cache.keys():
res, content_type = get_initial_state_sync(
url=f"https://www.bilibili.com/bangumi/play/ep{self.__epid}",
credential=self.credential,
) # 随机 __NEXT_DATA__ 见 https://github.com/Nemo2011/bilibili-api/issues/433
if content_type == InitialDataType.NEXT_DATA:
content = res["props"]["pageProps"]["dehydratedState"]["queries"][0][
"state"
]["data"]["seasonInfo"]["mediaInfo"]
self.bangumi = (
Bangumi(ssid=content["season_id"])
if not epid in episode_data_cache.keys()
else episode_data_cache[epid]["bangumi_class"]
)
for ep_info in content["episodes"]:
if int(
ep_info["id"] if "id" in ep_info else ep_info["ep_id"]
) == int(epid):
bvid = ep_info["bvid"]
self.__ep_info: dict = ep_info
break
else: # InitialDataType.INITIAL_STATE
self.__ep_info: dict = res["epInfo"]
self.bangumi = (
Bangumi(ssid=res["mediaInfo"]["season_id"])
if not epid in episode_data_cache.keys()
else episode_data_cache[epid]["bangumi_class"]
)
bvid = res["epInfo"]["bvid"]
else:
content = episode_data_cache[epid]["bangumi_meta"]
bvid = None
for einfo in content["props"]["pageProps"]["dehydratedState"]["queries"][0][
"state"
]["data"]["seasonInfo"]["mediaInfo"]["episodes"]:
if einfo["ep_id"] == epid:
bvid = einfo["bvid"]
self.bangumi = episode_data_cache[epid]["bangumi_class"]
self.__ep_info: dict = episode_data_cache[epid]
self.video_class = Video(bvid=bvid, credential=self.credential)
super().__init__(bvid=bvid, credential=self.credential)
self.set_aid = self.set_aid_e
self.set_bvid = self.set_bvid_e
def get_epid(self) -> int:
"""
获取 epid
"""
return self.__epid
def set_aid_e(self, aid: int) -> None:
print("Set aid is not allowed in Episode")
def set_bvid_e(self, bvid: str) -> None:
print("Set bvid is not allowed in Episode")
async def get_cid(self) -> int:
"""
获取稿件 cid
Returns:
int: cid
"""
return (await self.get_episode_info())["epInfo"]["cid"]
def get_bangumi(self) -> "Bangumi":
"""
获取对应的番剧
Returns:
Bangumi: 番剧类
"""
return self.bangumi # type: ignore
def set_epid(self, epid: int) -> None:
self.__init__(epid, self.credential)
async def get_episode_info(self) -> dict:
"""
获取番剧单集信息
Returns:
HTML 中的数据
"""
if self.__ep_info is None:
res, content_type = get_initial_state(
url=f"https://www.bilibili.com/bangumi/play/ep{self.__epid}",
credential=self.credential,
)
if content_type == InitialDataType.NEXT_DATA:
content = res["props"]["pageProps"]["dehydratedState"]["queries"][0][
"state"
]["data"]["mediaInfo"]
for ep_info in content["episodes"]:
if int(
ep_info["id"] if "id" in ep_info else ep_info["ep_id"]
) == int(self.get_epid()):
return ep_info
else:
return res["epInfo"]
else:
return self.__ep_info
async def get_bangumi_from_episode(self) -> "Bangumi":
"""
获取剧集对应的番剧
Returns:
Bangumi: 输入的集对应的番剧类
"""
info = await self.get_episode_info()
ssid = info["mediaInfo"]["season_id"]
return Bangumi(ssid=ssid)
async def get_download_url(self) -> dict:
"""
获取番剧剧集下载信息。
Returns:
dict: 调用 API 返回的结果。
"""
api = API["info"]["playurl"]
if True:
params = {
"avid": self.get_aid(),
"ep_id": self.get_epid(),
"qn": "127",
"otype": "json",
"fnval": 4048,
"fourk": 1,
}
return (
await Api(**api, credential=self.credential).update_params(**params).result
)
async def get_danmaku_xml(self) -> str:
"""
获取所有弹幕的 xml 源文件(非装填)
Returns:
str: 文件源
"""
cid = await self.get_cid()
url = f"https://comment.bilibili.com/{cid}.xml"
sess = get_session()
config: dict[str, Any] = {"url": url}
# 代理
if settings.proxy:
config["proxies"] = {"all://", settings.proxy}
resp = await sess.get(**config)
return resp.content.decode("utf-8")
async def get_danmaku_view(self) -> dict:
"""
获取弹幕设置、特殊弹幕、弹幕数量、弹幕分段等信息。
Returns:
dict: 二进制流解析结果
"""
return await self.video_class.get_danmaku_view(0)
async def get_danmakus(
self, date: Union[datetime.date, None] = None
) -> List["Danmaku"]:
"""
获取弹幕
Args:
date (datetime.date | None, optional): 指定某一天查询弹幕. Defaults to None. (不指定某一天)
Returns:
dict[Danmaku]: 弹幕列表
"""
return await self.video_class.get_danmakus(0, date)
async def get_history_danmaku_index(
self, date: Union[datetime.date, None] = None
) -> Union[None, List[str]]:
"""
获取特定月份存在历史弹幕的日期。
Args:
date (datetime.date | None, optional): 精确到年月. Defaults to None。
Returns:
None | List[str]: 调用 API 返回的结果。不存在时为 None。
"""
return await self.video_class.get_history_danmaku_index(0, date)