跳转至

utils.common

实用函数

calc_md5 

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

计算 MD5 值

源代码位于： qqmusic_api/utils/common.py 
11
12
13
14
15
16
17
18
19
20
21
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_guid 

get_guid() -> str

随机 guid

返回 描述
str

随机 guid
源代码位于： qqmusic_api/utils/common.py 
24
25
26
27
28
29
30
def get_guid() -> str:
    """随机 guid

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

hash33 

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

hash33

参数 描述
s

待计算的字符串

类型： str

h

前一个计算结果

类型： int 默认： 0

Returns:
计算结果

源代码位于： qqmusic_api/utils/common.py 
33
34
35
36
37
38
39
40
41
42
43
44
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

返回 描述
str

随机 searchID
源代码位于： qqmusic_api/utils/common.py 
47
48
49
50
51
52
53
54
55
56
57
58
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 解码

参数 描述
encrypted_qrc

加密的 QRC 数据

类型： str | bytearray | bytes

返回 描述
str

解密后的 QRC 数据
引发 描述
ValueError

解密失败
源代码位于： qqmusic_api/utils/common.py 
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
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}")