Add support for sending generic OBS websocket messages

This should allow to send OBS websocket vendor requests to other plugins
which offer an API via this method (e.g. vertical OBS)
This commit is contained in:
WarmUpTill 2023-06-21 22:29:40 +02:00 committed by WarmUpTill
parent 371b4ae05d
commit a17d8f7e09
7 changed files with 228 additions and 86 deletions

View File

@ -436,8 +436,8 @@ AdvSceneSwitcher.condition.stats.entry="{{stats}} is {{condition}} {{value}}"
AdvSceneSwitcher.condition.profile="Profile" AdvSceneSwitcher.condition.profile="Profile"
AdvSceneSwitcher.condition.profile.entry="Current active profile is {{profiles}}" AdvSceneSwitcher.condition.profile.entry="Current active profile is {{profiles}}"
AdvSceneSwitcher.condition.websocket="Websocket" AdvSceneSwitcher.condition.websocket="Websocket"
AdvSceneSwitcher.condition.websocket.type.request="Request" AdvSceneSwitcher.condition.websocket.type.request="Scene Switcher Request"
AdvSceneSwitcher.condition.websocket.type.event="Event" AdvSceneSwitcher.condition.websocket.type.event="Scene Switcher Event"
AdvSceneSwitcher.condition.websocket.useRegex="Use regular expressions" AdvSceneSwitcher.condition.websocket.useRegex="Use regular expressions"
AdvSceneSwitcher.condition.websocket.entry.request="{{type}} was received:" AdvSceneSwitcher.condition.websocket.entry.request="{{type}} was received:"
AdvSceneSwitcher.condition.websocket.entry.event="{{type}} was received from {{connection}}:" AdvSceneSwitcher.condition.websocket.entry.event="{{type}} was received from {{connection}}:"
@ -664,10 +664,16 @@ AdvSceneSwitcher.action.sequence.status.none="none"
AdvSceneSwitcher.action.sequence.restart="Restart from beginning once end of list is reached" AdvSceneSwitcher.action.sequence.restart="Restart from beginning once end of list is reached"
AdvSceneSwitcher.action.sequence.continueFrom="Continue with selected item" AdvSceneSwitcher.action.sequence.continueFrom="Continue with selected item"
AdvSceneSwitcher.action.websocket="Websocket" AdvSceneSwitcher.action.websocket="Websocket"
AdvSceneSwitcher.action.websocket.api.sceneSwitcher="Scene Switcher message"
AdvSceneSwitcher.action.websocket.api.obsWebsocket="OBS websocket message"
AdvSceneSwitcher.action.websocket.api.genericWebsocket="Generic websocket message"
AdvSceneSwitcher.action.websocket.type.request="Request" AdvSceneSwitcher.action.websocket.type.request="Request"
AdvSceneSwitcher.action.websocket.type.event="Event" AdvSceneSwitcher.action.websocket.type.event="Event"
AdvSceneSwitcher.action.websocket.entry.request="Send scene switcher {{type}} via {{connection}}" AdvSceneSwitcher.action.websocket.settingsConflictGeneric="Possible settings conflict: Generic websocket message selection with connection which follows the OBS protocol!"
AdvSceneSwitcher.action.websocket.entry.event="Send scene switcher {{type}} to connected clients" AdvSceneSwitcher.action.websocket.settingsConflictOBS="Possible settings conflict: Connection selected which only supports generic websockte messages while message type requires OBS protocol!"
AdvSceneSwitcher.action.websocket.entry.sceneSwitcher.request="Send{{api}}of type{{type}}via{{connection}}"
AdvSceneSwitcher.action.websocket.entry.sceneSwitcher.event="Send{{api}}of type{{type}}to connected clients"
AdvSceneSwitcher.action.websocket.entry.generic="Send{{api}}via{{connection}}"
AdvSceneSwitcher.action.http="Http" AdvSceneSwitcher.action.http="Http"
AdvSceneSwitcher.action.http.setHeaders="Set headers" AdvSceneSwitcher.action.http.setHeaders="Set headers"
AdvSceneSwitcher.action.http.headers="Headers:" AdvSceneSwitcher.action.http.headers="Headers:"

View File

@ -10,47 +10,75 @@ bool MacroActionWebsocket::_registered = MacroActionFactory::Register(
{MacroActionWebsocket::Create, MacroActionWebsocketEdit::Create, {MacroActionWebsocket::Create, MacroActionWebsocketEdit::Create,
"AdvSceneSwitcher.action.websocket"}); "AdvSceneSwitcher.action.websocket"});
const static std::map<MacroActionWebsocket::Type, std::string> actionTypes = { const static std::map<MacroActionWebsocket::API, std::string> apiTypes = {
{MacroActionWebsocket::Type::REQUEST, {MacroActionWebsocket::API::SCENE_SWITCHER,
"AdvSceneSwitcher.action.websocket.type.request"}, "AdvSceneSwitcher.action.websocket.api.sceneSwitcher"},
{MacroActionWebsocket::Type::EVENT, {MacroActionWebsocket::API::OBS_WEBSOCKET,
"AdvSceneSwitcher.action.websocket.type.event"}, "AdvSceneSwitcher.action.websocket.api.obsWebsocket"},
{MacroActionWebsocket::API::GENERIC_WEBSOCKET,
"AdvSceneSwitcher.action.websocket.api.genericWebsocket"},
}; };
void MacroActionWebsocket::SendRequest() const static std::map<MacroActionWebsocket::MessageType, std::string>
messageTypes = {
{MacroActionWebsocket::MessageType::REQUEST,
"AdvSceneSwitcher.action.websocket.type.request"},
{MacroActionWebsocket::MessageType::EVENT,
"AdvSceneSwitcher.action.websocket.type.event"},
};
void MacroActionWebsocket::SendRequest(const std::string &msg)
{ {
auto connection = _connection.lock(); auto connection = _connection.lock();
if (!connection) { if (!connection) {
return; return;
} }
connection->SendMsg(_message);
connection->SendMsg(msg);
} }
bool MacroActionWebsocket::PerformAction() bool MacroActionWebsocket::PerformAction()
{ {
switch (_type) { if (_api != MacroActionWebsocket::API::SCENE_SWITCHER) {
case MacroActionWebsocket::Type::REQUEST: SendRequest(_message);
SendRequest(); return true;
break;
case MacroActionWebsocket::Type::EVENT:
SendWebsocketEvent(_message);
break;
default:
break;
} }
if (_type == MacroActionWebsocket::MessageType::REQUEST) {
auto vendorRequest = ConstructVendorRequestMessage(_message);
SendRequest(vendorRequest);
} else {
SendWebsocketEvent(_message);
}
return true; return true;
} }
void MacroActionWebsocket::LogAction() const void MacroActionWebsocket::LogAction() const
{ {
if (_api == API::GENERIC_WEBSOCKET) {
vblog(LOG_INFO,
"sent generic websocket message \"%s\" via \"%s\"",
_message.c_str(),
GetWeakConnectionName(_connection).c_str());
return;
}
if (_api == API::OBS_WEBSOCKET) {
vblog(LOG_INFO, "sent obs websocket message \"%s\" via \"%s\"",
_message.c_str(),
GetWeakConnectionName(_connection).c_str());
return;
}
switch (_type) { switch (_type) {
case MacroActionWebsocket::Type::REQUEST: case MacroActionWebsocket::MessageType::REQUEST:
vblog(LOG_INFO, "sent msg \"%s\" via \"%s\"", _message.c_str(), vblog(LOG_INFO, "sent scene switcher message \"%s\" via \"%s\"",
_message.c_str(),
GetWeakConnectionName(_connection).c_str()); GetWeakConnectionName(_connection).c_str());
break; break;
case MacroActionWebsocket::Type::EVENT: case MacroActionWebsocket::MessageType::EVENT:
vblog(LOG_INFO, "sent event \"%s\" to connected clients", vblog(LOG_INFO,
"sent scene switcher event \"%s\" to connected clients",
_message.c_str()); _message.c_str());
break; break;
default: default:
@ -61,6 +89,7 @@ void MacroActionWebsocket::LogAction() const
bool MacroActionWebsocket::Save(obs_data_t *obj) const bool MacroActionWebsocket::Save(obs_data_t *obj) const
{ {
MacroAction::Save(obj); MacroAction::Save(obj);
obs_data_set_int(obj, "api", static_cast<int>(_api));
obs_data_set_int(obj, "type", static_cast<int>(_type)); obs_data_set_int(obj, "type", static_cast<int>(_type));
_message.Save(obj, "message"); _message.Save(obj, "message");
obs_data_set_string(obj, "connection", obs_data_set_string(obj, "connection",
@ -71,7 +100,8 @@ bool MacroActionWebsocket::Save(obs_data_t *obj) const
bool MacroActionWebsocket::Load(obs_data_t *obj) bool MacroActionWebsocket::Load(obs_data_t *obj)
{ {
MacroAction::Load(obj); MacroAction::Load(obj);
_type = static_cast<Type>(obs_data_get_int(obj, "type")); _api = static_cast<API>(obs_data_get_int(obj, "api"));
_type = static_cast<MessageType>(obs_data_get_int(obj, "type"));
_message.Load(obj, "message"); _message.Load(obj, "message");
_connection = _connection =
GetWeakConnectionByName(obs_data_get_string(obj, "connection")); GetWeakConnectionByName(obs_data_get_string(obj, "connection"));
@ -80,40 +110,54 @@ bool MacroActionWebsocket::Load(obs_data_t *obj)
std::string MacroActionWebsocket::GetShortDesc() const std::string MacroActionWebsocket::GetShortDesc() const
{ {
if (_type == Type::REQUEST) { if (_type == MessageType::REQUEST) {
return GetWeakConnectionName(_connection); return GetWeakConnectionName(_connection);
} }
return ""; return "";
} }
static inline void populateActionSelection(QComboBox *list) static inline void populateAPISelection(QComboBox *list)
{ {
for (auto entry : actionTypes) { for (const auto &[_, name] : apiTypes) {
list->addItem(obs_module_text(entry.second.c_str())); list->addItem(obs_module_text(name.c_str()));
}
}
static inline void populateMessageTypeSelection(QComboBox *list)
{
for (const auto &[_, name] : messageTypes) {
list->addItem(obs_module_text(name.c_str()));
} }
} }
MacroActionWebsocketEdit::MacroActionWebsocketEdit( MacroActionWebsocketEdit::MacroActionWebsocketEdit(
QWidget *parent, std::shared_ptr<MacroActionWebsocket> entryData) QWidget *parent, std::shared_ptr<MacroActionWebsocket> entryData)
: QWidget(parent), : QWidget(parent),
_actions(new QComboBox(this)), _apiType(new QComboBox(this)),
_messageType(new QComboBox(this)),
_message(new VariableTextEdit(this)), _message(new VariableTextEdit(this)),
_connection(new ConnectionSelection(this)), _connection(new ConnectionSelection(this)),
_editLayout(new QHBoxLayout()) _editLayout(new QHBoxLayout()),
_settingsConflict(new QLabel())
{ {
populateActionSelection(_actions); populateAPISelection(_apiType);
populateMessageTypeSelection(_messageType);
_settingsConflict->setWordWrap(true);
QWidget::connect(_actions, SIGNAL(currentIndexChanged(int)), this, QWidget::connect(_apiType, SIGNAL(currentIndexChanged(int)), this,
SLOT(ActionChanged(int))); SLOT(APITypeChanged(int)));
QWidget::connect(_messageType, SIGNAL(currentIndexChanged(int)), this,
SLOT(MessageTypeChanged(int)));
QWidget::connect(_message, SIGNAL(textChanged()), this, QWidget::connect(_message, SIGNAL(textChanged()), this,
SLOT(MessageChanged())); SLOT(MessageChanged()));
QWidget::connect(_connection, SIGNAL(SelectionChanged(const QString &)), QWidget::connect(_connection, SIGNAL(SelectionChanged(const QString &)),
this, this,
SLOT(ConnectionSelectionChanged(const QString &))); SLOT(ConnectionSelectionChanged(const QString &)));
QVBoxLayout *mainLayout = new QVBoxLayout; auto mainLayout = new QVBoxLayout;
mainLayout->addLayout(_editLayout); mainLayout->addLayout(_editLayout);
mainLayout->addWidget(_message); mainLayout->addWidget(_message);
mainLayout->addWidget(_settingsConflict);
setLayout(mainLayout); setLayout(mainLayout);
_entryData = entryData; _entryData = entryData;
@ -121,34 +165,111 @@ MacroActionWebsocketEdit::MacroActionWebsocketEdit(
_loading = false; _loading = false;
} }
void MacroActionWebsocketEdit::CheckForSettingsConflict()
{
auto connection = _entryData->_connection.lock();
if (!connection) {
_settingsConflict->hide();
return;
}
if (_entryData->_api == MacroActionWebsocket::API::GENERIC_WEBSOCKET &&
connection->IsUsingOBSProtocol()) {
_settingsConflict->show();
_settingsConflict->setText(obs_module_text(
"AdvSceneSwitcher.action.websocket.settingsConflictGeneric"));
} else if (_entryData->_api !=
MacroActionWebsocket::API::GENERIC_WEBSOCKET &&
!connection->IsUsingOBSProtocol()) {
_settingsConflict->show();
_settingsConflict->setText(obs_module_text(
"AdvSceneSwitcher.action.websocket.settingsConflictOBS"));
} else {
_settingsConflict->hide();
}
adjustSize();
updateGeometry();
}
void MacroActionWebsocketEdit::SetupWidgetVisibility()
{
_messageType->setVisible(_entryData->_api ==
MacroActionWebsocket::API::SCENE_SWITCHER);
switch (_entryData->_api) {
case MacroActionWebsocket::API::SCENE_SWITCHER:
if (_entryData->_type ==
MacroActionWebsocket::MessageType::REQUEST) {
SetupRequestEdit();
} else {
SetupEventEdit();
}
break;
case MacroActionWebsocket::API::OBS_WEBSOCKET:
case MacroActionWebsocket::API::GENERIC_WEBSOCKET:
SetupGenericEdit();
break;
default:
break;
}
CheckForSettingsConflict();
adjustSize();
updateGeometry();
}
void MacroActionWebsocketEdit::SetupRequestEdit() void MacroActionWebsocketEdit::SetupRequestEdit()
{ {
_editLayout->removeWidget(_actions); ClearWidgets();
_editLayout->removeWidget(_connection); PlaceWidgets(
ClearLayout(_editLayout); obs_module_text(
std::unordered_map<std::string, QWidget *> widgetPlaceholders = { "AdvSceneSwitcher.action.websocket.entry.sceneSwitcher.request"),
{"{{type}}", _actions}, _editLayout,
{"{{connection}}", _connection}, {{"{{api}}", _apiType},
}; {"{{type}}", _messageType},
PlaceWidgets(obs_module_text( {"{{connection}}", _connection}});
"AdvSceneSwitcher.action.websocket.entry.request"),
_editLayout, widgetPlaceholders);
_connection->show(); _connection->show();
} }
void MacroActionWebsocketEdit::SetupEventEdit() void MacroActionWebsocketEdit::SetupEventEdit()
{ {
_editLayout->removeWidget(_actions); ClearWidgets();
PlaceWidgets(
obs_module_text(
"AdvSceneSwitcher.action.websocket.entry.sceneSwitcher.event"),
_editLayout,
{{"{{api}}", _apiType},
{"{{type}}", _messageType},
{"{{connection}}", _connection}});
// Add widget to layout but hide it
_editLayout->addWidget(_connection);
_connection->hide();
}
void MacroActionWebsocketEdit::SetupGenericEdit()
{
ClearWidgets();
PlaceWidgets(obs_module_text(
"AdvSceneSwitcher.action.websocket.entry.generic"),
_editLayout,
{{"{{api}}", _apiType},
{"{{type}}", _messageType},
{"{{connection}}", _connection}});
_connection->show();
// Add widget to layout but hide it
_editLayout->addWidget(_messageType);
_messageType->hide();
}
void MacroActionWebsocketEdit::ClearWidgets()
{
_editLayout->removeWidget(_apiType);
_editLayout->removeWidget(_messageType);
_editLayout->removeWidget(_connection); _editLayout->removeWidget(_connection);
ClearLayout(_editLayout); ClearLayout(_editLayout);
std::unordered_map<std::string, QWidget *> widgetPlaceholders = {
{"{{type}}", _actions},
{"{{connection}}", _connection},
};
PlaceWidgets(obs_module_text(
"AdvSceneSwitcher.action.websocket.entry.event"),
_editLayout, widgetPlaceholders);
_connection->hide();
} }
void MacroActionWebsocketEdit::UpdateEntryData() void MacroActionWebsocketEdit::UpdateEntryData()
@ -157,33 +278,37 @@ void MacroActionWebsocketEdit::UpdateEntryData()
return; return;
} }
_actions->setCurrentIndex(static_cast<int>(_entryData->_type)); _apiType->setCurrentIndex(static_cast<int>(_entryData->_api));
_messageType->setCurrentIndex(static_cast<int>(_entryData->_type));
_message->setPlainText(_entryData->_message); _message->setPlainText(_entryData->_message);
_connection->SetConnection(_entryData->_connection); _connection->SetConnection(_entryData->_connection);
if (_entryData->_type == MacroActionWebsocket::Type::REQUEST) { SetupWidgetVisibility();
SetupRequestEdit();
} else {
SetupEventEdit();
}
adjustSize();
updateGeometry();
} }
void MacroActionWebsocketEdit::ActionChanged(int index) void MacroActionWebsocketEdit::APITypeChanged(int index)
{ {
if (_loading || !_entryData) { if (_loading || !_entryData) {
return; return;
} }
auto lock = LockContext(); auto lock = LockContext();
_entryData->_type = static_cast<MacroActionWebsocket::Type>(index); _entryData->_api = static_cast<MacroActionWebsocket::API>(index);
if (_entryData->_type == MacroActionWebsocket::Type::REQUEST) { SetupWidgetVisibility();
SetupRequestEdit(); emit HeaderInfoChanged(
} else { QString::fromStdString(_entryData->GetShortDesc()));
SetupEventEdit(); }
void MacroActionWebsocketEdit::MessageTypeChanged(int index)
{
if (_loading || !_entryData) {
return;
} }
auto lock = LockContext();
_entryData->_type =
static_cast<MacroActionWebsocket::MessageType>(index);
SetupWidgetVisibility();
emit HeaderInfoChanged( emit HeaderInfoChanged(
QString::fromStdString(_entryData->GetShortDesc())); QString::fromStdString(_entryData->GetShortDesc()));
} }
@ -210,6 +335,7 @@ void MacroActionWebsocketEdit::ConnectionSelectionChanged(
auto lock = LockContext(); auto lock = LockContext();
_entryData->_connection = GetWeakConnectionByQString(connection); _entryData->_connection = GetWeakConnectionByQString(connection);
CheckForSettingsConflict();
emit(HeaderInfoChanged(connection)); emit(HeaderInfoChanged(connection));
} }

View File

@ -24,17 +24,24 @@ public:
return std::make_shared<MacroActionWebsocket>(m); return std::make_shared<MacroActionWebsocket>(m);
} }
enum class Type { enum class API {
SCENE_SWITCHER,
OBS_WEBSOCKET,
GENERIC_WEBSOCKET,
};
enum class MessageType {
REQUEST, REQUEST,
EVENT, EVENT,
}; };
Type _type = Type::REQUEST; API _api = API::SCENE_SWITCHER;
MessageType _type = MessageType::REQUEST;
StringVariable _message = obs_module_text("AdvSceneSwitcher.enterText"); StringVariable _message = obs_module_text("AdvSceneSwitcher.enterText");
std::weak_ptr<Connection> _connection; std::weak_ptr<Connection> _connection;
private: private:
void SendRequest(); void SendRequest(const std::string &msg);
static bool _registered; static bool _registered;
static const std::string id; static const std::string id;
@ -57,7 +64,8 @@ public:
} }
private slots: private slots:
void ActionChanged(int); void APITypeChanged(int);
void MessageTypeChanged(int);
void MessageChanged(); void MessageChanged();
void ConnectionSelectionChanged(const QString &); void ConnectionSelectionChanged(const QString &);
signals: signals:
@ -67,13 +75,20 @@ protected:
std::shared_ptr<MacroActionWebsocket> _entryData; std::shared_ptr<MacroActionWebsocket> _entryData;
private: private:
void CheckForSettingsConflict();
void SetupWidgetVisibility();
void SetupRequestEdit(); void SetupRequestEdit();
void SetupEventEdit(); void SetupEventEdit();
void SetupGenericEdit();
void ClearWidgets();
QComboBox *_actions; QComboBox *_apiType;
QComboBox *_messageType;
VariableTextEdit *_message; VariableTextEdit *_message;
ConnectionSelection *_connection; ConnectionSelection *_connection;
QHBoxLayout *_editLayout; QHBoxLayout *_editLayout;
QLabel *_settingsConflict;
bool _loading = true; bool _loading = true;
}; };

View File

@ -131,6 +131,7 @@ Connection *GetConnectionByName(const QString &name)
{ {
return GetConnectionByName(name.toStdString()); return GetConnectionByName(name.toStdString());
} }
Connection *GetConnectionByName(const std::string &name) Connection *GetConnectionByName(const std::string &name)
{ {
for (auto &con : switcher->connections) { for (auto &con : switcher->connections) {

View File

@ -40,6 +40,7 @@ public:
void Save(obs_data_t *obj) const; void Save(obs_data_t *obj) const;
std::string GetName() { return _name; } std::string GetName() { return _name; }
std::vector<std::string> &Events() { return _client.Events(); } std::vector<std::string> &Events() { return _client.Events(); }
bool IsUsingOBSProtocol() { return _useOBSWSProtocol; }
private: private:
void UseOBSWebsocketProtocol(bool); void UseOBSWebsocketProtocol(bool);

View File

@ -75,8 +75,7 @@ extern "C" void RegisterWebsocketVendor()
} }
} }
WSConnection::WSConnection(bool useOBSProtocol) WSConnection::WSConnection(bool useOBSProtocol) : QObject(nullptr)
: QObject(nullptr), _useOBSProtocol(useOBSProtocol)
{ {
_client.get_alog().clear_channels( _client.get_alog().clear_channels(
websocketpp::log::alevel::frame_header | websocketpp::log::alevel::frame_header |
@ -179,14 +178,13 @@ void WSConnection::Disconnect()
_status = Status::DISCONNECTED; _status = Status::DISCONNECTED;
} }
static std::string constructVendorRequestMessage(const std::string &message, std::string ConstructVendorRequestMessage(const std::string &message)
const std::string &uri)
{ {
auto request = obs_data_create(); auto request = obs_data_create();
obs_data_set_int(request, "op", 6); obs_data_set_int(request, "op", 6);
auto *data = obs_data_create(); auto *data = obs_data_create();
obs_data_set_string(data, "requestType", "CallVendorRequest"); obs_data_set_string(data, "requestType", "CallVendorRequest");
obs_data_set_string(data, "requestId", (message + " - " + uri).c_str()); obs_data_set_string(data, "requestId", message.c_str());
auto vendorData = obs_data_create(); auto vendorData = obs_data_create();
obs_data_set_string(vendorData, "vendorName", VendorName); obs_data_set_string(vendorData, "vendorName", VendorName);
@ -211,11 +209,7 @@ static std::string constructVendorRequestMessage(const std::string &message,
void WSConnection::SendRequest(const std::string &msg) void WSConnection::SendRequest(const std::string &msg)
{ {
if (_useOBSProtocol) { Send(msg);
Send(constructVendorRequestMessage(msg, _uri));
} else {
Send(msg);
}
} }
WSConnection::Status WSConnection::GetStatus() const WSConnection::Status WSConnection::GetStatus() const
@ -225,7 +219,6 @@ WSConnection::Status WSConnection::GetStatus() const
void WSConnection::UseOBSWebsocketProtocol(bool useOBSProtocol) void WSConnection::UseOBSWebsocketProtocol(bool useOBSProtocol)
{ {
_useOBSProtocol = useOBSProtocol;
_client.set_open_handler(bind(useOBSProtocol _client.set_open_handler(bind(useOBSProtocol
? &WSConnection::OnOBSOpen ? &WSConnection::OnOBSOpen
: &WSConnection::OnGenericOpen, : &WSConnection::OnGenericOpen,

View File

@ -30,6 +30,7 @@ constexpr char VendorEvent[] = "AdvancedSceneSwitcherEvent";
void ClearWebsocketMessages(); void ClearWebsocketMessages();
void SendWebsocketEvent(const std::string &); void SendWebsocketEvent(const std::string &);
std::string ConstructVendorRequestMessage(const std::string &message);
class WSConnection : public QObject { class WSConnection : public QObject {
public: public:
@ -79,7 +80,6 @@ private:
std::atomic_bool _disconnect{false}; std::atomic_bool _disconnect{false};
std::vector<std::string> _messages; std::vector<std::string> _messages;
bool _useOBSProtocol = true;
}; };
} // namespace advss } // namespace advss