# Grilo bővítmények

Murray Cumming

A Grilo egy keretrendszer a különböző forrásokból származó médiatartalmak böngészésére és keresésére egyetlen API segítségével. A Grilo bővítmények a Grilo keretrendszerhez készült bővítmények, hogy hozzáférést biztosítsanak a különböző médiaforrásokhoz és metaadatokhoz.

2012 Openismus GmbH

Engedélyt adunk Önnek a jelen dokumentum sokszorosítására, terjesztésére és/vagy módosítására a Free Software Foundation által kiadott GNU Free Documentation License (GFDL) 1.2-es, vagy bármely azt követő verziójának feltételei alapján. Nincs Nem Változtatható szakasz, nincs Címlapszöveg, nincs Hátlapszöveg. A GNU Free Documentation License egy példányát a Free Software Foundation alapítványtól szerezheti be a weboldaluk meglátogatásával vagy az alábbi címre történő levélküldéssel: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301, USA.

Úr Balázs ur dot balazs at fsf dot hu
2022. Úr Balázs

## Bevezetés

A Grilo egy keretrendszer a különböző forrásokból származó médiatartalmak böngészésére és keresésére egyetlen API segítségével. A Grilo bővítmények a Grilo keretrendszerhez készült bővítmények, hogy hozzáférést biztosítsanak a különböző médiaforrásokhoz és metaadatokhoz.

## Grilo bővítmények

### Apple előzetesek

Ez egy Grilo bővítmény az Apple előzetesekhez. A bővítmény azonosítója a „`grl-apple-trailers`”.

### Könyvjelzők

Ez egy Grilo bővítmény a könyvjelzőkhöz. A bővítmény azonosítója a „`grl-bookmarks`”.

### DMap

Ez egy Grilo bővítmény a DMaphoz. A bővítmény azonosítója a „`grl-dmap`”.

### Fájlrendszer

Ez egy Grilo bővítmény a fájlrendszerhez. A bővítmény azonosítója a „`grl-filesystem`”.

### Flickr

Ez egy Grilo bővítmény a Flickrhez. A bővítmény azonosítója a „`grl-flickr`”.

### Gravatar

Ez egy Grilo bővítmény a Gravatarhoz. A bővítmény azonosítója a „`grl-gravatar`”.

### Jamendo

Ez egy Grilo bővítmény a Jamendohoz. A bővítmény azonosítója a „`grl-jamendo`”.

### Helyi metaadatok

Ez egy Grilo bővítmény a helyi metaadatokhoz. A bővítmény azonosítója a „`grl-local-metadata`”.

### Metaadatok tárolója

Ez egy Grilo bővítmény a metaadatok tárolójához. A bővítmény azonosítója a „`grl-local-metadata`”.

### Optikai média

Ez egy Grilo bővítmény az optikai médiához. A bővítmény azonosítója a „`grl-optical-media`”.

### Podcastok

Ez egy Grilo bővítmény a podcastokhoz. A bővítmény azonosítója a „`grl-podcasts`”.

### Shoutcast

Ez egy Grilo bővítmény a Shoutcasthoz. A bővítmény azonosítója a „`grl-shoutcast`”.

### TMDb bővítmény

A TMDb bővítmény a filmekkel kapcsolatos információkat kéri le a TMDb internetes szolgáltatásból, amely egy közösség által karbantartott filmadatbázis. A bővítmény azonosítója a „`grl-tmdb`”.

A bővítmény használata előtt be kell állítania a TMDB API-kulcsot a `grl_config_set_api_key()` segítségével.

Ezután használhatja a `grl_source_resolve()` függvényt a meglévő GrlMediaItem elemmel kapcsolatos részletek felfedezéséhez.

Ez a bővítmény nem támogatja a `grl_source_search()` függvényen keresztüli keresést vagy a `grl_source_query()` függvényen keresztüli lekérdezéseket.

Itt egy egyszerű példa a Grilo TMDb bővítmény használatára:

Fájl: `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>

    /**
     * Ez a TMDB-kulcs csak teszteléshez van.
     * A valódi használathoz kérjen saját kulcsot az alábbi oldalon:
     * 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);

      /*
       * A TMDB API-kulcs beállítása:
       * A saját TMDB API-kulcsát kell használnia a saját alkalmazásában.
       */
      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);

      /*
       * A bővítmény lekérése:
       */
      error = NULL;
      plugin_activated =
        grl_registry_activate_plugin_by_id (reg, TMDB_PLUGIN_ID, &error);
      g_assert (plugin_activated);
      g_assert_no_error (error);

      /*
       * A Grilo forrás lekérése:
       */
      src = grl_registry_lookup_source (reg, TMDB_PLUGIN_ID);

      /*
       * Annak ellenőrzése, hogy rendelkezik-e az elvárt képességekkel:
       */
      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);

      /*
       * Egy médiaelem, amelyet átadunk a TMDB bővítménynek,
       * hogy felfedezze annak részleteit.
       */
      media = grl_media_video_new ();
      grl_media_set_title (media, "Sherlock Holmes");

      /*
       * Annak felfedezése, hogy mely kulcsokat biztosítja a forrás:
       */
      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);

        /*
         * Emlékezzen erre a későbbi használatnál:
         * Használhatja inkább ezt: grl_registry_lookup_metadata_key_name().
         */
        if (g_strcmp0 (name, "tmdb-director") == 0) {
          director_key = id;
        }
      }

      /*
       * A TMDB bővítménytől a médiaelem részleteinek kérése
       * a TMDB online szolgáltatásból:
       */
      grl_source_resolve (src, media,
        keys, options,
        resolve_cb, NULL);

      /*
       * A fő hurok indítása, hogy a visszahívásunk meghívható legyen:
       */
      loop = g_main_loop_new (NULL, FALSE);
      g_main_loop_run (loop);

      /*
       * Objektumok felszabadítása:
       */
      g_object_unref (media);
      g_object_unref (config);
      g_object_unref (options);

      /*
       * A Grilo előkészítésének megszüntetése:
       */
      grl_deinit ();
    }

### Követő

Ez egy Grilo bővítmény a Követőhöz. A bővítmény azonosítója a „`grl-tracker`”.

### Vimeo

Ez egy Grilo bővítmény a Vimeohoz. A bővítmény azonosítója a „`grl-vimeo`”.

### YouTube

Ez egy Grilo bővítmény a YouTube-hoz. A bővítmény azonosítója a „`grl-youtube`”.

### DLeyna

Ez egy Grilo bővítmény az UPnP/DLNA-hoz. A bővítmény azonosítója a „`grl-dleyna`”.