/*** This file is part of snapcast Copyright (C) 2014-2023 Johannes Pohl 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 3 of the License, or (at your option) any later version. 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. If not, see . ***/ #ifndef CONTROL_SESSION_HPP #define CONTROL_SESSION_HPP // local headers #include "common/message/message.hpp" #include "common/queue.h" #include "server_settings.hpp" // 3rd party headers // standard headers #include #include #include #include #include class ControlSession; class StreamSession; /// Interface: callback for a received message. class ControlMessageReceiver { public: using ResponseHander = std::function; // TODO: rename, error handling virtual void onMessageReceived(std::shared_ptr session, const std::string& message, const ResponseHander& response_handler) = 0; virtual void onNewSession(std::shared_ptr session) = 0; virtual void onNewSession(std::shared_ptr session) = 0; }; /// Endpoint for a connected control client. /** * Endpoint for a connected control client. * Messages are sent to the client with the "send" method. * Received messages from the client are passed to the ControlMessageReceiver callback */ class ControlSession : public std::enable_shared_from_this { public: /// ctor. Received message from the client are passed to ControlMessageReceiver ControlSession(ControlMessageReceiver* receiver) : message_receiver_(receiver) { } virtual ~ControlSession() = default; virtual void start() = 0; virtual void stop() = 0; /// Sends a message to the client (asynchronous) virtual void sendAsync(const std::string& message) = 0; protected: ControlMessageReceiver* message_receiver_; }; #endif