MoviePilot/app/modules/vyo/module.py

from typing import Any, Dict, Generator, List, Optional, Tuple, Union

from app.modules._base.mediaserver import _MediaServerModuleBase
from app.modules.vyo.vyo import Vyo
from app.runtime.log import logger
from app.schemas.dashboard import Statistic as _SchemaStatistic
from app.schemas.mediaserver import MediaServerItem as _SchemaMediaServerItem
from app.schemas.mediaserver import MediaServerLibrary as _SchemaMediaServerLibrary
from app.schemas.mediaserver import MediaServerPlayItem as _SchemaMediaServerPlayItem
from app.schemas.mediaserver import MediaServerSeasonInfo as _SchemaMediaServerSeasonInfo
from app.schemas.types import MediaServerType, ModuleType


class VyoModule(_MediaServerModuleBase[Vyo]):
    """Vyo 媒体服务模块。"""

    # 媒体库标识（ExistMediaInfo.server_type）
    # 配置类型值沿用 mediavault，兼容已保存的媒体服务器配置
    _server_type_value = "mediavault"

    def init_module(self) -> None:
        """
        初始化模块
        """
        # 展示名更改为 Vyo，持久化配置类型仍为 mediavault，不能从类名推导。
        super().init_service(
            service_name=self._server_type_value,
            service_type=lambda conf: Vyo(
                **conf.config, sync_libraries=conf.sync_libraries
            ),
        )

    @staticmethod
    def get_name() -> str:
        return "Vyo"

    @staticmethod
    def get_type() -> ModuleType:
        """
        获取模块类型
        """
        return ModuleType.MediaServer

    @staticmethod
    def get_subtype() -> MediaServerType:
        """
        获取模块子类型
        """
        return MediaServerType.Vyo

    @staticmethod
    def get_priority() -> int:
        """
        获取模块优先级，数字越小优先级越高，只有同一接口下优先级才生效
        """
        return 7

    def init_setting(self) -> Optional[Tuple[str, Union[str, bool]]]:
        """本模块不使用开关设置。"""
        return None

    def _is_inactive(self, server: Vyo) -> bool:
        """未配置的实例不参与定时重连。"""
        return server.is_configured() and server.is_inactive()

    def stop(self) -> None:
        """停止模块"""
        for server in self.get_instances().values():
            try:
                server.disconnect()
            except Exception as err:
                logger.error(f"停止 Vyo 模块实例失败：{err}")

    def _test_server(self, server: Vyo, name: str) -> Optional[str]:
        """用配置完整性与 API Key 探测结果判断连接状态。"""
        if not server.is_configured():
            return f"{self.get_name()}配置不完整：{name}"
        if server.is_inactive() and not server.reconnect():
            return f"无法连接{self.get_name()}：{name}"
        return None

    def media_statistic(
        self, server: Optional[str] = None
    ) -> Optional[List[_SchemaStatistic]]:
        """
        媒体数量统计
        """
        if server:
            server_obj: Optional[Vyo] = self.get_instance(server)
            servers = [server_obj] if server_obj else []
        else:
            servers = list(self.get_instances().values())
        statistics = []
        for s in servers:
            statistic = s.get_medias_count()
            if not statistic:
                continue
            statistic.user_count = s.get_user_count()
            statistics.append(statistic)
        return statistics

    def mediaserver_librarys(
        self, server: Optional[str] = None, hidden: Optional[bool] = False, **kwargs: Any
    ) -> Optional[List[_SchemaMediaServerLibrary]]:
        """
        媒体库列表
        """
        server_obj: Optional[Vyo] = self.get_instance(server)
        if server_obj:
            return server_obj.get_librarys(hidden=hidden)
        return None

    def mediaserver_items(
        self,
        server: str,
        library_id: Union[str, int],
        start_index: Optional[int] = 0,
        limit: Optional[int] = -1,
    ) -> Optional[Generator[Optional[_SchemaMediaServerItem], Any, None]]:
        """
        获取媒体服务器项目列表，支持分页和不分页逻辑，默认不分页获取所有数据

        :param server: 媒体服务器名称
        :param library_id: 媒体库ID
        :param start_index: 起始索引
        :param limit: 每次请求的最大项目数，None 或 -1 表示一次性获取所有数据
        """
        server_obj: Optional[Vyo] = self.get_instance(server)
        if server_obj:
            return server_obj.get_items(library_id, start_index, limit)
        return None

    def mediaserver_items_count(
        self, server: str, library_id: Union[str, int]
    ) -> Optional[int]:
        """
        获取指定媒体库可同步的媒体条目总数
        """
        server_obj: Optional[Vyo] = self.get_instance(server)
        if server_obj:
            return server_obj.get_items_count(library_id)
        return None

    def mediaserver_iteminfo(
        self, server: str, item_id: str
    ) -> Optional[_SchemaMediaServerItem]:
        """
        媒体库项目详情
        """
        server_obj: Optional[Vyo] = self.get_instance(server)
        if server_obj:
            return server_obj.get_iteminfo(str(item_id))
        return None

    def mediaserver_tv_episodes(
        self, server: str, item_id: Union[str, int]
    ) -> Optional[List[_SchemaMediaServerSeasonInfo]]:
        """
        获取剧集信息
        """
        server_obj: Optional[Vyo] = self.get_instance(server)
        if not server_obj:
            return None
        _, seasoninfo = server_obj.get_tv_episodes(item_id=str(item_id))
        if not seasoninfo:
            return []
        return [
            _SchemaMediaServerSeasonInfo(season=season, episodes=episodes)
            for season, episodes in seasoninfo.items()
        ]

    def mediaserver_season_episode_ids(
        self, server: str, item_id: Union[str, int], season: int
    ) -> Optional[Dict[int, str]]:
        """
        获取指定季的集号到条目 ID 映射
        """
        server_obj: Optional[Vyo] = self.get_instance(server)
        if not server_obj:
            return None
        return server_obj.get_season_episode_ids(str(item_id), season)

    def mediaserver_playing(
        self, server: str, count: Optional[int] = 20, **kwargs: Any
    ) -> Optional[List[_SchemaMediaServerPlayItem]]:
        """
        获取媒体服务器正在播放信息
        """
        server_obj: Optional[Vyo] = self.get_instance(server)
        if not server_obj:
            return None
        return server_obj.get_resume(num=count)

    def mediaserver_play_url(
        self, server: str, item_id: Union[str, int]
    ) -> Optional[str]:
        """
        获取媒体库播放地址
        """
        server_obj: Optional[Vyo] = self.get_instance(server)
        if not server_obj:
            return None
        return server_obj.get_play_url(str(item_id))

    def mediaserver_latest(
        self, server: Optional[str] = None, count: Optional[int] = 20, **kwargs: Any
    ) -> Optional[List[_SchemaMediaServerPlayItem]]:
        """
        获取媒体服务器最新入库条目
        """
        server_obj: Optional[Vyo] = self.get_instance(server)
        if not server_obj:
            return None
        return server_obj.get_latest(num=count)

    def mediaserver_latest_images(
        self,
        server: Optional[str] = None,
        count: Optional[int] = 20,
        remote: Optional[bool] = False,
        **kwargs: Any,
    ) -> List[str]:
        """
        获取媒体服务器最新入库条目的图片

        :param server: 媒体服务器名称
        :param count: 获取数量
        :param remote: True为外网链接，False为内网链接
        """
        server_obj: Optional[Vyo] = self.get_instance(server)
        if not server_obj:
            return []
        return server_obj.get_latest_backdrops(num=count, remote=remote) or []