diff options
Diffstat (limited to 'lib/libUPnP/Platinum/Source/Devices/MediaServer/PltMediaServer.h')
-rw-r--r-- | lib/libUPnP/Platinum/Source/Devices/MediaServer/PltMediaServer.h | 196 |
1 files changed, 196 insertions, 0 deletions
diff --git a/lib/libUPnP/Platinum/Source/Devices/MediaServer/PltMediaServer.h b/lib/libUPnP/Platinum/Source/Devices/MediaServer/PltMediaServer.h new file mode 100644 index 0000000..d35d8d8 --- /dev/null +++ b/lib/libUPnP/Platinum/Source/Devices/MediaServer/PltMediaServer.h @@ -0,0 +1,196 @@ +/***************************************************************** +| +| Platinum - AV Media Server Device +| +| Copyright (c) 2004-2010, Plutinosoft, LLC. +| All rights reserved. +| http://www.plutinosoft.com +| +| This program is free software; you can redistribute it and/or +| modify it under the terms of the GNU General Public License +| as published by the Free Software Foundation; either version 2 +| of the License, or (at your option) any later version. +| +| OEMs, ISVs, VARs and other distributors that combine and +| distribute commercially licensed software with Platinum software +| and do not wish to distribute the source code for the commercially +| licensed software under version 2, or (at your option) any later +| version, of the GNU General Public License (the "GPL") must enter +| into a commercial license agreement with Plutinosoft, LLC. +| licensing@plutinosoft.com +| +| This program 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 +| along with this program; see the file LICENSE.txt. If not, write to +| the Free Software Foundation, Inc., +| 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. +| http://www.gnu.org/licenses/gpl-2.0.html +| +****************************************************************/ + +/** @file + UPnP AV Media Server. + */ + +#ifndef _PLT_MEDIA_SERVER_H_ +#define _PLT_MEDIA_SERVER_H_ + +/*---------------------------------------------------------------------- +| includes ++---------------------------------------------------------------------*/ +#include "Neptune.h" +#include "PltDeviceHost.h" +#include "PltMediaItem.h" + +/*---------------------------------------------------------------------- +| constants ++---------------------------------------------------------------------*/ +#define MAX_PATH_LENGTH 1024 + +/*---------------------------------------------------------------------- +| PLT_MediaServerDelegate ++---------------------------------------------------------------------*/ +/** + The PLT_MediaServerDelegate class is an interface for delegating the handling + of the required UPnP AV ContentDirectory service actions. It also handles + resource HTTP requests (downloading). + */ +class PLT_MediaServerDelegate +{ +public: + PLT_MediaServerDelegate() {} + virtual ~PLT_MediaServerDelegate() {} + + virtual NPT_Result OnBrowseMetadata(PLT_ActionReference& /*action*/, + const char* /*object_id*/, + const char* /*filter*/, + NPT_UInt32 /*starting_index*/, + NPT_UInt32 /*requested_count*/, + const char* /*sort_criteria*/, + const PLT_HttpRequestContext& /*context*/) = 0; + virtual NPT_Result OnBrowseDirectChildren(PLT_ActionReference& /*action*/, + const char* /*object_id*/, + const char* /*filter*/, + NPT_UInt32 /*starting_index*/, + NPT_UInt32 /*requested_count*/, + const char* /*sort_criteria*/, + const PLT_HttpRequestContext& /*context*/) = 0; + virtual NPT_Result OnSearchContainer(PLT_ActionReference& /*action*/, + const char* /*container_id*/, + const char* /*search_criteria*/, + const char* /*filter*/, + NPT_UInt32 /*starting_index*/, + NPT_UInt32 /*requested_count*/, + const char* /*sort_criteria*/, + const PLT_HttpRequestContext& /*context*/) = 0; + virtual NPT_Result OnUpdateObject(PLT_ActionReference& /*action*/, + const char* /*object_id*/, + NPT_Map<NPT_String,NPT_String>& /*current_vals*/, + NPT_Map<NPT_String,NPT_String>& /*new_vals*/, + const PLT_HttpRequestContext& /*context*/) = 0; + + virtual NPT_Result ProcessFileRequest(NPT_HttpRequest& /*request*/, + const NPT_HttpRequestContext& /*context*/, + NPT_HttpResponse& /*response*/) = 0; +}; + +/*---------------------------------------------------------------------- +| PLT_MediaServer ++---------------------------------------------------------------------*/ +/** + The PLT_MediaServer class implements the base class for a UPnP AV + Media Server device. + */ +class PLT_MediaServer : public PLT_DeviceHost +{ +public: + /* BrowseFlags */ + enum BrowseFlags { + BROWSEMETADATA, + BROWSEDIRECTCHILDREN + }; + + // class methods + static NPT_Result ParseBrowseFlag(const char* str, BrowseFlags& flag); + static NPT_Result ParseSort(const NPT_String& sort, NPT_List<NPT_String>& list); + static NPT_Result ParseTagList(const NPT_String& updates, NPT_Map<NPT_String,NPT_String>& tags); + + // constructor + PLT_MediaServer(const char* friendly_name, + bool show_ip = false, + const char* uuid = NULL, + NPT_UInt16 port = 0, + bool port_rebind = false); + + // methods + virtual void SetDelegate(PLT_MediaServerDelegate* delegate) { m_Delegate = delegate; } + PLT_MediaServerDelegate* GetDelegate() { return m_Delegate; } + virtual void UpdateSystemUpdateID(NPT_UInt32 update); + virtual void UpdateContainerUpdateID(const char* id, NPT_UInt32 update); + +protected: + ~PLT_MediaServer() override; + + // PLT_DeviceHost methods + NPT_Result SetupServices() override; + NPT_Result OnAction(PLT_ActionReference& action, + const PLT_HttpRequestContext& context) override; + NPT_Result ProcessHttpGetRequest(NPT_HttpRequest& request, + const NPT_HttpRequestContext& context, + NPT_HttpResponse& response) override; + + // ConnectionManager + virtual NPT_Result OnGetCurrentConnectionIDs(PLT_ActionReference& action, + const PLT_HttpRequestContext& context); + virtual NPT_Result OnGetProtocolInfo(PLT_ActionReference& action, + const PLT_HttpRequestContext& context); + virtual NPT_Result OnGetCurrentConnectionInfo(PLT_ActionReference& action, + const PLT_HttpRequestContext& context); + + // ContentDirectory + virtual NPT_Result OnGetSortCapabilities(PLT_ActionReference& action, + const PLT_HttpRequestContext& context); + virtual NPT_Result OnGetSearchCapabilities(PLT_ActionReference& action, + const PLT_HttpRequestContext& context); + virtual NPT_Result OnGetSystemUpdateID(PLT_ActionReference& action, + const PLT_HttpRequestContext& context); + virtual NPT_Result OnBrowse(PLT_ActionReference& action, + const PLT_HttpRequestContext& context); + virtual NPT_Result OnSearch(PLT_ActionReference& action, + const PLT_HttpRequestContext& context); + virtual NPT_Result OnUpdate(PLT_ActionReference& action, + const PLT_HttpRequestContext& context); + + // overridable methods + virtual NPT_Result OnBrowseMetadata(PLT_ActionReference& action, + const char* object_id, + const char* filter, + NPT_UInt32 starting_index, + NPT_UInt32 requested_count, + const char* sort_criteria, + const PLT_HttpRequestContext& context); + virtual NPT_Result OnBrowseDirectChildren(PLT_ActionReference& action, + const char* object_id, + const char* filter, + NPT_UInt32 starting_index, + NPT_UInt32 requested_count, + const char* sort_criteria, + const PLT_HttpRequestContext& context); + virtual NPT_Result OnSearchContainer(PLT_ActionReference& action, + const char* container_id, + const char* search_criteria, + const char* filter, + NPT_UInt32 starting_index, + NPT_UInt32 requested_count, + const char* sort_criteria, + const PLT_HttpRequestContext& context); + +private: + PLT_MediaServerDelegate* m_Delegate; +}; + +#endif /* _PLT_MEDIA_SERVER_H_ */ |