Control PTZ Camera using HTTP request

.github/workflows/main.yml

@@ -64,6 +64,7 @@ jobs:
           set -ex
           sudo apt install -y \
             libopenblas-dev libopenblas0 \
+            libcurl4-openssl-dev \
             || true
           export OPENBLAS_HOME=/lib/x86_64-linux-gnu/
           cmake -S . -B build \

CMakeLists.txt

@@ -36,6 +36,7 @@ find_package(libobs REQUIRED)
 find_package(obs-frontend-api REQUIRED)
 include(cmake/ObsPluginHelpers.cmake)
 find_qt(VERSION ${QT_VERSION} COMPONENTS Widgets Core Gui)
+find_package(CURL REQUIRED)
 
 if (WITH_DLIB_SUBMODULE)
 	set(CMAKE_POSITION_INDEPENDENT_CODE True)
@@ -92,6 +93,7 @@ set(PLUGIN_SOURCES
 	src/helper.cpp
 	src/ptz-backend.cpp
 	src/obsptz-backend.cpp
+	src/ptz-http-backend.cpp
 	src/dummy-backend.cpp
 )
 
@@ -122,6 +124,7 @@ target_link_libraries(${CMAKE_PROJECT_NAME}
 	OBS::libobs
 	OBS::obs-frontend-api
 	dlib
+	CURL::libcurl
 	${plugin_additional_libs}
 )
 
@@ -136,6 +139,7 @@ if(OS_WINDOWS)
 		add_definitions("-D_USE_MATH_DEFINES")
 		add_definitions("-D_CRT_SECURE_NO_WARNINGS") # to avoid a warning for `fopen`
 		add_definitions("-D_DISABLE_CONSTEXPR_MUTEX_CONSTRUCTOR") # TODO: Remove once requiring OBS 30.2 or later.
+		target_compile_definitions(${PROJECT_NAME} PRIVATE NOMINMAX)
 	endif()
 
 	target_link_libraries(${CMAKE_PROJECT_NAME} OBS::w32-pthreads)

ci/plugin.spec

@@ -13,6 +13,7 @@ BuildRequires: obs-studio-devel
 BuildRequires: qt6-qtbase-devel qt6-qtbase-private-devel
 BuildRequires: dlib-devel ffmpeg-free-devel sqlite-devel blas-devel lapack-devel
 BuildRequires: flexiblas-devel
+BuildRequires: libcurl-devel
 # dlib-devel requires /usr/include/ffmpeg so that install ffmpeg-free-devel
 
 %package data
@@ -68,6 +69,7 @@ mv %{buildroot}/%{_datadir}/obs/obs-plugins/@PLUGIN_NAME@/LICENSE-shape_predicto
 %files
 %{_libdir}/obs-plugins/@PLUGIN_NAME@.so
 %{_datadir}/obs/obs-plugins/@PLUGIN_NAME@/locale/
+%{_datadir}/obs/obs-plugins/@PLUGIN_NAME@/ptz/
 %{_datadir}/licenses/%{name}/*
 
 %files data

data/locale/en-US.ini

@@ -1,2 +1,7 @@
 Detector.dlib.hog="HOG, dlib"
 Detector.dlib.cnn="CNN, dlib"
+Prop.ptz.http.host="Host name"
+Prop.ptz.http.host.desc="Host name and optionally port number, eg. 192.0.2.101:8080"
+Prop.ptz.http.user="User name"
+Prop.ptz.http.user.desc="Set if authentication is required. Leave blank if necessary."
+Prop.ptz.http.passwd="Password"

data/ptz/ptz-http-backend-camera-models.json

@@ -0,0 +1,25 @@
+{
+	"camera-models": [
+		{
+			"id": "hikvision",
+			"name": "HikVision PTZ (HTTP)",
+			"properties": {
+			},
+			"settings": {
+				"ptz-method": "PUT",
+				"ptz-url": "http://{host}/ISAPI/PTZCtrl/channels/1/continuous",
+				"ptz-payload": "<?xml version: \"1.0\" encoding=\"UTF-8\"?><PTZData><pan>{p}</pan><tilt>{t}</tilt><zoom>{z}</zoom></PTZData>"
+			},
+			"control-function": {
+				"p": { "type": "linear-int", "k1": 1.0, "k0": 0, "max": 15 },
+				"t": { "type": "linear-int", "k1": 1.0, "k0": 0, "max": 15 },
+				"z": { "type": "linear-int", "k1": 1.0, "k0": 0, "max": 3 },
+				"TODO": "\"max\" should be configurable."
+			}
+		},
+		{
+			"id": "sony-srg300se",
+			"name": "Sony SRG-300SE (HTTP)"
+		}
+	]
+}

src/face-tracker-ptz.cpp

@@ -17,6 +17,7 @@
 #ifdef WITH_PTZ_TCP
 #include "libvisca-thread.hpp"
 #endif
+#include "ptz-http-backend.hpp"
 #include "dummy-backend.hpp"
 
 #define PTZ_MAX_X 0x18
@@ -107,6 +108,7 @@ static const struct ptz_backend_type_s backends[] =
 #ifdef WITH_PTZ_TCP
 	BACKEND("visca-over-tcp", libvisca_thread),
 #endif // WITH_PTZ_TCP
+	BACKEND("http", ptz_http_backend),
 	BACKEND("dummy", dummy_backend),
 	{NULL, NULL, NULL}
 #undef BACKEND
@@ -452,6 +454,7 @@ static obs_properties_t *ftptz_properties(void *data)
 #ifdef WITH_PTZ_TCP
 		obs_property_list_add_string(p, obs_module_text("VISCA over TCP"), "visca-over-tcp");
 #endif // WITH_PTZ_TCP
+		obs_property_list_add_string(p, obs_module_text("HTTP"), "http");
 		obs_property_set_modified_callback(p, ptz_type_modified);
 
 		obs_properties_add_bool(pp, "invert_x", obs_module_text("Invert control (Pan)"));