TsPy - TeamSpeak 3 Plugin

✨ Belangrijkste Functies

🚀 Snel Starten

# Navigeer naar de project directory
cd E:\Projects\HamRadio\TsPy

# Configureer CMake (alleen eerste keer)
cmake -S . -B build -G "Visual Studio 17 2022" -A x64

# Bouw de plugin
cmake --build build --config Release

# Installeer naar TeamSpeak plugins folder
.\install.ps1

Beschikbare API Functies

De ts3api module biedt deze functies:

import ts3api

# Informatie
client_id = ts3api.get_client_id(server_id)
name = ts3api.get_client_name(server_id, client_id)

# Berichten versturen
ts3api.print_message("Hallo TeamSpeak!")
ts3api.send_channel_message(server_id, "Hallo kanaal!")
ts3api.send_server_message(server_id, "Hallo server!")

# Audio (v1.5.0+)
level = ts3api.get_audio_level(server_id)  # Retourneert dB (-60 tot 0)
ts3api.start_recording(server_id)
ts3api.stop_recording(server_id)

# Logging
ts3api.log("Debug bericht", level=0)  # 0=INFO, 1=WARNING, 2=ERROR

Event Handlers

Je scripts kunnen deze event handlers implementeren:

def on_connect(server_id, client_id):
    """Wordt aangeroepen wanneer je verbindt met een server"""
    print(f"Verbonden met server {server_id}")

def on_disconnect(server_id):
    """Wordt aangeroepen wanneer je verbinding verbreekt"""
    print(f"Verbinding verbroken van server {server_id}")

def on_client_move(server_id, client_id, old_channel, new_channel):
    """Wordt aangeroepen wanneer een client van kanaal wisselt"""
    print(f"Client {client_id} verplaatst naar kanaal {new_channel}")

def on_text_message(server_id, from_id, to_id, target_mode, message):
    """Wordt aangeroepen bij een tekstbericht"""
    print(f"Bericht van {from_id}: {message}")

def on_talk_status_change(server_id, status, client_id):
    """Wordt aangeroepen wanneer iemand start/stopt met praten"""
    if status == 1:  # STATUS_TALKING
        print(f"Client {client_id} is aan het praten")

💡 Voorbeeld Scripts

# greeter.py
import ts3api

def on_connect(server_id, client_id):
    ts3api.send_channel_message(
        server_id, 
        "Hallo iedereen! 👋"
    )

# echobot.py
import ts3api

def on_text_message(server_id, from_id, 
                     to_id, target_mode, message):
    if not "(auto-reply)" in message:
        reply = f"Echo: {message}"
        ts3api.send_channel_message(
            server_id, 
            reply
        )

Functies

• ✅ VU Meter - Real-time microfoon niveau visualisatie (-60dB tot 0dB)
• ✅ Kleurcodering - Groen (veilig), Geel (luid), Rood (clipping)
• ✅ Opname Controle - Klik op knop om spraakopname te starten/stoppen
• ✅ Spraak Status - Live lijst van momenteel pratende clients met indicatoren

Gebruik

# Kopieer eerst het voorbeeld naar je scripts folder:
Copy-Item "examples\audio_monitor.py" "$env:APPDATA\TS3Client\plugins\scripts\"

# Laad het vervolgens in TeamSpeak:
/tspy python load audio_monitor

Een PyGame venster opent met real-time audio monitoring. Druk op ESC of sluit het venster om te stoppen.

⚙️ Beschikbare Commando's

📊 Versie Geschiedenis