跳转至

utils.common

实用函数

calc_md5 

calc_md5(*strings: str | bytes) -> str

计算 MD5 值

Source code in qqmusic_api/utils/common.py 
13
14
15
16
17
18
19
20
21
22
23
def calc_md5(*strings: str | bytes) -> str:
    """计算 MD5 值"""
    md5 = hashlib.md5()
    for item in strings:
        if isinstance(item, bytes):
            md5.update(item)
        elif isinstance(item, str):
            md5.update(item.encode())
        else:
            raise ValueError(f"Unsupported type: {type(item)}")
    return md5.hexdigest()

get_api 

get_api(field: str) -> dict

获取 api 字典

PARAMETER DESCRIPTION
field

字段名

TYPE: str

RETURNS DESCRIPTION
dict

api 字典
Source code in qqmusic_api/utils/common.py 
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
def get_api(field: str) -> dict:
    """获取 api 字典

    Args:
        field: 字段名

    Returns:
        api 字典
    """
    path = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "data", "api", f"{field.lower()}.json"))
    if os.path.exists(path):
        with open(path, encoding="utf8") as f:
            return json.load(f)
    else:
        return {}

get_guid 

get_guid() -> str

随机 guid

RETURNS DESCRIPTION
str

随机 guid
Source code in qqmusic_api/utils/common.py 
43
44
45
46
47
48
49
def get_guid() -> str:
    """随机 guid

    Returns:
        随机 guid
    """
    return "".join(random.choices("abcdef1234567890", k=32))

hash33 

hash33(s: str, h: int = 0) -> int

hash33

PARAMETER DESCRIPTION
s

待计算的字符串

TYPE: str

h

前一个计算结果

TYPE: int DEFAULT: 0

Returns:
计算结果

Source code in qqmusic_api/utils/common.py 
52
53
54
55
56
57
58
59
60
61
62
63
def hash33(s: str, h: int = 0) -> int:
    """hash33

    Args:
        s: 待计算的字符串
        h: 前一个计算结果
    Returns:
        计算结果
    """
    for c in s:
        h = (h << 5) + h + ord(c)
    return 2147483647 & h

get_searchID 

get_searchID() -> str

随机 searchID

RETURNS DESCRIPTION
str

随机 searchID
Source code in qqmusic_api/utils/common.py 
66
67
68
69
70
71
72
73
74
75
76
77
def get_searchID() -> str:
    """随机 searchID

    Returns:
        随机 searchID
    """
    e = random.randint(1, 20)
    t = e * 18014398509481984
    n = random.randint(0, 4194304) * 4294967296
    a = time.time()
    r = round(a * 1000) % (24 * 60 * 60 * 1000)
    return str(t + n + r)

qrc_decrypt 

qrc_decrypt(encrypted_qrc: str | bytearray | bytes) -> str

QRC 解码

PARAMETER DESCRIPTION
encrypted_qrc

加密的 QRC 数据

TYPE: str | bytearray | bytes

RETURNS DESCRIPTION
str

解密后的 QRC 数据
RAISES DESCRIPTION
ValueError

解密失败
Source code in qqmusic_api/utils/common.py 
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
def qrc_decrypt(encrypted_qrc: str | bytearray | bytes) -> str:
    """QRC 解码

    Args:
        encrypted_qrc: 加密的 QRC 数据

    Returns:
        解密后的 QRC 数据

    Raises:
        ValueError: 解密失败
    """
    if not encrypted_qrc:
        return ""

    # 将输入转为 bytearray 格式
    if isinstance(encrypted_qrc, str):
        encrypted_qrc = bytearray.fromhex(encrypted_qrc)
    elif isinstance(encrypted_qrc, bytearray | bytes):
        encrypted_qrc = bytearray(encrypted_qrc)
    else:
        raise ValueError("无效的加密数据类型")

    try:
        data = bytearray()
        schedule = tripledes_key_setup(b"!@#)(*$%123ZXC!@!@#)(NHL", DECRYPT)

        # 分块解密数据
        # 以 8 字节为单位迭代 encrypted_qrc
        for i in range(0, len(encrypted_qrc), 8):
            data += tripledes_crypt(encrypted_qrc[i : i + 8], schedule)

        return zlib.decompress(data).decode("utf-8")

    except Exception as e:
        raise ValueError(f"解密失败: {e}")