# Complementos de Grilo

Murray Cumming

Grilo es un entorno de trabajo para examinar y buscar contenido multimedia de varias fuentes usando una única API. Los complementos de Grilo para el entorno de trabajo proporcionan acceso a varias fuentes de medios y metadatos.

2012 Openismus GmbH

Se concede permiso para copiar, distribuir o modificar este documento según las condiciones de la GNU Free documentation License (GFDL), Versión 1.2 o cualquier versión posterior publicada por la Free Software Foundation sin Secciones invariantes, Textos de portada y Textos de contraportada. Encontrará una copia de la GFDL visitando su página web o escribiendo a: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301, USA.

Daniel Mustieles daniel.musiteles@gmail.com
2018 2020 Daniel Mustieles

## Introducción

Grilo es un entorno de trabajo para examinar y buscar contenido multimedia de varias fuentes usando una única API. Los complementos de Grilo para el entorno de trabajo proporcionan acceso a varias fuentes de medios y metadatos.

## Complementos de Grilo

### Tráilers de Apple

Esto es un complemento para los tráilers de Apple. El ID de este complemento es `"grl-apple-trailers"`

### Marcadores

Esto es un complemento para los marcadores. El ID de este complemento es `"grl-bookmarks"`

### DMap

Esto es un complemento para DMap. El ID de este complemento es `"grl-dmap"`

### Sistema de archivos

Esto es un complemento para el sistema de archivos. El ID de este complemento es `"grl-filesystem"`

### Flickr

Esto es un complemento para Flickr. El ID de este complemento es `"grl-flickr"`

### Gravatar

Esto es un complemento de Grilo para Gravatar. El ID de este complemento es `"grl-gravatar"`

### Jamendo

Esto es un complemento para Jamendo. El ID de este complemento es `"grl-jamendo"`

### Metadatos locales

Esto es un complemento para metadatos locales. El ID de este complemento es `"grl-local-metadata"`

### Almacén de metadatos

Esto es un complemento para almacén de metadatos. El ID de este complemento es `"grl-metadata-store"`

### Soporte óptico

Esto es un complemento para soporte óptico. El ID de este complemento es `"grl-optical-media"`

### Podcasts

Esto es un complemento para podcasts. El ID de este complemento es `"grl-podcasts"`

### Shoutcast

Esto es un complemento de Grilo para Shoutcast. Su ID de complemento es `"grl-shoutcast"`

### Complemento TMDb

El complemento TMDb recupera información sobre películas desde el servicio en línea TMDb, que es una base de datos de películas mantenida por la comunidad. Su ID de complemento es `"grl-tmdb"`

Antes de usar este complemento debe establecer la clave de API TMDB con `grl_config_set_api_key()`.

Puede usar `grl_source_resolve()` para descubrir detalles sobre un GrlMediaItem existente.

Este complemento no soporta búsquedas mediante `grl_source_search()` o consultas mediante `grl_source_query()`.

Esto es un sencillo ejemplo de uso del complemento TMDb de Grilo:

Archivo: `example-tmdb.c`

    /*
     * Copyright (C) 2012 Canonical Ltd.
     *
     * Author: Jens Georg <jensg@openismus.com>
     *
     * This library 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; version 2.1 of
     * the License, or (at your option) any later version.
     *
     * This library 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 library; if not, write to the Free Software
     * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
     * 02110-1301 USA
     *
     */

    #include <grilo.h>
    #include <stdio.h>

    /**
     * This TMDB key is just for testing.
     * For real-world use, please request your own key from
     * http://api.themoviedb.org
     */
    #define TMDB_KEY "719b9b296835b04cd919c4bf5220828a"

    #define TMDB_PLUGIN_ID "grl-tmdb"

    GMainLoop *loop = NULL;
    GrlKeyID director_key = 0;

    static void
    resolve_cb (GrlSource *src, guint operation_id, GrlMedia *media, gpointer user_data, const GError *error)
    {
      const char *title, *studio;

      g_assert_no_error (error);
      g_assert (media);

      title = grl_media_get_title (media);
      studio = grl_media_get_studio (media);
      printf ("Media: Title='%s', Studio='%s'\n",
        title, studio);

      if (director_key != 0) {
        const gchar *director =
          grl_data_get_string (GRL_DATA (media), director_key);
        printf ("  Director=%s\n", director);
      }

      g_main_loop_quit (loop);
    }

    int main (int argc, char *argv[])
    {
      GrlRegistry *reg;
      GrlConfig *config;
      GError *error = NULL;
      GrlSource *src;
      gboolean plugin_activated;
      GrlCaps *caps;
      GrlOperationOptions *options;
      GrlMedia *media;
      const GList *keys;
      const GList* l;

      grl_init (&argc, &argv);

      /*
       * Set the TMDB API key:
       * You must use your own TMDB API key in your own application.
       */
      reg = grl_registry_get_default ();
      config = grl_config_new (TMDB_PLUGIN_ID, NULL);
      grl_config_set_api_key (config, TMDB_KEY);
      grl_registry_add_config (reg, config, NULL);
      grl_registry_load_all_plugins (reg, FALSE, NULL);

      /*
       * Get the plugin:
       */
      error = NULL;
      plugin_activated =
        grl_registry_activate_plugin_by_id (reg, TMDB_PLUGIN_ID, &error);
      g_assert (plugin_activated);
      g_assert_no_error (error);

      /*
       * Get the Grilo source:
       */
      src = grl_registry_lookup_source (reg, TMDB_PLUGIN_ID);

      /*
       * Check that it has the expected capability:
       */
      g_assert (grl_source_supported_operations (src) & GRL_OP_RESOLVE);
      caps = grl_source_get_caps (src, GRL_OP_RESOLVE);
      g_assert (caps);

      options = grl_operation_options_new (caps);

      /*
       * A media item that we will give to the TMDB plugin,
       * to discover its details.
       */
      media = grl_media_video_new ();
      grl_media_set_title (media, "Sherlock Holmes");

      /*
       * Discover what keys are provided by the source:
       */
      keys = grl_source_supported_keys (src);
      for (l = keys; l != NULL; l = l->next) {
        const gchar *name;
        GrlKeyID id = GPOINTER_TO_INT (l->data);

        g_assert (id);

        name = grl_metadata_key_get_name (id);
        printf ("Supported key: %s\n", name);

        /*
         * Remember this for later use:
         * You may instead use grl_registry_lookup_metadata_key_name().
         */
        if (g_strcmp0 (name, "tmdb-director") == 0) {
          director_key = id;
        }
      }

      /*
       * Ask the TMDB plugin for the media item's details,
       * from the TMDB online service:
       */
      grl_source_resolve (src, media,
        keys, options,
        resolve_cb, NULL);

      /*
       * Start the main loop so our callback can be called:
       */
      loop = g_main_loop_new (NULL, FALSE);
      g_main_loop_run (loop);

      /*
       * Release objects:
       */
      g_object_unref (media);
      g_object_unref (config);
      g_object_unref (options);

      /*
       * Deinitialize Grilo:
       */
      grl_deinit ();
    }

### Tracker

Esto es un complemento para Tracker. El ID de este complemento es `"grl-tracker"`

### Vimeo

Esto es un complemento para Vimeo. El ID de este complemento es `"grl-vimeo"`

### YouTube

Esto es un complemento para Youtube. El ID de este complemento es `"grl-youtube"`

### DLeyna

Esto es un complemento para UPnP/DLNA. El ID de este complemento es `"grl-dleyna"`