Files
geutebruck/SOURCES/GeViScope_SDK_text/GeViScope_SDK_pages_121-127.txt
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

399 lines
12 KiB
Plaintext

================================================================================
GeViScope_SDK.pdf - Pages 121 to 127
================================================================================
────────────────────────────────────────────────────────────────────────────────
Page 121
────────────────────────────────────────────────────────────────────────────────
Parameter Function
clientaccount ClientAccountWindowsuseraccount
underthatGSCViewisrun-
ning
VCscenechanged
Actionname:VCSceneChanged(Viewer,Scene)
Actioncategory:notification
TheactivesceneoftheGSCViewwiththetransmittedviewerclientnumberhasbeen
changed.
GSCViewhasfiredthisnotificationbecauseitsactivescenehasbeenchangedviaa
VCChangeSceneByNameorViewerChangeSceneactionwhileGSCViewisremotecon-
trolledorbecausetheuserhasmanuallychangedtheactivesceneinGSCView.
Parameter Function
viewer Viewer Globalviewerclientnumber,identifiestheGSCViewthatfired
thisnotification
scene Scene Thenameofthescenethatisdisplayedafterthechange
Viewercleared
Actionname:ViewerCleared(Viewer,ClientHost,ClientType,ClientAccount)
Actioncategory:notification
TheviewerwiththetransmittedglobalnumberonsomeGSCViewinthenetworkhasbeen
cleared.
GSCViewhasfiredthisnotificationbecauseoneofitsviewershasbeenclearedviaaView-
erClearactionwhileGSCViewisremotecontrolledorbecausetheuserhasmanually
clearedtheviewerinGSCView.
Parameter Function
viewer Viewer GlobalnumberofavieweronsomeGSCViewinthenetwork
clienthost ClientHost HostnameofthePCwhereGSCViewisrunning
clienttype ClientType 1=GSCView
Allothervaluesareforfutureuse!
clientaccountClientAccountWindowsuseraccountunderthatGSCViewisrunning
Viewerconnected
Actionname:ViewerConnected(Viewer,Channel,PlayMode,ClientHost,ClientType,Cli-
entAccount)
Actioncategory:notification
TheviewerwiththetransmittedglobalnumberonsomeGSCViewinthenetworkhasbeen
connected.
GSCViewhasfiredthisnotificationbecauseoneofitsviewershasbeenconnectedviaa
ViewerConnectorViewerConnectLiveactionwhileGSCViewisremotecontrolledor
becausetheuserhasmanuallyconnectedtheviewerinGSCView.
Theparameter"playmode"definesinwhichmodethepicturesarepresented(live,forward,
backward,.).
────────────────────────────────────────────────────────────────────────────────
Page 122
────────────────────────────────────────────────────────────────────────────────
Parameter Function
viewer Viewer Globalnumberofa
vieweronsome
GSCViewinthenetwork
channel Channel Globalnumberofthe
mediachannel
playmode PlayMode playstop=iftheviewer
isalreadydisplayingpic-
turesfromthatchannel,
itisstopped;ifnotthe
newestpictureinthe
databaseisdisplayed
playforward=ifthe
viewerisalreadydis-
playingpicturesfrom
thatchannel,itisdis-
playingpicturesinnor-
malspeedforwardfrom
theactualposition;if
notdisplayofpictures
withnormalspeed
startsatthebeginning
ofthedatabase
playbackward=ifthe
viewerisalreadydis-
playingpicturesfrom
thatchannel,itisdis-
playingpicturesinnor-
malspeedbackward
fromtheactualposition;
ifnotdisplayofpictures
withnormalspeed
startsattheendofthe
database
fastforward=like"play
forward"butwithhigh
speed
fastbackward=like
"playbackward"but
withhighspeed
stepforward=like
"playforward"butonly
onepicture
stepbackward=like
"playbackward"but
onlyonepicture
playBOD=displaythe
first(theoldest)picture
inthedatabase
playEOD=displaythe
last(thenewest)pic-
tureinthedatabase
live=displaylivepic-
tures
nextevent=like"play
forward"butonlypic-
turesthatbelongto
eventrecordings
prevevent=like"play
────────────────────────────────────────────────────────────────────────────────
Page 123
────────────────────────────────────────────────────────────────────────────────
Parameter Function
backward"butonlypic-
turesthatbelongto
eventrecordings
peeklivepicture=dis-
playonlyoneactuallive
picture
nextdetectedmotion=
like"playforward"but
onlypictureswith
motioninit(ifnoMOS
searchareaisdefinedin
GscViewthewholepic-
turesizeisusedforit)
aredisplayed;thedis-
playstopsaftermotion
isdetected
prevdetectedmotion=
like"playbackward"but
onlypictureswith
motioninit(ifnoMOS
searchareaisdefinedin
GscViewthewholepic-
turesizeisusedforit)
aredisplayed;thedis-
playstopsaftermotion
isdetected
clienthost ClientHost HostnameofthePC
whereGSCViewisrun-
ning
clienttype ClientType 1=GSCView
Allothervaluesarefor
futureuse!
clientaccount ClientAccountWindowsuseraccount
underthatGSCViewis
running
Viewerplaymodechanged
Actionname:ViewerPlayModeChanged(Viewer,Channel,PlayMode,ChannelTime,Cli-
entHost,ClientType,ClientAccount)
Actioncategory:notification
TheplaymodeoftheviewerwiththetransmittedglobalnumberonsomeGSCViewinthe
networkhasbeenchanged.
GSCViewhasfiredthisnotificationbecausetheplaymodeofoneofitsviewershasbeen
changedviaaViewerConnect,ViewerConnectLive,ViewerSetPlayMode,View-
erPlayFromTime,ViewerJumpByTimeoroneoftheViewerShowAlarmBy.actionswhile
GSCViewisremotecontrolledorbecausetheuserhasmanuallychangedtheplaymodeof
theviewerinGSCView.
Parameter Function
viewer Viewer Globalnumberofa
vieweronsome
GSCViewinthenetwork
channel Channel Globalnumberofthe
mediachannel,dis-
playedintheviewer
────────────────────────────────────────────────────────────────────────────────
Page 124
────────────────────────────────────────────────────────────────────────────────
Parameter Function
playmode PlayMode playstop=iftheviewer
isalreadydisplayingpic-
turesfromthatchannel,
itisstopped;ifnotthe
newestpictureinthe
databaseisdisplayed
playforward=ifthe
viewerisalreadydis-
playingpicturesfrom
thatchannel,itisdis-
playingpicturesinnor-
malspeedforwardfrom
theactualposition;if
notdisplayofpictures
withnormalspeed
startsatthebeginning
ofthedatabase
playbackward=ifthe
viewerisalreadydis-
playingpicturesfrom
thatchannel,itisdis-
playingpicturesinnor-
malspeedbackward
fromtheactualposition;
ifnotdisplayofpictures
withnormalspeed
startsattheendofthe
database
fastforward=like"play
forward"butwithhigh
speed
fastbackward=like
"playbackward"but
withhighspeed
stepforward=like
"playforward"butonly
onepicture
stepbackward=like
"playbackward"but
onlyonepicture
playBOD=displaythe
first(theoldest)picture
inthedatabase
playEOD=displaythe
last(thenewest)pic-
tureinthedatabase
live=displaylivepic-
tures
nextevent=like"play
forward"butonlypic-
turesthatbelongto
eventrecordings
prevevent=like"play
backward"butonlypic-
turesthatbelongto
eventrecordings
peeklivepicture=dis-
playonlyoneactuallive
picture
────────────────────────────────────────────────────────────────────────────────
Page 125
────────────────────────────────────────────────────────────────────────────────
Parameter Function
nextdetectedmotion=
like"playforward"but
onlypictureswith
motioninit(ifnoMOS
searchareaisdefinedin
GscViewthewholepic-
turesizeisusedforit)
aredisplayed;thedis-
playstopsaftermotion
isdetected
prevdetectedmotion=
like"playbackward"but
onlypictureswith
motioninit(ifnoMOS
searchareaisdefinedin
GscViewthewholepic-
turesizeisusedforit)
aredisplayed;thedis-
playstopsaftermotion
isdetected
channeltime ChannelTime Timestampbelongingto
thepicturepresentedin
theviewerdirectlyafter
theplamodehad
changed.Thepara-
meteristransmittedin
thefollowingformat:
"2009/05/06
14:47:48,359
GMT+02:00"
clienthost ClientHost HostnameofthePC
whereGSCViewisrun-
ning
clienttype ClientType 1=GSCView
Allothervaluesarefor
futureuse!
clientaccount ClientAccountWindowsuseraccount
underthatGSCViewis
running
Viewerselectionchanged
Actionname:ViewerSelectionChanged(Viewer,Channel,PlayMode,ClientHost,Cli-
entType,ClientAccount)
Actioncategory:notification
TheactivevieweronsomeGSCViewinthenetworkhasbeenchanged.
GSCViewhasfiredthisnotificationbecausetheuserhasselectedoneofitsviewersby
mouseclickorbydraggingacameraontooneofitsviewers.
GSCViewonlyfiresthenotification,ifacameraisdisplayedontheselectedviewer.
Parameter Function
viewer Viewer Globalnumberofa
vieweronsome
GSCViewinthenetwork
channel Channel Globalnumberofthe
mediachannel,dis-
playedintheviewer
────────────────────────────────────────────────────────────────────────────────
Page 126
────────────────────────────────────────────────────────────────────────────────
Parameter Function
playmode PlayMode playstop=iftheviewer
isalreadydisplayingpic-
turesfromthatchannel,
itisstopped;ifnotthe
newestpictureinthe
databaseisdisplayed
playforward=ifthe
viewerisalreadydis-
playingpicturesfrom
thatchannel,itisdis-
playingpicturesinnor-
malspeedforwardfrom
theactualposition;if
notdisplayofpictures
withnormalspeed
startsatthebeginning
ofthedatabase
playbackward=ifthe
viewerisalreadydis-
playingpicturesfrom
thatchannel,itisdis-
playingpicturesinnor-
malspeedbackward
fromtheactualposition;
ifnotdisplayofpictures
withnormalspeed
startsattheendofthe
database
fastforward=like"play
forward"butwithhigh
speed
fastbackward=like
"playbackward"but
withhighspeed
stepforward=like
"playforward"butonly
onepicture
stepbackward=like
"playbackward"but
onlyonepicture
playBOD=displaythe
first(theoldest)picture
inthedatabase
playEOD=displaythe
last(thenewest)pic-
tureinthedatabase
live=displaylivepic-
tures
nextevent=like"play
forward"butonlypic-
turesthatbelongto
eventrecordings
prevevent=like"play
backward"butonlypic-
turesthatbelongto
eventrecordings
peeklivepicture=dis-
playonlyoneactuallive
picture
────────────────────────────────────────────────────────────────────────────────
Page 127
────────────────────────────────────────────────────────────────────────────────
Parameter Function
nextdetectedmotion=
like"playforward"but
onlypictureswith
motioninit(ifnoMOS
searchareaisdefinedin
GscViewthewholepic-
turesizeisusedforit)
aredisplayed;thedis-
playstopsaftermotion
isdetected
prevdetectedmotion=
like"playbackward"but
onlypictureswith
motioninit(ifnoMOS
searchareaisdefinedin
GscViewthewholepic-
turesizeisusedforit)
aredisplayed;thedis-
playstopsaftermotion
isdetected
clienthost ClientHost HostnameofthePC
whereGSCViewisrun-
ning
clienttype ClientType 1=GSCView
Allothervaluesarefor
futureuse!
clientaccount ClientAccountWindowsuseraccount
underthatGSCViewis
running