quvi API

QUVIcode quvi_init( quvi_t  * session )

Creates a new session.

Parameters

Returns

Non-zero value if an error occurred.

See Also

• quvi_close
• quvi_strerror

Example

QUVIcode rc;
quvi_t q;
rc = quvi_init(&q);
if (rc != QUVI_OK)
  {
    fprintf(stderr, "%s\n", quvi_strerror(q,rc));
    return (rc);
  }
quvi_close(&q);

void quvi_close( quvi_t  * session )

Closes a previously started session.

Parameters

See Also

quvi_init

QUVIcode quvi_setopt( quvi_t  session, QUVIoption  option,   ... )

Sets a session option.

Parameters

Returns

Non-zero value if an error occurred.

Example

quvi_setopt(q, QUVIOPT_FORMAT, "best");
quvi_setopt(q, QUVIOPT_CATEGORY, QUVIPROTO_HTTP|QUVIPROTO_RTMP);

QUVIcode quvi_getinfo( quvi_t  session, QUVIinfo  info,   ... )

Returns session info.

Parameters

Returns

Non-zero value if an error occurred.

Example

long resp_code;
quvi_getinfo(q, QUVIINFO_RESPONSECODE, &resp_code);

QUVIcode quvi_parse( quvi_t  session, char  * url, quvi_media_t  * media )

Parses an URL.

Parameters

Returns

Non-zero value if an error occurred.

See Also

• quvi_parse_close
• quvi_close

Example

quvi_media_t m;
rc = quvi_parse(q, URL, &m);
if (rc != QUVI_OK)
  {
    ...
  }
quvi_parse_close(&m);

void quvi_parse_close( quvi_media_t  * media )

Releases a previously allocated media handle.

Parameters

QUVIcode quvi_getprop( quvi_media_t  media, QUVIproperty  property,   ... )

Returns a media property.

Parameters

Returns

Non-zero value if an error occurred.

Example

Error handling omitted for brewity.

double media_content_length;
char *media_url;
quvi_media_t m;
quvi_t q;

quvi_init(&q);
quvi_parse(q, URL, &m);
quvi_getprop(m, QUVIPROP_MEDIAURL, &media_url);
quvi_getprop(m, QUVIPROP_MEDIACONTENTLENGTH, &media_content_length);
quvi_parse_close(&m);
quvi_close(&q);

QUVIcode quvi_query_formats( quvi_t  session, char  * url, char  ** formats )

Queries available formats to the URL.  The query is done over an Internet connection.  It resolves any shortened URLs unless QUVIOPT_NORESOLVE is set explicitly with quvi_setopt.  This function checks also if an URL is supported, similarly to that quvi_supported.

Unlike quvi_supported, quvi_supported_ident and quvi_next_supported_website which all return a static list of format string, quvi_query_formats constructs the list from the data returned by the server.

The exception to the above are the webscripts that support only 1 format.  They will always return the string ‘default’.

Parameters

Returns

A null-terminated string or NULL.  quvi_free it when done.

See Also

• quvi_init
• quvi_close
• quvi_free

Example

Error handling omitted for brewity.

char *formats;
quvi_t q;

quvi_init(&q);
quvi_query_formats(q, URL, &formats);
puts(formats);
quvi_free(formats);
quvi_close(&q);

QUVIcode quvi_next_media_url( quvi_media_t  media )

Iterates the media stream URLs.

Parameters

Returns

Non-zero value if an error occurred or QUVI_LAST, otherwise QUVI_OK.

See Also

quvi_getprop

Example

Error handling omitted for brewity.

quvi_media_t m;
char *url;
quvi_t q;

quvi_init(&q);
quvi_parse(q, URL, &m);
do
  {
    quvi_getprop(m, QUVIPROP_MEDIAURL, &url);
    puts(url);
  }
while (quvi_next_media_url(media) == QUVI_OK);
quvi_parse_close(&m);
quvi_close(&q);

QUVIcode quvi_supported( quvi_t  session, char  * url )

Checks whether library supports the URL.  Does not require an Internet connection.  Shortened URLs will fail with this function.

Parameters

Returns

Non-zero value if an error occurred or QUVI_NOSUPPORT, otherwise QUVI_OK.

See Also

quvi_supported_ident

QUVIcode quvi_supported_ident( quvi_t  session, char  * url, quvi_ident_t  * ident )

Otherwise identical to quvi_supported but returns the `ident’ data.

Parameters

Returns

Non-zero value if an error occurred.

See Also

• quvi_ident_getprop
• quvi_supported_ident_close

Example

Error handling omitted for brewity.

quvi_ident_t ident;
quvi_t q;

quvi_init(&q);
if (quvi_supported_ident(q, URL, &ident) == QUVI_OK)
  {
    char *formats;
    quvi_ident_getprop(ident, QUVI_IDENT_PROPERTY_FORMATS, &formats);
    puts(formats);
    quvi_supported_ident_close(&ident);
  }
quvi_close(&q);

void quvi_supported_ident_close( quvi_ident_t  * handle )

Releases a previously allocated ident handle.

Parameters

See Also

quvi_supported_ident

QUVIcode quvi_ident_getprop( quvi_ident_t  ident, QUVIidentProperty  property,   ... )

Returns an ident property.

Parameters

Returns

Non-zero value if an error occurred.

See Also

quvi_supported_ident

QUVIcode quvi_next_supported_website( quvi_t  session, char  ** domain, char  ** formats )

Returns the next supported website.

Parameters

Returns

Non-zero value if an error occurred or QUVI_LAST, otherwise QUVI_OK.

char *quvi_strerror( quvi_t  session, QUVIcode  code )

Returns a corresponding error message to the return code.

Parameters

Returns

A null-terminated string.  Do not attempt to quvi_free it.

char *quvi_version( QUVIversion  id )

Returns a quvi version string.

Parameters

Returns

A null-terminated string.  Do not attempt to quvi_free it.

void quvi_free( void  * pointer )

Frees allocated memory.

Parameters