GDataMediaContent

GDataMediaContent — Media RSS content element

Stability Level

Stable, unless otherwise indicated

Object Hierarchy

    GEnum
    ├── GDataMediaExpression
    ╰── GDataMediaMedium
    GObject
    ╰── GDataParsable
        ╰── GDataMediaContent
            ╰── GDataYouTubeContent

Includes

#include <gdata/media/gdata-media-content.h>

Description

GDataMediaContent represents a "content" element from the

Media RSS specification.

The class only implements parsing, not XML output, at the moment.

Functions

gdata_media_content_get_uri ()

const gchar *
gdata_media_content_get_uri (GDataMediaContent *self);

Gets the “uri” property.

Parameters

self

a GDataMediaContent

 

Returns

the content's URI

Since 0.4.0


gdata_media_content_get_filesize ()

gsize
gdata_media_content_get_filesize (GDataMediaContent *self);

Gets the “filesize” property.

Parameters

self

a GDataMediaContent

 

Returns

the number of bytes in the content, or 0

Since 0.4.0


gdata_media_content_get_content_type ()

const gchar *
gdata_media_content_get_content_type (GDataMediaContent *self);

Gets the “content-type” property.

Parameters

self

a GDataMediaContent

 

Returns

the content's content (MIME) type, or NULL

Since 0.4.0


gdata_media_content_get_medium ()

GDataMediaMedium
gdata_media_content_get_medium (GDataMediaContent *self);

Gets the “medium” property.

Parameters

self

a GDataMediaContent

 

Returns

the type of the content, or GDATA_MEDIA_UNKNOWN

Since 0.4.0


gdata_media_content_is_default ()

gboolean
gdata_media_content_is_default (GDataMediaContent *self);

Gets the “is-default” property.

Parameters

self

a GDataMediaContent

 

Returns

TRUE if the GDataMediaContent is the default content for the media group, FALSE otherwise

Since 0.4.0


gdata_media_content_get_expression ()

GDataMediaExpression
gdata_media_content_get_expression (GDataMediaContent *self);

Gets the “expression” property.

Parameters

self

a GDataMediaContent

 

Returns

the content's expression, or GDATA_MEDIA_EXPRESSION_FULL

Since 0.4.0


gdata_media_content_get_duration ()

gint64
gdata_media_content_get_duration (GDataMediaContent *self);

Gets the “duration” property.

Parameters

self

a GDataMediaContent

 

Returns

the content's duration in seconds, or 0

Since 0.4.0


gdata_media_content_get_height ()

guint
gdata_media_content_get_height (GDataMediaContent *self);

Gets the “height” property.

Parameters

self

a GDataMediaContent

 

Returns

the content's height in pixels, or 0

Since 0.4.0


gdata_media_content_get_width ()

guint
gdata_media_content_get_width (GDataMediaContent *self);

Gets the “width” property.

Parameters

self

a GDataMediaContent

 

Returns

the content's width in pixels, or 0

Since 0.4.0


gdata_media_content_download ()

GDataDownloadStream *
gdata_media_content_download (GDataMediaContent *self,
                              GDataService *service,
                              GCancellable *cancellable,
                              GError **error);

Downloads and returns a GDataDownloadStream allowing the content represented by self to be read.

To get the content type of the downloaded data, gdata_download_stream_get_content_type() can be called on the returned GDataDownloadStream. Calling gdata_download_stream_get_content_length() on the stream will not return a meaningful result, however, as the stream is encoded in chunks, rather than by content length.

In order to cancel the download, a GCancellable passed in to cancellable must be cancelled using g_cancellable_cancel(). Cancelling the individual GInputStream operations on the GDataDownloadStream will not cancel the entire download; merely the read or close operation in question. See the “cancellable” for more details.

Parameters

self

a GDataMediaContent

 

service

the GDataService

 

cancellable

a GCancellable for the entire download stream, or NULL.

[allow-none]

error

a GError, or NULL

 

Returns

a GDataDownloadStream to download the content with, or NULL; unref with g_object_unref().

[transfer full]

Since 0.8.0

Types and Values

GDataMediaContent

typedef struct _GDataMediaContent GDataMediaContent;

All the fields in the GDataMediaContent structure are private and should never be accessed directly.


GDataMediaContentClass

typedef struct {
} GDataMediaContentClass;

All the fields in the GDataMediaContentClass structure are private and should never be accessed directly.

Since 0.4.0


enum GDataMediaMedium

An enum representing the possible values of “medium”.

Members

GDATA_MEDIA_UNKNOWN

the type of the media is unknown

 

GDATA_MEDIA_IMAGE

the media is an image

 

GDATA_MEDIA_AUDIO

the media is an audio stream

 

GDATA_MEDIA_VIDEO

the media is a video

 

GDATA_MEDIA_DOCUMENT

the media is another type of document

 

GDATA_MEDIA_EXECUTABLE

the media is an executable file

 

Since 0.4.0


enum GDataMediaExpression

An enum representing the possible values of “expression”.

Members

GDATA_MEDIA_EXPRESSION_SAMPLE

the media is a sample of a larger video

 

GDATA_MEDIA_EXPRESSION_FULL

the media is the full version

 

GDATA_MEDIA_EXPRESSION_NONSTOP

the media is a continuous stream

 

Property Details

The “content-type” property

  “content-type”             gchar *

The standard MIME type of the object.

For more information, see the Media RSS specification.

Flags: Read

Default value: NULL

Since 0.4.0


The “duration” property

  “duration”                 gint64

The number of seconds for which the media object plays.

For more information, see the Media RSS specification.

Flags: Read

Allowed values: >= 0

Default value: 0

Since 0.4.0


The “expression” property

  “expression”               GDataMediaExpression

Determines if the object is a sample or the full version of the object, or even if it is a continuous stream.

For more information, see the Media RSS specification.

Flags: Read

Default value: GDATA_MEDIA_EXPRESSION_FULL

Since 0.4.0


The “filesize” property

  “filesize”                 gulong

The number of bytes of the media object.

For more information, see the Media RSS specification.

Flags: Read

Since 0.4.0


The “height” property

  “height”                   guint

The height of the media object.

For more information, see the Media RSS specification.

Flags: Read

Default value: 0

Since 0.4.0


The “is-default” property

  “is-default”               gboolean

Determines if this is the default content for the media group. There should only be one default object per media group.

For more information, see the Media RSS specification.

Flags: Read

Default value: FALSE

Since 0.4.0


The “medium” property

  “medium”                   GDataMediaMedium

The type of object, complementing “content-type”. It allows the consuming application to make simpler decisions between different content objects, based on whether they're a video or audio stream, for example.

For more information, see the Media RSS specification.

Flags: Read

Default value: GDATA_MEDIA_UNKNOWN

Since 0.4.0


The “uri” property

  “uri”                      gchar *

The direct URI to the media object.

For more information, see the Media RSS specification.

Flags: Read

Default value: NULL

Since 0.4.0


The “width” property

  “width”                    guint

The width of the media object.

For more information, see the Media RSS specification.

Flags: Read

Default value: 0

Since 0.4.0