youtube_service.h

Go to the documentation of this file.

/*MT*
    
    MediaTomb - http://www.mediatomb.cc/
    
    youtube_service.h - this file is part of MediaTomb.
    
    Copyright (C) 2005 Gena Batyan <bgeradz@mediatomb.cc>,
                       Sergey 'Jin' Bostandzhyan <jin@mediatomb.cc>
    
    Copyright (C) 2006-2010 Gena Batyan <bgeradz@mediatomb.cc>,
                            Sergey 'Jin' Bostandzhyan <jin@mediatomb.cc>,
                            Leonhard Wimmer <leo@mediatomb.cc>
    
    MediaTomb is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License version 2
    as published by the Free Software Foundation.
    
    MediaTomb 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 General Public License for more details.
    
    You should have received a copy of the GNU General Public License
    version 2 along with MediaTomb; if not, write to the Free Software
    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
    
    $Id: youtube_service.h 2081 2010-03-23 20:18:00Z lww $
*/


#if defined(YOUTUBE) // make sure to add more ifdefs when we get more services

#ifndef __YOUTUBE_SERVICE_H__
#define __YOUTUBE_SERVICE_H__

#include "zmm/zmm.h"
#include "mxml/mxml.h"
#include "online_service.h"
#include "url.h"
#include "dictionary.h"
#include "youtube_content_handler.h"
#include <curl/curl.h>

typedef enum 
{
    YT_request_none = 0,
    YT_request_video_search,
    YT_request_stdfeed,
    YT_request_user_favorites,
    YT_request_user_playlists,
    YT_request_user_subscriptions,
    YT_request_user_uploads,
    YT_subrequest_playlists,
    YT_subrequest_subscriptions,
} yt_requests_t;

typedef enum
{
    YT_region_au = 0,
    YT_region_br,
    YT_region_ca,
    YT_region_fr,
    YT_region_de,
    YT_region_gb,
    YT_region_nl,
    YT_region_hk,
    YT_region_ie,
    YT_region_it,
    YT_region_jp,
    YT_region_mx,
    YT_region_nz,
    YT_region_pl,
    YT_region_ru,
    YT_region_kr,
    YT_region_es,
    YT_region_tw,
    YT_region_us,
    YT_region_none,
} yt_regions_t;

class YouTubeService : public OnlineService
{
public:
    YouTubeService();
    ~YouTubeService();
    virtual bool refreshServiceData(zmm::Ref<Layout> layout);

    virtual service_type_t getServiceType();

    virtual zmm::String getServiceName();

    virtual zmm::Ref<zmm::Object> defineServiceTask(zmm::Ref<mxml::Element> xmlopt, zmm::Ref<zmm::Object> params);

    static zmm::String getRequestName(yt_requests_t request);

    static zmm::String getRegionName(yt_regions_t region_code);

protected:
    // the handle *must never be used from multiple threads*
    CURL *curl_handle;
    // safeguard to ensure the above
    pthread_t pid;

    // url retriever class
    zmm::Ref<URL> url;

    zmm::Ref<mxml::Element> getData(zmm::String url_part, zmm::Ref<Dictionary> params, bool construct_url = true);

    class YouTubeTask : public zmm::Object
    {
    public:
        YouTubeTask();

        yt_requests_t request;

        yt_regions_t region;

        zmm::String url_part;
        
        zmm::Ref<Dictionary> parameters;
        
        int amount;

        int amount_fetched;

        int start_index;

        int cfg_start_index;

        zmm::String sub_request_name;

        zmm::Ref<YouTubeSubFeed> subfeed;
        int subfeed_index;

        bool kill;
    };

    int current_task;


    // helper functions for parsing config.xml
//    zmm::String getCheckAttr(zmm::Ref<mxml::Element> xml, zmm::String attrname);
//    int getCheckPosIntAttr(zmm::Ref<mxml::Element> xml, zmm::String attrname);
    void getPagingParams(zmm::Ref<mxml::Element> xml, 
                         zmm::Ref<YouTubeTask> task);
    void addTimeParams(zmm::Ref<mxml::Element> xml, zmm::Ref<YouTubeTask> task);
    yt_regions_t getRegion(zmm::Ref<mxml::Element> xml);
    zmm::String getFeed(zmm::Ref<mxml::Element> xml);

    // subrequests are spawned as one time tasks, they are removed from the 
    // task list after one time execution - this function takes care of it
    void killOneTimeTasks(zmm::Ref<zmm::Array<zmm::Object> > tasklist);
};

#endif//__ONLINE_SERVICE_H__

#endif//YOUTUBE

---