/*************************************************************************/ /* websocket_peer.h */ /*************************************************************************/ /* This file is part of: */ /* GODOT ENGINE */ /* https://godotengine.org */ /*************************************************************************/ /* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */ /* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */ /* */ /* Permission is hereby granted, free of charge, to any person obtaining */ /* a copy of this software and associated documentation files (the */ /* "Software"), to deal in the Software without restriction, including */ /* without limitation the rights to use, copy, modify, merge, publish, */ /* distribute, sublicense, and/or sell copies of the Software, and to */ /* permit persons to whom the Software is furnished to do so, subject to */ /* the following conditions: */ /* */ /* The above copyright notice and this permission notice shall be */ /* included in all copies or substantial portions of the Software. */ /* */ /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */ /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */ /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/ /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */ /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */ /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */ /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ /*************************************************************************/ #ifndef WEBSOCKET_PEER_H #define WEBSOCKET_PEER_H #include "core/crypto/crypto.h" #include "core/error/error_list.h" #include "core/io/packet_peer.h" class WebSocketPeer : public PacketPeer { GDCLASS(WebSocketPeer, PacketPeer); public: enum State { STATE_CONNECTING, STATE_OPEN, STATE_CLOSING, STATE_CLOSED }; enum WriteMode { WRITE_MODE_TEXT, WRITE_MODE_BINARY, }; enum { DEFAULT_BUFFER_SIZE = 65535, }; private: virtual Error _send_bind(const PackedByteArray &p_data, WriteMode p_mode = WRITE_MODE_BINARY); protected: static WebSocketPeer *(*_create)(); static void _bind_methods(); Vector supported_protocols; Vector handshake_headers; Vector _get_supported_protocols() const; Vector _get_handshake_headers() const; int outbound_buffer_size = DEFAULT_BUFFER_SIZE; int inbound_buffer_size = DEFAULT_BUFFER_SIZE; int max_queued_packets = 2048; public: static WebSocketPeer *create() { if (!_create) { return nullptr; } return _create(); } virtual Error connect_to_url(const String &p_url, bool p_verify_tls = true, Ref p_cert = Ref()) { return ERR_UNAVAILABLE; }; virtual Error accept_stream(Ref p_stream) = 0; virtual Error send(const uint8_t *p_buffer, int p_buffer_size, WriteMode p_mode) = 0; virtual void close(int p_code = 1000, String p_reason = "") = 0; virtual IPAddress get_connected_host() const = 0; virtual uint16_t get_connected_port() const = 0; virtual bool was_string_packet() const = 0; virtual void set_no_delay(bool p_enabled) = 0; virtual int get_current_outbound_buffered_amount() const = 0; virtual String get_selected_protocol() const = 0; virtual String get_requested_url() const = 0; virtual void poll() = 0; virtual State get_ready_state() const = 0; virtual int get_close_code() const = 0; virtual String get_close_reason() const = 0; Error send_text(const String &p_text); void set_supported_protocols(const Vector &p_protocols); const Vector get_supported_protocols() const; void set_handshake_headers(const Vector &p_headers); const Vector get_handshake_headers() const; void set_outbound_buffer_size(int p_buffer_size); int get_outbound_buffer_size() const; void set_inbound_buffer_size(int p_buffer_size); int get_inbound_buffer_size() const; void set_max_queued_packets(int p_max_queued_packets); int get_max_queued_packets() const; WebSocketPeer(); ~WebSocketPeer(); }; VARIANT_ENUM_CAST(WebSocketPeer::WriteMode); VARIANT_ENUM_CAST(WebSocketPeer::State); #endif // WEBSOCKET_PEER_H