The match function is the primary entrypoint for resolving a music ID into a playable song object. It searches for the music metadata and then attempts to find valid streaming URLs across multiple music providers.
Parameters
id: The unique identifier for the music track.source (optional): An array of provider names to prioritize (e.g., ['qq', 'kuwo']). If not provided, it defaults to ['qq', 'kuwo', 'migu'] or uses global.source if available.
Supported Providers
The following providers are supported for matching:
neteaseqqxiamibaidukugoukuwomigujooxyoutube
Return Value
Returns a Promise that resolves to a song object containing:
url: The playable streaming URL.size: The file size in bytes.br: The bitrate (in bps).md5: The MD5 hash of the track (if available from the provider).
If no playable URL is found, the promise rejects.