org.schabi.newpipe.extractor.services.soundcloud

Class SoundcloudParsingHelper

java.lang.Object

org.schabi.newpipe.extractor.services.soundcloud.SoundcloudParsingHelper

public final class SoundcloudParsingHelper
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static String	SOUNDCLOUD_API_V2_URL

Method Summary

Modifier and Type	Method and Description
static String	clientId()
static String	getAvatarUrl(com.grack.nanojson.JsonObject object)
static String	getStreamsFromApi(StreamInfoItemsCollector collector, String apiUrl)
static String	getStreamsFromApi(StreamInfoItemsCollector collector, String apiUrl, boolean charts) Fetch the streams from the given API and commit each of them to the collector.
static String	getStreamsFromApiMinItems(int minItems, StreamInfoItemsCollector collector, String apiUrl) Fetch the streams from the given API and commit each of them to the collector.
static String	getUploaderName(com.grack.nanojson.JsonObject object)
static String	getUploaderUrl(com.grack.nanojson.JsonObject object)
static String	getUsersFromApi(ChannelInfoItemsCollector collector, String apiUrl) Fetch the user items from the given API and commit each of them to the collector.
static String	getUsersFromApiMinItems(int minItems, ChannelInfoItemsCollector collector, String apiUrl) Fetch the users from the given API and commit each of them to the collector.
static OffsetDateTime	parseDateFrom(String textualUploadDate)
static com.grack.nanojson.JsonObject	resolveFor(Downloader downloader, String url) Call the endpoint "/resolve" of the API.
static String	resolveIdWithWidgetApi(String urlString) Fetch the widget API with the url and return the id (like the id from the json API).
static String	resolveUrlWithEmbedPlayer(String apiUrl) Fetch the embed player with the apiUrl and return the canonical url (like the permalink_url from the json API).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SOUNDCLOUD_API_V2_URL

public static final String SOUNDCLOUD_API_V2_URL

See Also:

Constant Field Values

Method Detail

clientId

public static String clientId()
                       throws ExtractionException,
                              IOException

Throws:

ExtractionException

IOException

parseDateFrom

public static OffsetDateTime parseDateFrom(String textualUploadDate)
                                    throws ParsingException

Throws:

ParsingException

resolveFor

public static com.grack.nanojson.JsonObject resolveFor(@Nonnull
                                                       Downloader downloader,
                                                       String url)
                                                throws IOException,
                                                       ExtractionException

Call the endpoint "/resolve" of the API.

See https://developers.soundcloud.com/docs/api/reference#resolve

Throws:

IOException

ExtractionException

resolveUrlWithEmbedPlayer

public static String resolveUrlWithEmbedPlayer(String apiUrl)
                                        throws IOException,
                                               ReCaptchaException

Fetch the embed player with the apiUrl and return the canonical url (like the permalink_url from the json API).

Returns:

the url resolved

Throws:

IOException

ReCaptchaException

resolveIdWithWidgetApi

public static String resolveIdWithWidgetApi(String urlString)
                                     throws IOException,
                                            ParsingException

Fetch the widget API with the url and return the id (like the id from the json API).

Returns:

the resolved id

Throws:

IOException

ParsingException

getUsersFromApiMinItems

public static String getUsersFromApiMinItems(int minItems,
                                             ChannelInfoItemsCollector collector,
                                             String apiUrl)
                                      throws IOException,
                                             ReCaptchaException,
                                             ParsingException

Fetch the users from the given API and commit each of them to the collector.

This differ from getUsersFromApi(ChannelInfoItemsCollector, String) in the sense that they will always get MIN_ITEMS or more.

Parameters:

minItems - the method will return only when it have extracted that many items (equal or more)

Throws:

IOException

ReCaptchaException

ParsingException

getUsersFromApi

public static String getUsersFromApi(ChannelInfoItemsCollector collector,
                                     String apiUrl)
                              throws IOException,
                                     ReCaptchaException,
                                     ParsingException

Fetch the user items from the given API and commit each of them to the collector.

Returns:

the next streams url, empty if don't have

Throws:

IOException

ReCaptchaException

ParsingException

getStreamsFromApiMinItems

public static String getStreamsFromApiMinItems(int minItems,
                                               StreamInfoItemsCollector collector,
                                               String apiUrl)
                                        throws IOException,
                                               ReCaptchaException,
                                               ParsingException

Fetch the streams from the given API and commit each of them to the collector.

This differ from getStreamsFromApi(StreamInfoItemsCollector, String) in the sense that they will always get MIN_ITEMS or more items.

Parameters:

minItems - the method will return only when it have extracted that many items (equal or more)

Throws:

IOException

ReCaptchaException

ParsingException

getStreamsFromApi

public static String getStreamsFromApi(StreamInfoItemsCollector collector,
                                       String apiUrl,
                                       boolean charts)
                                throws IOException,
                                       ReCaptchaException,
                                       ParsingException

Fetch the streams from the given API and commit each of them to the collector.

Returns:

the next streams url, empty if don't have

Throws:

IOException

ReCaptchaException

ParsingException

getStreamsFromApi

public static String getStreamsFromApi(StreamInfoItemsCollector collector,
                                       String apiUrl)
                                throws ReCaptchaException,
                                       ParsingException,
                                       IOException

Throws:

ReCaptchaException

ParsingException

IOException

getUploaderUrl

@Nonnull
public static String getUploaderUrl(com.grack.nanojson.JsonObject object)

getAvatarUrl

@Nonnull
public static String getAvatarUrl(com.grack.nanojson.JsonObject object)

getUploaderName

public static String getUploaderName(com.grack.nanojson.JsonObject object)