Genetec DAP (Development Acceleration Program)

This repository contains Security Center SDK samples for entity management, reports, events, media, plugin roles, and client extensions. It also includes Genetec Web Player hosting samples.

Introduction to Security Center

Security Center combines access control, video surveillance, automatic license plate recognition, communications, and analytics. Use its SDKs to build standalone integrations, server-side roles, and extensions for Security Desk and Config Tool.

Getting Started

1. Join the Development Acceleration Program (DAP):

Visit Genetec's DAP and join the program. This will provide you with access to the SDK documentation, installer, and a development license for Security Center.

2. Set up a Development Environment:

• Install Security Center: Ensure you have Security Center installed. You can download the installer from the Genetec Portal.

• Activate Development License: Activate the Security Center license provided by the DAP. This license allows your integration to connect to Security Center.

• Install Security Center SDK: The SDK contains the necessary libraries to build and run custom integrations. Download and install the Security Center SDK from the Genetec Portal.

  The SDK installer automatically:

  • Creates environment variables (GSC_SDK for .NET Framework, GSC_SDK_CORE for modern .NET)
  • Writes the installation path in Windows registry
  • Copies the Security Center SDK assemblies to the SDK directories

  See Referencing Security Center SDK assemblies for assembly references, runtime resolution, and dependency deployment.

• Development Tools:

• Visual Studio: Use Visual Studio 2022 version 17.8 or later for the existing samples. Use Visual Studio 2026 or later if you retarget a project to .NET 10.

• .NET Framework targeting pack: Install the .NET Framework 4.8.1 targeting pack for sample projects targeting net481.

• .NET 8: Some sample projects can be built using .NET 8. Platform SDK samples require Security Center SDK 5.12.2 or later; Plugin SDK .NET 8 support applies to server modules in Security Center 5.13 or later; Genetec Web Player samples target .NET 8 and do not use the .NET Security Center SDK.

• .NET SDK: Install the .NET 8 SDK or a later SDK that supports the sample's target. A project retargeted to .NET 10 requires the .NET 10 SDK or a later SDK that supports that target. Run dotnet --list-sdks to check installed SDKs.

• Build and Run the Samples: Once your environment is ready, you can open the sample projects in Visual Studio, build them and run them.

3. Explore the Samples:

After setting up your environment, you can explore the sample projects in this repository. Each sample demonstrates a different feature or capability of the SDK, such as video management, access control, and system events.

Security Center SDKs

The sample projects in this repository are organized into four Security Center SDKs (each building upon the foundational Platform SDK) and a separate collection of Genetec Web Player samples:

Platform SDK Samples (/Platform SDK/)

The core samples that demonstrate fundamental Security Center SDK functionality. These samples provide the foundation that all other SDKs build upon, including entity management, event monitoring, and reporting.

Key capabilities demonstrated:

• Login and entity loading using the SampleBase class

• Entity creation, modification, and deletion

• Reports queries

• Event monitoring and alarm processing

• Custom fields

• Transaction management

Start here for: Basic SDK concepts, entity operations, reporting, and core Security Center functionality.

Media SDK Samples (/Media SDK/)

Video and audio processing samples that extend the Platform SDK with specialized media functionality. These samples demonstrate streaming, playback, PTZ control, and media management capabilities.

Key capabilities demonstrated:

• Video streaming and playback operations

• PTZ camera coordination and control

• Video export and format conversion

• Audio transmission and processing

• Overlay graphics and visual enhancements

Dependencies: Built on Platform SDK foundations for entity management and SDK connection patterns.

See the Media SDK README.

Workspace SDK Samples (/Workspace SDK/)

Client-side user interface extensions that use Platform SDK entities and services to add components to Security Desk and Config Tool. These modules must target .NET Framework because they run inside the client applications.

Key capabilities demonstrated:

• Custom Security Desk tasks and pages

• Dashboard widgets and tile components

• Config Tool configuration pages

• Options extensions and UI integrations

Dependencies: Uses Platform SDK for entity access, authentication, and core SDK functionality within the client applications.

See the Workspace SDK README.

Plugin SDK Samples (/Plugin SDK/)

Server-side plugin development samples that build upon Platform SDK infrastructure to create custom roles with database support, failover capabilities, and deep system integration.

Key capabilities demonstrated:

• Server-side processing and custom role creation

• Database integration with upgrade and cleanup support

• Background services and business logic implementation

• Custom report generation and data management

Dependencies: Inherits Platform SDK patterns for entity management, queries, and core SDK functionality while adding server-side role capabilities.

See the Plugin SDK README.

Genetec Web Player Samples (/Samples/Genetec Web Player/)

Hosting samples for the Genetec Web Player (GWP), the JavaScript video player that ships with the Media Gateway. Unlike the SDK samples, these projects do not connect through the .NET Security Center SDK; they demonstrate three different application shells that load gwp.js from a Media Gateway and supply it with opaque camera tokens.

Hosting models demonstrated:

• WPF desktop application that hosts GWP in an embedded WebView2 control, with token retrieval performed natively in .NET
• ASP.NET Core Minimal API application that serves a static page and proxies token requests through a server-side endpoint
• ASP.NET Core Razor Pages application that adds production-ready CSP nonce support and server-rendered configuration on top of the Minimal API pattern

Prerequisites differ from the SDK samples: GWP samples require a reachable Media Gateway, a trusted (or development) Media Gateway certificate, and CORS configuration that allows the hosting page's origin. See each sample's README for details.

Sample Project Structure

The sample projects in this repository are structured as follows:

• Target Frameworks: Platform SDK samples build .NET Framework 4.8.1 by default and .NET 8 through the _NET8 configurations. Media SDK, Workspace SDK, and Plugin SDK samples target .NET Framework 4.8.1. Genetec Web Player samples target .NET 8.

• Project Output: The sample projects typically compile to one of the following:

• Executable files (.exe) for standalone applications

• Class libraries (.dll) for Workspace modules and Plugins

• SDK References:

• For .NET Framework 4.8.1: The Security Center SDK projects reference assemblies from the $(GSC_SDK) directory.

• For Platform SDK .NET 8 builds: The projects reference Security Center assemblies from the $(GSC_SDK_CORE) directory.

• Genetec Web Player samples do not reference the .NET Security Center SDK.

• Additional Features:

• Some projects include a post-build step to copy certificate files to the output directory.

• Projects may share common code through the use of shared project items.

Targeting .NET Framework or .NET 8

The samples do not all use the same framework-targeting model. Use the configurations already defined in the solution and project files.

Platform SDK configuration model

Platform SDK sample projects target .NET Framework 4.8.1 by default and use explicit _NET8 configurations for .NET 8:

<TargetFramework>net481</TargetFramework>
<TargetFramework Condition="'$(Configuration)' == 'Debug_NET8' OR '$(Configuration)' == 'Release_NET8'">net8.0-windows</TargetFramework>
<Configurations>Debug;Release;Debug_NET8;Release_NET8</Configurations>

Use Debug or Release to build net481. Use Debug_NET8 or Release_NET8 to build net8.0-windows.

dotnet build "Samples/Platform SDK/CardholderSample/CardholderSample.csproj" -c Debug
dotnet build "Samples/Platform SDK/CardholderSample/CardholderSample.csproj" -c Debug_NET8

These examples are scoped to a Platform SDK project so they do not run Workspace SDK or Plugin SDK post-build registration steps. For solution-wide builds, run from an elevated shell or elevated Visual Studio instance because some Workspace SDK and Plugin SDK samples write development registration entries under HKEY_LOCAL_MACHINE.

The _NET8 configurations require Security Center SDK 5.12.2 or later and GSC_SDK_CORE pointing to the SDK folder that contains Genetec.Sdk.dll. Do not use -f net8.0-windows with the default Debug or Release configurations; select an _NET8 configuration instead.

Other sample groups

The Media SDK, Workspace SDK, and Plugin SDK sample projects in this repository target .NET Framework 4.8.1. The solution maps Debug_NET8 and Release_NET8 back to Debug and Release for those projects so that the solution configuration can focus on Platform SDK framework selection. The Genetec Web Player samples target .NET 8 and do not use the .NET Security Center SDK.

Sample target frameworks

This table describes the projects in this repository. SDK runtime support can extend beyond the targets configured in these samples.

Sample group	Configured targets	Selection
Platform SDK	net481, net8.0-windows	Debug/Release or Debug_NET8/Release_NET8
Media SDK	net481	Debug or Release
Workspace SDK	net481	Debug or Release
Plugin SDK	net481	Debug or Release
Genetec Web Player	net8.0 for web projects; net8.0-windows for the desktop project	Debug or Release

The Platform SDK samples select one target per build configuration. The solution does not define a .NET 10 configuration. For guidance on retargeting your own application, see Migrating a Platform SDK application to modern .NET.

Using Visual Studio configurations

Open Samples/Genetec.Dap.CodeSamples.sln and select one of the existing solution configurations:

• Debug / Release: Platform SDK samples build net481.
• Debug_NET8 / Release_NET8: Platform SDK samples build net8.0-windows; non-Platform SDK samples continue to build their Debug / Release configurations.

Run Visual Studio as an administrator when building the full solution if you want Workspace SDK and Plugin SDK development registration to succeed.

Building modern .NET plugins

The Plugin SDK samples in this repository target .NET Framework. For a modern .NET integration, choose the project and deployment instructions for the Security Center version where the role will run.

Security Center 5.14 and later

Build a modern .NET ServerModule for server-side logic and an optional .NET Framework ClientModule for custom UI in Config Tool or Security Desk. Register the ServerModule on the server hosting the role and the ClientModule on workstations that use its UI. Security Center 5.14.0 supports .NET 8 role plugins; .NET 10 role hosting requires 5.14.1 or later.

See Building plugins for Security Center 5.14 and later and Deploying plugins, including the deployment requirement for modules that declare custom privileges.

Security Center 5.13

Include a .NET Framework Client discovery assembly alongside the modern .NET ServerModule on the server. Config Tool requests the plugin list from that server. Keep any ClientModule targeting .NET Framework for its client-side UI.

See Building plugins for Security Center 5.13 for the project structures and registration requirements.

Documentation

Complete documentation for the Security Center SDK can be found on the Genetec Developer Portal. You will need to create an account to access the documentation.

License

Please refer to the LICENSE file for information about permissions and limitations for using these SDK samples.

Contributing

While this repository is primarily for reference purposes, contributions such as bug reports, feature requests, and code improvements are welcome. Please follow the guidelines outlined in the CONTRIBUTING file.

Support

If you encounter any issues or have questions regarding the Security Center SDK or the provided samples, please reach out to the Genetec support team through the Genetec Technical Assistance Portal.