qqmusic-api-python 0.7.2__py3-none-any.whl → 0.7.3__py3-none-any.whl

qqmusic_api/__init__.py

@@ -22,7 +22,7 @@ from .core.exceptions import (
 from .core.versioning import Platform
 from .models.request import Credential
 
-__version__ = "0.7.2"
+__version__ = "0.7.3"
 
 __all__ = [
     "ApiDataError",

qqmusic_api/models/singer.py

@@ -248,6 +248,31 @@ class HomepageTabDetailResponse(Response):
     )
 
 
+class SingerNameSpecialDisplayResponse(Response):
+    """歌手名称特殊展示信息.
+
+    Attributes:
+        display_type: 展示类型, 2 表示名称图片, 0 表示无特殊展示.
+        pic_file: 透明 PNG 地址, 无名称图片时为空字符串.
+        signature_name_overlap_ratio: 上游返回的签名与名称重叠比例.
+        name: 歌手名称.
+    """
+
+    display_type: int = Field(
+        default=0,
+        json_schema_extra={"jsonpath": "$.Info.Singer.SingerNameSpecialDisplay.DisplayType"},
+    )
+    pic_file: str = Field(
+        default="",
+        json_schema_extra={"jsonpath": "$.Info.Singer.SingerNameSpecialDisplay.PicFile"},
+    )
+    signature_name_overlap_ratio: float = Field(
+        default=0.0,
+        json_schema_extra={"jsonpath": "$.Info.Singer.SingerNameSpecialDisplay.SignatureNameOverlapRatio"},
+    )
+    name: str = Field(default="", json_schema_extra={"jsonpath": "$.Info.Singer.Name"})
+
+
 class HomepageHeaderResponse(Response):
     """歌手主页头部响应.
 

qqmusic_api/modules/singer.py

@@ -17,6 +17,7 @@ from ..models.singer import (
     SingerDetailResponse,
     SingerIndexPageResponse,
     SingerMvListResponse,
+    SingerNameSpecialDisplayResponse,
     SingerSongListResponse,
     SingerTypeListResponse,
 )
@@ -208,6 +209,24 @@ class SingerApi(ApiModule):
             platform=Platform.ANDROID,
         )
 
+    def get_name_special_display(self, mid: str):
+        """获取歌手名称透明 PNG 展示信息.
+
+        返回歌手名称、展示类型、图片地址和重叠比例.
+        无名称图片时, 返回 display_type=0 和空 pic_file.
+
+        Args:
+            mid: 歌手 MID.
+        """
+        return self._build_cgi(
+            module="music.UnifiedHomepage.UnifiedHomepageSrv",
+            method="GetHomepageHeader",
+            param={"SingerMid": mid},
+            response_model=SingerNameSpecialDisplayResponse,
+            platform=Platform.ANDROID,
+            comm={"cv": 20_080_000, "v": 20_080_000},
+        )
+
     def get_tab_detail(
         self,
         mid: str,

qqmusic_api/modules/song.py

@@ -283,8 +283,11 @@ class SongApi(ApiModule):
             credential: 凭据对象.
 
         Raises:
-            ValueError: 当 `mid` 数量超过上限时抛出.
+            ValueError: 当 `mid` 数量超过上限时抛出. 超限时上游返回错误且无结果, 故提前拒绝.
         """
+        if len(file_info) > self._GET_SONG_URLS_MAX_MID:
+            raise ValueError(f"mid 数量不能超过 {self._GET_SONG_URLS_MAX_MID}, 当前为 {len(file_info)}")
+
         encrypted = isinstance(file_type, EncryptedSongFileType)
         module, method = (
             ("music.vkey.GetVkey", "UrlGetVkey") if not encrypted else ("music.vkey.GetEVkey", "CgiGetEVkey")

{qqmusic_api_python-0.7.2.dist-info → qqmusic_api_python-0.7.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: qqmusic-api-python
-Version: 0.7.2
+Version: 0.7.3
 Summary: QQ音乐API封装库
 Project-URL: documentation, https://l-1124.github.io/QQMusicApi/
 Project-URL: homepage, https://l-1124.github.io/QQMusicApi/

{qqmusic_api_python-0.7.2.dist-info → qqmusic_api_python-0.7.3.dist-info}/RECORD

@@ -1,4 +1,4 @@
-qqmusic_api/__init__.py,sha256=HxkeO5SHRUnIx52utUx14CdYHJY-wP3SxtwnIshx4bg,1044
+qqmusic_api/__init__.py,sha256=1E-oHvtsiObk9c6wfvdGaZGuDu_FnbmjLaqWICO6Jq4,1044
 qqmusic_api/algorithms/__init__.py,sha256=hpRXSLHCFwAJn_kGVLmebXJmwl01shXP-_YBz1V7vMM,1228
 qqmusic_api/algorithms/sign.py,sha256=udSOw4SqPQC_IMqZ9ITxtNbr_8F8iFpgQQ0CYVJgKk8,1082
 qqmusic_api/algorithms/tripledes.py,sha256=an5zZXRPNbkEx3r7RGK9K052V_m0dCKzcqh2iAViDOA,18861
@@ -22,7 +22,7 @@ qqmusic_api/models/private_message.py,sha256=D-ODrxoXOffIilOCH7TbCy8IoP2hMRSNP7I
 qqmusic_api/models/recommend.py,sha256=kv86tcYvr8iU6rlZHK18dLpd3k9ahTTvYGQVVvtXNz4,5251
 qqmusic_api/models/request.py,sha256=MwwmeJcLayF8bcI-46C41QwprDhG4IWsjQBDDmsDRCo,5608
 qqmusic_api/models/search.py,sha256=NskyTH7wc3QkX3H_gaYSe0ct1wPQCYASJxyjIk5YXWM,14539
-qqmusic_api/models/singer.py,sha256=IWxOBY_zePGr-zLeVh2VDDKvS5lfEKYXZKkvupTtD5A,13974
+qqmusic_api/models/singer.py,sha256=3x867BAeqhnK7bHV8ywulVdQZMftYjbeve5af2lJLIs,14921
 qqmusic_api/models/song.py,sha256=uspopwbBsbgiVCkIzz86Dn6SscYY2vl8ekXDv258HzQ,12047
 qqmusic_api/models/songlist.py,sha256=CdVkDdw7Ro55KKNd0NfMsMZLns0ZTLnkWzsGdSzzlpE,1906
 qqmusic_api/models/top.py,sha256=t-hE4TGQyetLFNeEYM7K--ne3Ht0zq8I_AZ3udVB-HE,3792
@@ -40,8 +40,8 @@ qqmusic_api/modules/mv.py,sha256=tpcIX_KYIpU2c5D88_PZTnWMxPTklAiaNvjzv8aOA_A,318
 qqmusic_api/modules/private_message.py,sha256=3dQIH-vaFwrbFNy96qILSUmjfMNZnapnYv3QpJKFAYo,15970
 qqmusic_api/modules/recommend.py,sha256=B0scy-r4tYeYkWNqT1BzUko_0dr-BiBz1z0m5H9aLp4,4659
 qqmusic_api/modules/search.py,sha256=-vAVsW2HeQoK8oP-bzXe4OKleWZbUyYACl6KNKmCKjY,8787
-qqmusic_api/modules/singer.py,sha256=k0ucDX2C47EpUl7wCZJaW5f3Jd5_NOC0aAW6jESB_Uk,10097
-qqmusic_api/modules/song.py,sha256=tOJkVCyIpSCTDjQ81SppKdja7fTOdDx3Fm1gIztxI6Q,15916
+qqmusic_api/modules/singer.py,sha256=s-rklcL9_Yi2LsEe7R6MIR5DBMEgrw096C18IRrWoJQ,10774
+qqmusic_api/modules/song.py,sha256=pxdpU1YO_g4dZgd1SVDRjGRYfaj-pm2Wyyje7yaD64I,16146
 qqmusic_api/modules/songlist.py,sha256=CgO6euJmFj9kY8i2IXYa3NqooMrq_g32IPbF8KAJL_0,6754
 qqmusic_api/modules/top.py,sha256=0bCiJ3FBcBkBxvh_1zLgYBzTM58fzS2XH2hGmfjPgvw,1558
 qqmusic_api/modules/user.py,sha256=9atZXXSMiz-qmwj26K9SD3qLz8FoNJDHtjFGudyhymc,17245
@@ -50,7 +50,7 @@ qqmusic_api/utils/common.py,sha256=nzfZ9WtT0j8RBpyisYy_7hK6rXiO7bpG1G6OmXUWBAc,2
 qqmusic_api/utils/device.py,sha256=2IhWb5ulyoSbMccYP2GguzExMnx9VaEAHYGktNzWPqM,6197
 qqmusic_api/utils/mqtt.py,sha256=nufRKYEhJ2siYM_LRpAHl-B3CiSmM4GT4XdYp3uLMF8,22940
 qqmusic_api/utils/qimei.py,sha256=CTMe3bZepbXYYiYHJ878QNJ3nV0zfua8JvS0JPjJ5Ac,9068
-qqmusic_api_python-0.7.2.dist-info/METADATA,sha256=NFH_481S0hgYq5jV8VcKUuIust4I41bTKgal7PyPw9Q,4190
-qqmusic_api_python-0.7.2.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
-qqmusic_api_python-0.7.2.dist-info/licenses/LICENSE,sha256=xTplwv1WHIfqq_EHLvXcq4ZTBCvBUwhGX1JBNYXrYnE,35146
-qqmusic_api_python-0.7.2.dist-info/RECORD,,
+qqmusic_api_python-0.7.3.dist-info/METADATA,sha256=wa9iWSVKDgufXxpy2I3jIAuBIi8eiJNnF5umcZDIWe0,4190
+qqmusic_api_python-0.7.3.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+qqmusic_api_python-0.7.3.dist-info/licenses/LICENSE,sha256=xTplwv1WHIfqq_EHLvXcq4ZTBCvBUwhGX1JBNYXrYnE,35146
+qqmusic_api_python-0.7.3.dist-info/RECORD,,

{qqmusic_api_python-0.7.2.dist-info → qqmusic_api_python-0.7.3.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.31.0
+Generator: hatchling 1.32.0
 Root-Is-Purelib: true
 Tag: py3-none-any