Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
URLStream Class Reference

Represents the content of a URL as Stream. We use the WiFi.h API. More...

#include <URLStream.h>

Inheritance diagram for URLStream:
AbstractURLStream AudioStream Stream AudioInfoSupport AudioInfoSource Print

Public Member Functions

 URLStream (Client &clientPar, int readBufferSize=DEFAULT_BUFFER_SIZE)
 URLStream (const char *network, const char *password, int readBufferSize=DEFAULT_BUFFER_SIZE)
 URLStream (const URLStream &)=delete
 URLStream (int readBufferSize=DEFAULT_BUFFER_SIZE)
void addRequestHeader (const char *header, const char *value)
 Adds/Updates a request header.
virtual AudioInfo audioInfo () override
virtual int available () override
int availableForWrite () override
 Writes are not supported.
virtual bool begin ()
virtual bool begin (const char *urlStr, const char *acceptMime=nullptr, MethodID action=GET, const char *reqMime="", const char *reqData="") override
void clear ()
 Releases the memory from the request and reply.
int contentLength ()
virtual void end () override
virtual void flush () override
virtual HttpRequesthttpRequest () override
 provides access to the HttpRequest
 operator bool ()
virtual int peek () override
virtual int read () override
virtual size_t readBytes (uint8_t *buffer, size_t length) override
virtual size_t readSilence (uint8_t *buffer, size_t length)
 Source to generate silence: just sets the buffer to 0.
virtual void setAudioInfo (AudioInfo info) override
void setAutoCreateLines (bool flag)
 If set to true, new undefined reply parameters will be stored.
void setClient (Client &clientPar) override
 (Re-)defines the client
void setConnectionClose (bool close)
 Sets if the connection should be close automatically.
void setLogLevel (AudioLogger::LogLevel level)
 Defines the class specific custom log level.
virtual bool setMetadataCallback (void(*fn)(MetaDataType info, const char *str, int len))
virtual void setNotifyAudioChange (AudioInfoSupport &bi) override
void setOnConnectCallback (void(*callback)(HttpRequest &request, Url &url, HttpRequestHeader &request_header))
 Callback which allows you to add additional paramters dynamically.
void setPassword (const char *password) override
 Sets the password that will be used for logging in (when calling begin)
void setPowerSave (bool ps)
 if set to true, it activates the power save mode which comes at the cost of performance! - By default this is deactivated. ESP32 Only!
void setReadBufferSize (int readBufferSize)
void setSSID (const char *ssid) override
 Sets the ssid that will be used for logging in (when calling begin)
virtual void setTimeout (int ms)
 Defines the client timeout.
void setWaitForData (bool flag)
size_t totalRead ()
virtual bool validate (AudioInfo &info)
virtual bool waitForData ()
 waits for some data - returns false if the request has failed
virtual size_t write (const uint8_t *, size_t) override
virtual size_t write (uint8_t) override
virtual void writeSilence (size_t len)
 Writes len bytes of silence (=0).

Protected Member Functions

void fillBuffer ()
ClientgetClient (bool isSecure)
 Determines the client.
bool isEOS ()
void login ()
virtual int not_supported (int out, const char *msg="")
int process (MethodID action, Url &url, const char *reqMime, const char *reqData, int len=-1)
 Process the Http request and handle redirects.
void refillReadBuffer ()

Protected Attributes

bool active = false
Clientclient =nullptr
WiFiClient * clientInsecure =nullptr
int clientTimeout = 60000
CustomLogLevel custom_log_level
unsigned long handshakeTimeout = 120000
AudioInfo info
bool is_power_save = false
const char * network =nullptr
AudioInfoSupportp_notify =nullptr
const char * password =nullptr
Vector< uint8_t > read_buffer {0}
uint16_t read_buffer_size =DEFAULT_BUFFER_SIZE
uint16_t read_pos
uint16_t read_size
HttpRequest request
long size
RingBuffer< uint8_t > tmp_in {0}
RingBuffer< uint8_t > tmp_out {0}
long total_read
Url url
StrExt url_str
bool wait_for_data = true

Detailed Description

Represents the content of a URL as Stream. We use the WiFi.h API.

Phil Schatzmann

The documentation for this class was generated from the following file: