searchMusic [2/2]

Searches for music resources.

public abstract String searchMusic(String keyword, int page, int pageSize, String jsonOption);

Related Callbacks

After successfully calling this method, the SDK triggers the onMusicCollectionResult callback to report the retrieved music resource list.

Parameters

keyword
Search keyword. Supports searching by song name or singer name.
page
The target page number of the music resource list to retrieve.
pageSize
The maximum number of music resources displayed per page. Maximum value is 50.
jsonOption
Optional JSON extension field, default is null. You can use this field to filter the desired music resources. Currently supported filter conditions:
  • pitchType: Whether scoring is supported.
    • 1: Music resources that support scoring.
    • 2: Music resources that do not support scoring.
  • needHighPart: Whether a chorus segment is needed.
    • true: Chorus segment needed.
    • false: Chorus segment not needed.

Return Values

  • On success, returns the unique identifier requestId for the request.
  • On failure, returns an empty string.