## Implementing Renderer Plugins: Simple Example

This example source code shows how to implement a Rygel Renderer plugin.

This example implements module that provides a RygelMediaPlayer that simply prints the addresses of any URIs provided to it by a UPnP/DLNA controller. A real Rygel renderer plugin's player would render the actual media content to some device. See, for instance, the RygelPlaybinPlayer from the librygel-renderer-gst library, used in the Rygel Playbin plugin.

    /*
     * Copyright (C) 2012 Intel Corporation
     *
     * This file is part of Rygel.
     *
     * Rygel is free software; you can redistribute it and/or modify
     * it under the terms of the GNU Lesser General Public License as published by
     * the Free Software Foundation; either version 2 of the License, or
     * (at your option) any later version.
     *
     * Rygel is distributed in the hope that it will be useful,
     * but WITHOUT ANY WARRANTY; without even the implied warranty of
     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     * GNU Lesser General Public License for more details.
     *
     * You should have received a copy of the GNU Lesser General Public License
     * along with this program; if not, write to the Free Software Foundation,
     * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
     */

    #ifndef __RYGEL_EXAMPLE_RENDERER_PLUGIN_H__
    #define __RYGEL_EXAMPLE_RENDERER_PLUGIN_H__

    #include <glib.h>
    #include <glib-object.h>
    #include <rygel-renderer.h>

    G_BEGIN_DECLS

    #define RYGEL_EXAMPLE_TYPE_RENDERER_PLUGIN (rygel_example_renderer_plugin_get_type ())
    #define RYGEL_EXAMPLE_RENDERER_PLUGIN(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), RYGEL_EXAMPLE_TYPE_RENDERER_PLUGIN, RygelExampleRendererPlugin))
    #define RYGEL_EXAMPLE_RENDERER_PLUGIN_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), RYGEL_EXAMPLE_TYPE_RENDERER_PLUGIN, RygelExampleRendererPluginClass))
    #define RYGEL_EXAMPLE_IS_RENDERER_PLUGIN(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), RYGEL_EXAMPLE_TYPE_RENDERER_PLUGIN))
    #define RYGEL_EXAMPLE_IS_RENDERER_PLUGIN_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), RYGEL_EXAMPLE_TYPE_RENDERER_PLUGIN))
    #define RYGEL_EXAMPLE_RENDERER_PLUGIN_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), RYGEL_EXAMPLE_TYPE_RENDERER_PLUGIN, RygelExampleRendererPluginClass))

    typedef struct _RygelExampleRendererPlugin RygelExampleRendererPlugin;
    typedef struct _RygelExampleRendererPluginClass RygelExampleRendererPluginClass;
    typedef struct _RygelExampleRendererPluginPrivate RygelExampleRendererPluginPrivate;

    struct _RygelExampleRendererPlugin {
      RygelMediaRendererPlugin parent_instance;
      RygelExampleRendererPluginPrivate * priv;
    };

    struct _RygelExampleRendererPluginClass {
      RygelMediaRendererPluginClass parent_class;
    };

    GType rygel_example_renderer_plugin_get_type (void) G_GNUC_CONST;

    RygelExampleRendererPlugin* rygel_example_renderer_plugin_new (void);

    void module_init (RygelPluginLoader* loader);

    G_END_DECLS

    #endif /* __RYGEL_EXAMPLE_RENDERER_PLUGIN_H__ */

    /*
     * Copyright (C) 2012 Intel Corporation
     *
     * This file is part of Rygel.
     *
     * Rygel is free software; you can redistribute it and/or modify
     * it under the terms of the GNU Lesser General Public License as published by
     * the Free Software Foundation; either version 2 of the License, or
     * (at your option) any later version.
     *
     * Rygel is distributed in the hope that it will be useful,
     * but WITHOUT ANY WARRANTY; without even the implied warranty of
     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     * GNU Lesser General Public License for more details.
     *
     * You should have received a copy of the GNU Lesser General Public License
     * along with this program; if not, write to the Free Software Foundation,
     * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
     */

    #include "example-renderer-plugin.h"
    #include "example-player.h"

    #define RYGEL_EXAMPLE_RENDERER_PLUGIN_NAME "ExampleRendererPluginC"

    enum  {
      RYGEL_EXAMPLE_RENDERER_PLUGIN_DUMMY_PROPERTY
    };

    #define RYGEL_EXAMPLE_RENDERER_PLUGIN_TITLE "Example Render Plugin C"
    #define RYGEL_EXAMPLE_RENDERER_PLUGIN_DESCRIPTION "An example Rygel renderer plugin implemented in C."

    G_DEFINE_TYPE (RygelExampleRendererPlugin, rygel_example_renderer_plugin, RYGEL_TYPE_MEDIA_RENDERER_PLUGIN)

    static RygelExamplePlayer *player;

    void
    module_init (RygelPluginLoader* loader) {
      RygelExampleRendererPlugin* plugin;

      g_return_if_fail (loader != NULL);

      if (rygel_plugin_loader_plugin_disabled (loader, RYGEL_EXAMPLE_RENDERER_PLUGIN_NAME)) {
        g_message ("Plugin '%s' disabled by user. Ignoring.",
          RYGEL_EXAMPLE_RENDERER_PLUGIN_NAME);
        return;
      }

      plugin = rygel_example_renderer_plugin_new ();
      rygel_plugin_loader_add_plugin (loader, RYGEL_PLUGIN (plugin));
      g_object_unref (plugin);
    }

    static RygelExampleRendererPlugin*
    rygel_example_renderer_plugin_construct (GType object_type) {
      RygelExampleRendererPlugin *self;

      self = (RygelExampleRendererPlugin*) rygel_media_renderer_plugin_construct (object_type,
        RYGEL_EXAMPLE_RENDERER_PLUGIN_NAME, NULL, RYGEL_EXAMPLE_RENDERER_PLUGIN_DESCRIPTION,
        RYGEL_PLUGIN_CAPABILITIES_NONE);

      return self;
    }

    RygelExampleRendererPlugin*
    rygel_example_renderer_plugin_new (void) {
      return rygel_example_renderer_plugin_construct (RYGEL_EXAMPLE_TYPE_RENDERER_PLUGIN);
    }

    static RygelMediaPlayer *
    rygel_example_renderer_plugin_get_player (RygelMediaRendererPlugin* plugin)
    {
        if (player == NULL) {
            player = rygel_example_player_new ();
        }

        return RYGEL_EXAMPLE_PLAYER (g_object_ref (player));
    }

    static void
    rygel_example_renderer_plugin_class_init (RygelExampleRendererPluginClass *klass) {
        RygelMediaRendererPluginClass *plugin_class;

        plugin_class = RYGEL_EXAMPLE_RENDERER_PLUGIN_CLASS (klass);
        plugin_class->get_player = rygel_example_renderer_plugin_get_player;
    }

    static void
    rygel_example_renderer_plugin_init (RygelExampleRendererPlugin *self) {
    }

    /*
     * Copyright (C) 2012 Intel Corporation
     *
     * This file is part of Rygel.
     *
     * Rygel is free software; you can redistribute it and/or modify
     * it under the terms of the GNU Lesser General Public License as published by
     * the Free Software Foundation; either version 2 of the License, or
     * (at your option) any later version.
     *
     * Rygel is distributed in the hope that it will be useful,
     * but WITHOUT ANY WARRANTY; without even the implied warranty of
     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     * GNU Lesser General Public License for more details.
     *
     * You should have received a copy of the GNU Lesser General Public License
     * along with this program; if not, write to the Free Software Foundation,
     * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
     */

    #ifndef __RYGEL_EXAMPLE_PLAYER_H__
    #define __RYGEL_EXAMPLE_PLAYER_H__

    #include <glib.h>
    #include <glib-object.h>
    #include <rygel-renderer.h>

    G_BEGIN_DECLS

    #define RYGEL_EXAMPLE_TYPE_PLAYER (rygel_example_player_get_type ())
    #define RYGEL_EXAMPLE_PLAYER(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), RYGEL_EXAMPLE_TYPE_PLAYER, RygelExamplePlayer))
    #define RYGEL_EXAMPLE_PLAYER_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), RYGEL_EXAMPLE_TYPE_PLAYER, RygelExamplePlayerClass))
    #define RYGEL_EXAMPLE_IS_PLAYER(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), RYGEL_EXAMPLE_TYPE_PLAYER))
    #define RYGEL_EXAMPLE_IS_PLAYER_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), RYGEL_EXAMPLE_TYPE_PLAYER))
    #define RYGEL_EXAMPLE_PLAYER_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), RYGEL_EXAMPLE_TYPE_PLAYER, RygelExamplePlayerClass))

    typedef struct _RygelExamplePlayer RygelExamplePlayer;
    typedef struct _RygelExamplePlayerClass RygelExamplePlayerClass;
    typedef struct _RygelExamplePlayerPrivate RygelExamplePlayerPrivate;

    struct _RygelExamplePlayer {
      GObject parent_instance;
      RygelExamplePlayerPrivate * priv;
    };

    struct _RygelExamplePlayerClass {
      GObjectClass parent_class;
    };

    GType rygel_example_player_get_type (void) G_GNUC_CONST;

    RygelExamplePlayer* rygel_example_player_new (void);

    G_END_DECLS

    #endif /* __RYGEL_EXAMPLE_PLAYER_H__ */

    /*
     * Copyright (C) 2012 Intel Corporation
     *
     * This file is part of Rygel.
     *
     * Rygel is free software; you can redistribute it and/or modify
     * it under the terms of the GNU Lesser General Public License as published by
     * the Free Software Foundation; either version 2 of the License, or
     * (at your option) any later version.
     *
     * Rygel is distributed in the hope that it will be useful,
     * but WITHOUT ANY WARRANTY; without even the implied warranty of
     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     * GNU Lesser General Public License for more details.
     *
     * You should have received a copy of the GNU Lesser General Public License
     * along with this program; if not, write to the Free Software Foundation,
     * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
     */

    #include "example-player.h"

    enum  {
      RYGEL_EXAMPLE_PLAYER_DUMMY_PROPERTY,
      RYGEL_EXAMPLE_PLAYER_PLAYBACK_STATE,
      RYGEL_EXAMPLE_PLAYER_URI,
      RYGEL_EXAMPLE_PLAYER_MIME_TYPE,
      RYGEL_EXAMPLE_PLAYER_CAN_SEEK,
      RYGEL_EXAMPLE_PLAYER_METADATA,
      RYGEL_EXAMPLE_PLAYER_CONTENT_FEATURES,
      RYGEL_EXAMPLE_PLAYER_VOLUME,
      RYGEL_EXAMPLE_PLAYER_DURATION,
      RYGEL_EXAMPLE_PLAYER_POSITION,
      RYGEL_EXAMPLE_PLAYER_PLAYBACK_SPEED,
      RYGEL_EXAMPLE_PLAYER_ALLOWED_PLAYBACK_SPEEDS
    };

    static void rygel_example_player_rygel_media_player_interface_init (RygelMediaPlayerIface  *iface);

    static gboolean
    rygel_example_player_real_seek (RygelMediaPlayer *base, gint64 time);

    static gchar**
    rygel_example_player_real_get_protocols (RygelMediaPlayer *base, int *result_length1);

    static gchar**
    rygel_example_player_real_get_mime_types (RygelMediaPlayer *base, int *result_length1);

    static gchar*
    rygel_example_player_real_get_playback_state (RygelMediaPlayer *base);

    static void
    rygel_example_player_real_set_playback_state (RygelMediaPlayer *base, const gchar *value);

    static gchar*
    rygel_example_player_real_get_uri (RygelMediaPlayer *base);

    static void
    rygel_example_player_real_set_uri (RygelMediaPlayer *base, const gchar *value);

    static gchar*
    rygel_example_player_real_get_mime_type (RygelMediaPlayer *base);

    static void
    rygel_example_player_real_set_mime_type (RygelMediaPlayer *base, const gchar *value);

    static gchar*
    rygel_example_player_real_get_metadata (RygelMediaPlayer *base);

    static void
    rygel_example_player_real_set_metadata (RygelMediaPlayer *base, const gchar *value);

    static gchar*
    rygel_example_player_real_get_content_features (RygelMediaPlayer *base);

    static void
    rygel_example_player_real_set_content_features (RygelMediaPlayer *base, const gchar *value);

    static gdouble
    rygel_example_player_real_get_volume (RygelMediaPlayer *base);

    static void
    rygel_example_player_real_set_volume (RygelMediaPlayer *base, gdouble value);

    static gint64
    rygel_example_player_real_get_duration (RygelMediaPlayer *base);

    static gint64
    rygel_example_player_real_get_position (RygelMediaPlayer *base);

    static gboolean
    rygel_example_player_real_get_can_seek (RygelMediaPlayer *base);

    static gchar **
    rygel_example_player_real_get_allowed_playback_speeds (RygelMediaPlayer *base, int *length);

    static void
    rygel_example_player_real_set_playback_speed (RygelMediaPlayer *base, const char *speed);

    static gchar *
    rygel_example_player_real_get_playback_speed (RygelMediaPlayer *base);

    static void
    _rygel_example_player_get_property (GObject *object, guint property_id, GValue *value, GParamSpec *pspec);

    static void
    _rygel_example_player_set_property (GObject *object, guint property_id, const GValue *value, GParamSpec *pspec);

    static void
    rygel_example_player_finalize (GObject *obj);

    G_DEFINE_TYPE_WITH_CODE (RygelExamplePlayer, rygel_example_player, G_TYPE_OBJECT,
                             G_IMPLEMENT_INTERFACE (RYGEL_TYPE_MEDIA_PLAYER,
                                                    rygel_example_player_rygel_media_player_interface_init))

    struct _RygelExamplePlayerPrivate {
      gchar *_playback_state;
      gchar *_uri;
      gchar *_mime_type;
      gchar *_metadata;
      gchar *_content_features;
      gdouble _volume;
      gint64 _duration;
      gint64 _position;
      gchar *playback_speed;
    };

    static const gchar* RYGEL_EXAMPLE_PLAYER_PROTOCOLS[] = {"http-get", NULL};
    static const gchar* RYGEL_EXAMPLE_PLAYER_MIME_TYPES[] = {"image/jpeg", "image/png", NULL};

    RygelExamplePlayer*
    rygel_example_player_new (void) {
        return g_object_new (RYGEL_EXAMPLE_TYPE_PLAYER, NULL);
    }

    static void
    rygel_example_player_rygel_media_player_interface_init (RygelMediaPlayerIface *iface) {
      iface->seek = (gboolean (*)(RygelMediaPlayer*, gint64)) rygel_example_player_real_seek;
      iface->get_protocols = (gchar **(*)(RygelMediaPlayer*, int*)) rygel_example_player_real_get_protocols;
      iface->get_mime_types = (gchar **(*)(RygelMediaPlayer*, int*)) rygel_example_player_real_get_mime_types;
      iface->get_playback_state = rygel_example_player_real_get_playback_state;
      iface->set_playback_state = rygel_example_player_real_set_playback_state;
      iface->get_uri = rygel_example_player_real_get_uri;
      iface->set_uri = rygel_example_player_real_set_uri;
      iface->get_mime_type = rygel_example_player_real_get_mime_type;
      iface->set_mime_type = rygel_example_player_real_set_mime_type;
      iface->get_metadata = rygel_example_player_real_get_metadata;
      iface->set_metadata = rygel_example_player_real_set_metadata;
      iface->get_content_features = rygel_example_player_real_get_content_features;
      iface->set_content_features = rygel_example_player_real_set_content_features;
      iface->get_volume = rygel_example_player_real_get_volume;
      iface->set_volume = rygel_example_player_real_set_volume;
      iface->get_duration = rygel_example_player_real_get_duration;
      iface->get_position = rygel_example_player_real_get_position;
      iface->get_can_seek = rygel_example_player_real_get_can_seek;
      iface->get_allowed_playback_speeds = rygel_example_player_real_get_allowed_playback_speeds;
      iface->get_playback_speed = rygel_example_player_real_get_playback_speed;
      iface->set_playback_speed = rygel_example_player_real_set_playback_speed;
    }

    static void
    rygel_example_player_class_init (RygelExamplePlayerClass *klass) {
      GObjectClass *gobject_class = G_OBJECT_CLASS (klass);

      g_type_class_add_private (gobject_class, sizeof (RygelExamplePlayerPrivate));

      gobject_class->get_property = _rygel_example_player_get_property;
      gobject_class->set_property = _rygel_example_player_set_property;
      gobject_class->finalize = rygel_example_player_finalize;

      g_object_class_install_property (gobject_class,
        RYGEL_EXAMPLE_PLAYER_PLAYBACK_STATE,
        g_param_spec_string ("playback-state",
          "playback-state",
          "playback-state",
          NULL,
          G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB | G_PARAM_READABLE | G_PARAM_WRITABLE));

      g_object_class_install_property (gobject_class,
        RYGEL_EXAMPLE_PLAYER_URI,
        g_param_spec_string ("uri",
          "uri",
          "uri",
          NULL,
          G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB | G_PARAM_READABLE | G_PARAM_WRITABLE));

      g_object_class_install_property (gobject_class,
        RYGEL_EXAMPLE_PLAYER_MIME_TYPE,
        g_param_spec_string ("mime-type",
          "mime-type",
          "mime-type",
          NULL,
          G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB | G_PARAM_READABLE | G_PARAM_WRITABLE));

      g_object_class_install_property (gobject_class,
        RYGEL_EXAMPLE_PLAYER_METADATA,
        g_param_spec_string ("metadata",
          "metadata",
          "metadata",
          NULL,
          G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB | G_PARAM_READABLE | G_PARAM_WRITABLE));

      g_object_class_install_property (gobject_class,
        RYGEL_EXAMPLE_PLAYER_CAN_SEEK,
        g_param_spec_boolean ("can-seek",
          "can-seek",
          "can-seek",
          FALSE,
          G_PARAM_STATIC_STRINGS | G_PARAM_READABLE));

      g_object_class_install_property (gobject_class,
        RYGEL_EXAMPLE_PLAYER_CONTENT_FEATURES,
        g_param_spec_string ("content-features",
          "content-features",
          "content-features",
          NULL,
          G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB | G_PARAM_READABLE | G_PARAM_WRITABLE));

      g_object_class_install_property (gobject_class,
        RYGEL_EXAMPLE_PLAYER_VOLUME,
        g_param_spec_double ("volume",
          "volume",
          "volume",
          -G_MAXDOUBLE,
          G_MAXDOUBLE,
          0.0,
          G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB | G_PARAM_READABLE | G_PARAM_WRITABLE));

      g_object_class_install_property (gobject_class,
        RYGEL_EXAMPLE_PLAYER_DURATION,
        g_param_spec_int64 ("duration",
          "duration",
          "duration",
          G_MININT64,
          G_MAXINT64,
          0,
          G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB | G_PARAM_READABLE));

      g_object_class_install_property (gobject_class,
        RYGEL_EXAMPLE_PLAYER_POSITION,
        g_param_spec_int64 ("position",
          "position",
          "position",
          G_MININT64,
          G_MAXINT64,
          0,
          G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB | G_PARAM_READABLE));

      g_object_class_install_property (gobject_class,
        RYGEL_EXAMPLE_PLAYER_PLAYBACK_SPEED,
        g_param_spec_string ("playback-speed",
          "playback-speed",
          "playback-speed",
          "1",
          G_PARAM_STATIC_STRINGS | G_PARAM_READWRITE));

      g_object_class_install_property (gobject_class,
        RYGEL_EXAMPLE_PLAYER_ALLOWED_PLAYBACK_SPEEDS,
        g_param_spec_boxed ("allowed-playback-speeds",
          "allowed-playback-speeds",
          "allowed-playback-speeds",
          G_TYPE_STRV,
          G_PARAM_STATIC_STRINGS | G_PARAM_READABLE));
    }

    static void
    rygel_example_player_init (RygelExamplePlayer *self) {
      self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self,
                                                RYGEL_EXAMPLE_TYPE_PLAYER,
                                                RygelExamplePlayerPrivate);

      self->priv->_playback_state = g_strdup ("NO_MEDIA_PRESENT");
      self->priv->_uri = NULL;
      self->priv->_mime_type = NULL;
      self->priv->_metadata = NULL;
      self->priv->_content_features = NULL;
      self->priv->_volume = 0;
      self->priv->_duration = 0;
      self->priv->_position = 0;
      self->priv->playback_speed = g_strdup ("1");
    }

    static gboolean
    rygel_example_player_real_seek (RygelMediaPlayer *base, gint64 time) {
      /* RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base); */
      return FALSE;
    }

    static gchar**
    rygel_example_player_real_get_protocols (RygelMediaPlayer *base, int *result_length) {
      /* RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base); */

      if (result_length) {
        *result_length = g_strv_length (RYGEL_EXAMPLE_PLAYER_PROTOCOLS);
      }

      return g_strdupv (RYGEL_EXAMPLE_PLAYER_PROTOCOLS);
    }

    static gchar**
    rygel_example_player_real_get_mime_types (RygelMediaPlayer *base, int *result_length) {
      /* RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base); */

      if (result_length) {
        *result_length = g_strv_length (RYGEL_EXAMPLE_PLAYER_MIME_TYPES);
      }

      return g_strdupv (RYGEL_EXAMPLE_PLAYER_MIME_TYPES);
    }

    static gchar*
    rygel_example_player_real_get_playback_state (RygelMediaPlayer *base) {
      RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base);

      return g_strdup (self->priv->_playback_state);
    }

    static void
    rygel_example_player_real_set_playback_state (RygelMediaPlayer *base, const gchar *value) {
      RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base);

      g_free (self->priv->_playback_state);
      self->priv->_playback_state = g_strdup (value);

      g_object_notify (G_OBJECT (self), "playback-state");
    }

    static gchar*
    rygel_example_player_real_get_uri (RygelMediaPlayer *base) {
      RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base);

      return g_strdup (self->priv->_uri);
    }

    static void
    rygel_example_player_real_set_uri (RygelMediaPlayer *base, const gchar *value) {
      RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base);

      g_free (self->priv->_uri);
      self->priv->_uri = g_strdup (value);

      g_debug ("URI set to %s.", value);
      g_object_notify (G_OBJECT (self), "uri");
    }

    static gchar*
    rygel_example_player_real_get_mime_type (RygelMediaPlayer *base) {
      RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base);

      return g_strdup (self->priv->_mime_type);
    }

    static void
    rygel_example_player_real_set_mime_type (RygelMediaPlayer *base, const gchar *value) {
      RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base);

      g_free (self->priv->_mime_type);
      self->priv->_mime_type = g_strdup (value);

      g_object_notify (G_OBJECT (self), "mime-type");
    }

    static gchar*
    rygel_example_player_real_get_metadata (RygelMediaPlayer *base) {
      RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base);

      return g_strdup (self->priv->_metadata);
    }

    static void
    rygel_example_player_real_set_metadata (RygelMediaPlayer *base, const gchar *value) {
      RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base);

      g_free (self->priv->_mime_type);
      self->priv->_mime_type = g_strdup (value);

      g_object_notify (G_OBJECT (self), "metadata");
    }

    static gchar*
    rygel_example_player_real_get_content_features (RygelMediaPlayer *base) {
      RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base);

      return g_strdup (self->priv->_content_features);
    }

    static void
    rygel_example_player_real_set_content_features (RygelMediaPlayer *base, const gchar *value) {
      RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base);

      g_free (self->priv->_content_features);
      self->priv->_content_features = g_strdup (value);

      g_object_notify (G_OBJECT (self), "content-features");
    }

    static gdouble
    rygel_example_player_real_get_volume (RygelMediaPlayer *base) {
      RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base);

      return self->priv->_volume;
    }

    static void
    rygel_example_player_real_set_volume (RygelMediaPlayer *base, gdouble value) {
      RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base);

      self->priv->_volume = value;

      g_debug ("volume set to %f.", value);
      g_object_notify (G_OBJECT (self), "volume");
    }

    static gint64
    rygel_example_player_real_get_duration (RygelMediaPlayer *base) {
      RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base);

      return self->priv->_duration;
    }

    static gint64
    rygel_example_player_real_get_position (RygelMediaPlayer *base) {
      RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base);

      return self->priv->_position;
    }

    static gboolean
    rygel_example_player_real_get_can_seek (RygelMediaPlayer *base) {
        return FALSE;
    }

    static gchar **
    rygel_example_player_real_get_allowed_playback_speeds (RygelMediaPlayer *base, int *length)
    {
        if (length != NULL) {
            *length = 6;
        }

        return g_strsplit ("-1,-1/2,1/2,1,2,4", ",", -1);
    }

    static void
    rygel_example_player_real_set_playback_speed (RygelMediaPlayer *base,
                                                  const char *speed)
    {
      RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base);

      if (self->priv->playback_speed != NULL) {
        g_free (self->priv->playback_speed);
      }

      self->priv->playback_speed = g_strdup (speed);

      g_object_notify (G_OBJECT (self), "playback-speed");
    }

    static gchar *
    rygel_example_player_real_get_playback_speed (RygelMediaPlayer *base)
    {
      RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (base);

      return g_strdup (self->priv->playback_speed);
    }

    static void
    _rygel_example_player_get_property (GObject *object, guint property_id, GValue *value, GParamSpec *pspec) {
      RygelMediaPlayer *base = RYGEL_MEDIA_PLAYER (object);

      switch (property_id) {
        case RYGEL_EXAMPLE_PLAYER_PLAYBACK_STATE:
          g_value_take_string (value, rygel_media_player_get_playback_state (base));
          break;
        case RYGEL_EXAMPLE_PLAYER_URI:
          g_value_take_string (value, rygel_media_player_get_uri (base));
          break;
        case RYGEL_EXAMPLE_PLAYER_MIME_TYPE:
          g_value_take_string (value, rygel_media_player_get_mime_type (base));
          break;
        case RYGEL_EXAMPLE_PLAYER_METADATA:
          g_value_take_string (value, rygel_media_player_get_metadata (base));
          break;
        case RYGEL_EXAMPLE_PLAYER_CONTENT_FEATURES:
          g_value_take_string (value, rygel_media_player_get_content_features (base));
          break;
        case RYGEL_EXAMPLE_PLAYER_VOLUME:
          g_value_set_double (value, rygel_media_player_get_volume (base));
          break;
        case RYGEL_EXAMPLE_PLAYER_DURATION:
          g_value_set_int64 (value, rygel_media_player_get_duration (base));
          break;
        case RYGEL_EXAMPLE_PLAYER_POSITION:
          g_value_set_int64 (value, rygel_media_player_get_position (base));
          break;
        case RYGEL_EXAMPLE_PLAYER_CAN_SEEK:
          g_value_set_boolean (value, rygel_media_player_get_can_seek (base));
          break;
        case RYGEL_EXAMPLE_PLAYER_PLAYBACK_SPEED:
          g_value_take_string (value, rygel_media_player_get_playback_speed (base));
          break;
        case RYGEL_EXAMPLE_PLAYER_ALLOWED_PLAYBACK_SPEEDS:
          {
            int length;

            g_value_take_boxed (value, rygel_media_player_get_allowed_playback_speeds (base, &length));
          }
          break;
        default:
          G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
          break;
      }
    }

    static void
    _rygel_example_player_set_property (GObject *object, guint property_id, const GValue *value, GParamSpec *pspec) {
      RygelMediaPlayer *base = RYGEL_MEDIA_PLAYER (object);

      switch (property_id) {
        case RYGEL_EXAMPLE_PLAYER_PLAYBACK_STATE:
          rygel_media_player_set_playback_state (base, g_value_get_string (value));
          break;
        case RYGEL_EXAMPLE_PLAYER_URI:
          rygel_media_player_set_uri (base, g_value_get_string (value));
          break;
        case RYGEL_EXAMPLE_PLAYER_MIME_TYPE:
          rygel_media_player_set_mime_type (base, g_value_get_string (value));
          break;
        case RYGEL_EXAMPLE_PLAYER_METADATA:
          rygel_media_player_set_metadata (base, g_value_get_string (value));
          break;
        case RYGEL_EXAMPLE_PLAYER_CONTENT_FEATURES:
          rygel_media_player_set_content_features (base, g_value_get_string (value));
          break;
        case RYGEL_EXAMPLE_PLAYER_VOLUME:
          rygel_media_player_set_volume (base, g_value_get_double (value));
          break;
        case RYGEL_EXAMPLE_PLAYER_PLAYBACK_SPEED:
          rygel_media_player_set_playback_speed (base, g_value_get_string (value));
          break;
        default:
          G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
          break;
      }
    }

    static void
    rygel_example_player_finalize (GObject *obj) {
      RygelExamplePlayer *self = RYGEL_EXAMPLE_PLAYER (obj);

      g_free (self->priv->_playback_state);
      g_free (self->priv->_uri);
      g_free (self->priv->_mime_type);
      g_free (self->priv->_metadata);
      g_free (self->priv->_content_features);

      G_OBJECT_CLASS (rygel_example_player_parent_class)->finalize (obj);
    }