# Greffons Grilo

Murray
Cumming

Grilo est une structure logicielle permettant de parcourir et de rechercher des contenus de médias provenant de différentes sources à l’aide d’une API unique. Les greffons Grilo sont des greffons pour cette structure qui permettent d’accéder à diverses sources de médias et de métadonnées.

2012
Openismus GmbH

Permission vous est donnée de copier, distribuer et/ou modifier ce document selon les termes de la Licence GNU Free Documentation License, Version 1.2 ou ultérieure publiée par la Free Software Foundation sans section inaltérable, sans texte de première page de couverture ni texte de dernière page de couverture. Vous pouvez obtenir une copie de la licence de documentation libre GNU auprès de la Free Software Foundation sur son site web ou en écrivant à l’adresse suivante : Free Software Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301, USA.

Irénée Thirion
irenee.thirion@e.email
2023
Irénée Thirion

## Introduction

Grilo est une structure logicielle permettant de parcourir et de rechercher des contenus de médias provenant de différentes sources à l’aide d’une API unique. Les greffons Grilo sont des greffons pour cette structure qui permettent d’accéder à diverses sources de médias et de métadonnées.

## Greffons Grilo

### Signets

Ceci est un greffon Grilo pour les signets. Son identifiant de greffon est `« grl-bookmarks »`

### DMap

Ceci est un greffon Grilo pour DMap. Son identifiant de greffon est `« grl-dmap »`

### Système de fichiers

Ceci est un greffon Grilo pour le système de fichiers. Son identifiant de greffon est `« grl-filesystem »`

### Flickr

Ceci est un greffon Grilo pour Flickr. Son identifiant de greffon est `« grl-flickr »`

### Gravatar

Ceci est un greffon Grilo pour Gravatar. Son identifiant de greffon est `« grl-gravatar »`

### Jamendo

Ceci est un greffon Grilo pour Jamendo. Son identifiant de greffon est `« grl-jamendo »`

### Métadonnées locales

Ceci est un greffon Grilo pour les métadonnées locales. Son identifiant de greffon est `« grl-local-metadata »`

### Entrepôt de métadonnées

Ceci est un greffon Grilo pour l’entrepôt de métadonnées. Son identifiant de greffon est `« grl-metadata-store »`

### Médias optiques

Ceci est un greffon Grilo pour les supports optiques. Son identifiant de greffon est `« grl-optical-media »`

### Podcasts

Ceci est un greffon Grilo pour les podcasts. Son identifiant de greffon est `« grl-podcasts »`

### Shoutcast

Ceci est un greffon Grilo pour Shoutcast. Son identifiant de greffon est `« grl-shoutcast »`

### TMDb Plugin

Le greffon TMDb récupère des informations sur les films à partir du service en ligne TMDb, qui est une base de données de films maintenue par une communauté. Son identifiant est `« grl-tmdb »`

Avant d’utiliser ce greffon, vous devez définir la clé API TMDb avec `grl_config_set_api_key()`.

Vous pouvez alors utiliser `grl_source_resolve()` pour découvrir les détails d’un GrlMediaItem existant.

Ce greffon ne prend pas en charge la recherche via `grl_source_search()` ou les requêtes via `grl_source_query()`.

Voici un exemple simple de l’utilisation du greffon Grilo TMDb :

Fichier : `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

Ceci est un greffon Grilo pour Tracker. Son identifiant de greffon est `« grl-tracker »`

### Vimeo

Ceci est un greffon Grilo pour Vimeo. Son identifiant de greffon est `« grl-vimeo »`

### YouTube

Ceci est un greffon Grilo pour YouTube. Son identifiant de greffon est `« grl-youtube »`

### DLeyna

Ceci est un greffon Grilo pour UPnP/DLNA. Son identifiant de greffon est `« grl-dleyna »`