Genesys .NET C# AudioHook Server

This repository provides a reference implementation in .NET C# for the Genesys AudioHook protocol.

The .NET C# AudioHook Server is designed to handle WebSocket connections and process audio streams according to the Genesys AudioHook Protocol specifications, including both control messages and audio data.

This project is a sample blueprint to help you get started building an AudioHook servers and testing protocol compliance.

Getting Started

Prerequisites

1. .NET 9 SDK.
2. (Optional) Set the following environment variables to override defaults:
      - LOG_FILE_PATH: Path to the log file (default: C:/temp/log.txt)
      - SERVER_URL: WebSocket server URL (default: http://localhost:5000/ws/)
3. Build and run the server:

      dotnet run --project GenesysAudioHookServer   

4. The server will start and listen for WebSocket connections. Press CTRL+C to stop the server.

Testing the Server

To test the server, use the Genesys AudioHook Sample Service Test Client.

In the client directory, there is a simple command-line client. It establishes a connection and synthesizes an audio stream of a 1 kHz tone (stereo or mono depending on which media format the server accepted).

Running the Client

Replace the URI, API key, and client secret with your own. Below is an example using the sample API key and client secret from the protocol documentation:

cd client
ts-node src/index.ts --uri ws://localhost:5000/ws --api-key SGVsbG8sIEkgYW0gdGhlIEFQSSBrZXkh --client-secret TXlTdXBlclNlY3JldEtleVRlbGxOby0xITJAMyM0JDU=

Using WAV Files as Audio Source

The client supports WAV files as an audio source. Mono or stereo WAV files are supported. They must be encoded in:

• 16-bit linear PCM (format tag 1), or
• PCMU (format tag 7) at an 8000Hz sample rate.

Example:

cd client
ts-node src/index.ts --uri ws://localhost:5000/ws --api-key SGVsbG8sIEkgYW0gdGhlIEFQSSBrZXkh --client-secret TXlTdXBlclNlY3JldEtleVRlbGxOby0xITJAMyM0JDU= --wavfile example.wav

Additional Resources

• Genesys AudioHook Protocol
• Genesys AudioHook Monitor
• Genesys AudioHook Sample Service