Files
geutebruck/SOURCES/CODEX/GeViScope/GeViScopeSDK_HTML5/Content/013SDK_Interfaces_Overview.htm
Administrator 14893e62a5 feat: Geutebruck GeViScope/GeViSoft Action Mapping System - MVP
This MVP release provides a complete full-stack solution for managing action mappings
in Geutebruck's GeViScope and GeViSoft video surveillance systems.

## Features

### Flutter Web Application (Port 8081)
- Modern, responsive UI for managing action mappings
- Action picker dialog with full parameter configuration
- Support for both GSC (GeViScope) and G-Core server actions
- Consistent UI for input and output actions with edit/delete capabilities
- Real-time action mapping creation, editing, and deletion
- Server categorization (GSC: prefix for GeViScope, G-Core: prefix for G-Core servers)

### FastAPI REST Backend (Port 8000)
- RESTful API for action mapping CRUD operations
- Action template service with comprehensive action catalog (247 actions)
- Server management (G-Core and GeViScope servers)
- Configuration tree reading and writing
- JWT authentication with role-based access control
- PostgreSQL database integration

### C# SDK Bridge (gRPC, Port 50051)
- Native integration with GeViSoft SDK (GeViProcAPINET_4_0.dll)
- Action mapping creation with correct binary format
- Support for GSC and G-Core action types
- Proper Camera parameter inclusion in action strings (fixes CrossSwitch bug)
- Action ID lookup table with server-specific action IDs
- Configuration reading/writing via SetupClient

## Bug Fixes
- **CrossSwitch Bug**: GSC and G-Core actions now correctly display camera/PTZ head parameters in GeViSet
- Action strings now include Camera parameter: `@ PanLeft (Comment: "", Camera: 101028)`
- Proper filter flags and VideoInput=0 for action mappings
- Correct action ID assignment (4198 for GSC, 9294 for G-Core PanLeft)

## Technical Stack
- **Frontend**: Flutter Web, Dart, Dio HTTP client
- **Backend**: Python FastAPI, PostgreSQL, Redis
- **SDK Bridge**: C# .NET 8.0, gRPC, GeViSoft SDK
- **Authentication**: JWT tokens
- **Configuration**: GeViSoft .set files (binary format)

## Credentials
- GeViSoft/GeViScope: username=sysadmin, password=masterkey
- Default admin: username=admin, password=admin123

## Deployment
All services run on localhost:
- Flutter Web: http://localhost:8081
- FastAPI: http://localhost:8000
- SDK Bridge gRPC: localhost:50051
- GeViServer: localhost (default port)

Generated with Claude Code (https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-31 18:10:54 +01:00

203 lines
9.1 KiB
HTML

<!DOCTYPE html>
<html xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd" lang="en" xml:lang="en" data-mc-search-type="Stem" data-mc-help-system-file-name="index.xml" data-mc-path-to-help-system="../" data-mc-target-type="WebHelp2" data-mc-runtime-file-type="Topic" data-mc-preload-images="false" data-mc-in-preview-mode="false" data-mc-toc-path="GeViScope SDK|GeViScope Software Development Kit (SDK)">
<!-- saved from url=(0014)about:internet -->
<head>
<meta charset="utf-8" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><title>Overview of the interfaces in the SDK
</title>
<link href="../Skins/Default/Stylesheets/TextEffects.css" rel="stylesheet" />
<link href="../Skins/Default/Stylesheets/Topic.css" rel="stylesheet" />
<link href="Resources/Stylesheets/Styles.css" rel="stylesheet" />
<script src="../Resources/Scripts/jquery.min.js">
</script>
<script src="../Resources/Scripts/plugins.min.js">
</script>
<script src="../Resources/Scripts/require.min.js">
</script>
<script src="../Resources/Scripts/require.config.js">
</script>
<script src="../Resources/Scripts/MadCapAll.js">
</script>
</head>
<body>
<div class="MCBreadcrumbsBox_0"><span class="MCBreadcrumbsPrefix">| </span><a class="MCBreadcrumbsLink" href="Titel.htm">GeViScope SDK</a><span class="MCBreadcrumbsDivider"> &gt; </span><a class="MCBreadcrumbsLink" href="010GeViScope_SDK.htm">GeViScope Software Development Kit (SDK)</a><span class="MCBreadcrumbsDivider"> &gt; </span><span class="MCBreadcrumbs">Overview of the interfaces in the SDK</span>
</div>
<h2 xmlns="http://www.w3.org/TR/REC-html40">Overview of the interfaces in the SDK
</h2>
<h3 xmlns="http://www.w3.org/TR/REC-html40">Introduction
</h3>
<p xmlns="http://www.w3.org/TR/REC-html40">This document gives a short overview of the
different interfaces that belong to the SDK. </p>
<p xmlns="http://www.w3.org/TR/REC-html40">
</p>
<p xmlns="http://www.w3.org/TR/REC-html40">Please note, that all interfaces include
class declarations to access the exported functions of the dynamic link libraries.
To use them in C++, the matching cpp files and the lib files corresponding to
the DLLs have to be added to the custom project.
</p>
<p xmlns="http://www.w3.org/TR/REC-html40">
<img src="Images/013image001_600x365.jpg" alt="InterfacesOverview.JPG" class="padding600" style="width: 600;height: 365;" />
</p>
<h3 xmlns="http://www.w3.org/TR/REC-html40">Building blocks of functionality
</h3>
<p class="GutZuWissenHeader" xmlns="http://www.w3.org/TR/REC-html40">DBI</p>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<ul xmlns="http://www.w3.org/TR/REC-html40">
<li value="1">Low level
server and database interface
</li>
<li value="2">Connection
handling, GBF access, raw database access (no video display!), media
export functionality, backup functions, access to raw live media (no video
display!), setup data access
</li>
<li value="3">Supports
basic functionality for building blocks “PLC” and “MediaPlayer”
</li>
<li value="4">Main
binary file: GSCDBI.DLL
</li>
<li value="5">Main
include files (C++): GSCDBI.h, GSCDBI.cpp
</li>
<li value="6">Main
include files (Pascal): GSCDBI.pas
</li>
</ul>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<p class="GutZuWissenHeader" xmlns="http://www.w3.org/TR/REC-html40">PLC</p>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<ul xmlns="http://www.w3.org/TR/REC-html40">
<li value="1">Complex
notification, action and event processing
</li>
<li value="2">Listen
to, dispatch, create and send actions
</li>
<li value="3">Listen to
events and system notifications
</li>
<li value="4">Allows controlling
and monitoring the system
</li>
<li value="5">Main
binary file: GSCActions.DLL
</li>
</ul>
<ul xmlns="http://www.w3.org/TR/REC-html40">
<li value="1">Main
include files (C++): GSCActions.h
</li>
</ul>
<ul xmlns="http://www.w3.org/TR/REC-html40">
<li value="1">Main
include files (Pascal): GSCActions.pas
</li>
</ul>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<p class="GutZuWissenHeader" xmlns="http://www.w3.org/TR/REC-html40">TACI</p>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<ul xmlns="http://www.w3.org/TR/REC-html40">
<li value="1">Telnet
Action Command Interface
</li>
<li value="2">Simple
ASCII-Format communication based on Telnet
</li>
<li value="3">Allows controlling
and monitoring the system
</li>
<li value="4">Received
actions need to be parsed
</li>
<li value="5">To use
that interface, the media plugin “GSCTelnetActionCommand” needs to be
installed
</li>
</ul>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<p class="GutZuWissenHeader" xmlns="http://www.w3.org/TR/REC-html40">MediaPlayer</p>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<ul xmlns="http://www.w3.org/TR/REC-html40">
<li value="1">High
level server and database interface including media presentation
</li>
<li value="2">Display
video, play audio (live and backup)
</li>
<li value="3">Integrated
export functionality (GBF, MPEG, Video-DVD, Single picture)
</li>
<li value="4">Search
media data by time or corresponding to event data
</li>
<li value="5">Main
binary file: GSCMediaPlayer.DLL
</li>
</ul>
<ul xmlns="http://www.w3.org/TR/REC-html40">
<li value="1">Main
include files (C++): GSCMediaPlayer.h, GSCMediaPlayer.cpp
</li>
</ul>
<ul xmlns="http://www.w3.org/TR/REC-html40">
<li value="1">Main
include files (Pascal): GSCMediaPlayer.pas
</li>
</ul>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<p class="GutZuWissenHeader" xmlns="http://www.w3.org/TR/REC-html40">OffscreenViewer</p>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<ul xmlns="http://www.w3.org/TR/REC-html40">
<li value="1">Part of
building block “MediaPlayer”
</li>
<li value="2">Same
functionality as MediaPlayer, but: no rendering, only decompressing
</li>
<li value="3">Class
TGSCOffscreenViewer can be used analogous to TGSCViewer
</li>
</ul>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<p class="GutZuWissenHeader" xmlns="http://www.w3.org/TR/REC-html40">Media plugin (GeViScope server plugins)</p>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<ul xmlns="http://www.w3.org/TR/REC-html40">
<li value="1">GeViScope
server plugins allow integrating custom peripherals in GeViScope systems
</li>
<li value="2">Channeling
of video and/or audio media into the server
</li>
<li value="3">Including
full access to PLC
</li>
<li value="4">Plugins
run as In-Process-DLLs in GeViScope server software
</li>
</ul>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<p class="GutZuWissenHeader" xmlns="http://www.w3.org/TR/REC-html40">GSCView data filter plugin</p>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<ul xmlns="http://www.w3.org/TR/REC-html40">
<li value="1">GSCView
plugins allow integrating custom data filter frontends in GSCView software
</li>
<li value="2">Plugins
run as In-Process-DLLs in GSCView software
</li>
</ul>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<p class="GutZuWissenHeader" xmlns="http://www.w3.org/TR/REC-html40">GSCView data presentation plugin</p>
<p xmlns="http://www.w3.org/TR/REC-html40">&#160;</p>
<ul xmlns="http://www.w3.org/TR/REC-html40">
<li value="1">GSCView
plugins allow customized presentation of event data in GSCView software,
especially of event data presented in viewed pictures
</li>
<li value="2">Plugins run
as In-Process-DLLs in GSCView software
</li>
</ul>
</body>
</html>