/* * TeamSpeak SDK client minimal sample * * Copyright (c) TeamSpeak-Systems */ #ifdef _WIN32 #define _CRT_SECURE_NO_WARNINGS #include #else #include #include #include #endif #include #include #include #include #ifdef _WIN32 #define SLEEP(x) Sleep(x) #define strdup(x) _strdup(x) #else #define SLEEP(x) usleep(x*1000) #endif /* * Callback for connection status change. * Connection status switches through the states STATUS_DISCONNECTED, STATUS_CONNECTING, STATUS_CONNECTED and STATUS_CONNECTION_ESTABLISHED. * * Parameters: * serverConnectionHandlerID - Server connection handler ID * newStatus - New connection status, see the enum ConnectStatus in clientlib_publicdefinitions.h * errorNumber - Error code. Should be zero when connecting or actively disconnection. * Contains error state when losing connection. */ void onConnectStatusChangeEvent(uint64 serverConnectionHandlerID, int newStatus, unsigned int errorNumber) { printf("Connect status changed: %llu %d %u\n", (unsigned long long)serverConnectionHandlerID, newStatus, errorNumber); /* Failed to connect ? */ if(newStatus == STATUS_DISCONNECTED && errorNumber == ERROR_failed_connection_initialisation) { printf("Looks like there is no server running.\n"); } } /* * Callback for current channels being announced to the client after connecting to a server. * * Parameters: * serverConnectionHandlerID - Server connection handler ID * channelID - ID of the announced channel * channelParentID - ID of the parent channel */ void onNewChannelEvent(uint64 serverConnectionHandlerID, uint64 channelID, uint64 channelParentID) { /* Query channel name from channel ID */ char* name; unsigned int error; printf("onNewChannelEvent: %llu %llu %llu\n", (unsigned long long)serverConnectionHandlerID, (unsigned long long)channelID, (unsigned long long)channelParentID); if((error = ts3client_getChannelVariableAsString(serverConnectionHandlerID, channelID, CHANNEL_NAME, &name)) == ERROR_ok) { printf("New channel: %llu %s \n", (unsigned long long)channelID, name); ts3client_freeMemory(name); /* Release dynamically allocated memory only if function succeeded */ } else { char* errormsg; if(ts3client_getErrorMessage(error, &errormsg) == ERROR_ok) { printf("Error getting channel name in onNewChannelEvent: %s\n", errormsg); ts3client_freeMemory(errormsg); } } } /* * Callback for just created channels. * * Parameters: * serverConnectionHandlerID - Server connection handler ID * channelID - ID of the announced channel * channelParentID - ID of the parent channel * invokerID - ID of the client who created the channel * invokerName - Name of the client who created the channel */ void onNewChannelCreatedEvent(uint64 serverConnectionHandlerID, uint64 channelID, uint64 channelParentID, anyID invokerID, const char* invokerName, const char* invokerUniqueIdentifier) { char* name; /* Query channel name from channel ID */ if(ts3client_getChannelVariableAsString(serverConnectionHandlerID, channelID, CHANNEL_NAME, &name) != ERROR_ok) return; printf("New channel created: %s\n", name); ts3client_freeMemory(name); /* Release dynamically allocated memory only if function succeeded */ } /* * Callback when a channel was deleted. * * Parameters: * serverConnectionHandlerID - Server connection handler ID * channelID - ID of the deleted channel * invokerID - ID of the client who deleted the channel * invokerName - Name of the client who deleted the channel */ void onDelChannelEvent(uint64 serverConnectionHandlerID, uint64 channelID, anyID invokerID, const char* invokerName, const char* invokerUniqueIdentifier) { printf("Channel ID %llu deleted by %s (%u)\n", (unsigned long long)channelID, invokerName, invokerID); } /* * Called when a client joins, leaves or moves to another channel. * * Parameters: * serverConnectionHandlerID - Server connection handler ID * clientID - ID of the moved client * oldChannelID - ID of the old channel left by the client * newChannelID - ID of the new channel joined by the client * visibility - Visibility of the moved client. See the enum Visibility in clientlib_publicdefinitions.h * Values: ENTER_VISIBILITY, RETAIN_VISIBILITY, LEAVE_VISIBILITY */ void onClientMoveEvent(uint64 serverConnectionHandlerID, anyID clientID, uint64 oldChannelID, uint64 newChannelID, int visibility, const char* moveMessage) { printf("ClientID %u moves from channel %llu to %llu with message %s\n", clientID, (unsigned long long)oldChannelID, (unsigned long long)newChannelID, moveMessage); } /* * Callback for other clients in current and subscribed channels being announced to the client. * * Parameters: * serverConnectionHandlerID - Server connection handler ID * clientID - ID of the announced client * oldChannelID - ID of the subscribed channel where the client left visibility * newChannelID - ID of the subscribed channel where the client entered visibility * visibility - Visibility of the announced client. See the enum Visibility in clientlib_publicdefinitions.h * Values: ENTER_VISIBILITY, RETAIN_VISIBILITY, LEAVE_VISIBILITY */ void onClientMoveSubscriptionEvent(uint64 serverConnectionHandlerID, anyID clientID, uint64 oldChannelID, uint64 newChannelID, int visibility) { char* name; /* Query client nickname from ID */ if(ts3client_getClientVariableAsString(serverConnectionHandlerID, clientID, CLIENT_NICKNAME, &name) != ERROR_ok) return; printf("New client: %s\n", name); ts3client_freeMemory(name); /* Release dynamically allocated memory only if function succeeded */ } /* * Called when a client drops his connection. * * Parameters: * serverConnectionHandlerID - Server connection handler ID * clientID - ID of the moved client * oldChannelID - ID of the channel the leaving client was previously member of * newChannelID - 0, as client is leaving * visibility - Always LEAVE_VISIBILITY * timeoutMessage - Optional message giving the reason for the timeout */ void onClientMoveTimeoutEvent(uint64 serverConnectionHandlerID, anyID clientID, uint64 oldChannelID, uint64 newChannelID, int visibility, const char* timeoutMessage) { printf("ClientID %u timeouts with message %s\n",clientID, timeoutMessage); } /* * This event is called when a client starts or stops talking. * * Parameters: * serverConnectionHandlerID - Server connection handler ID * status - 1 if client starts talking, 0 if client stops talking * isReceivedWhisper - 1 if this event was caused by whispering, 0 if caused by normal talking * clientID - ID of the client who announced the talk status change */ void onTalkStatusChangeEvent(uint64 serverConnectionHandlerID, int status, int isReceivedWhisper, anyID clientID) { char* name; /* Query client nickname from ID */ if(ts3client_getClientVariableAsString(serverConnectionHandlerID, clientID, CLIENT_NICKNAME, &name) != ERROR_ok) return; if(status == STATUS_TALKING) { printf("Client \"%s\" starts talking.\n", name); } else { printf("Client \"%s\" stops talking.\n", name); } ts3client_freeMemory(name); /* Release dynamically allocated memory only if function succeeded */ } /* * This event is called when another client starts whispering to own client. Own client can decide to accept or deny * receiving the whisper by adding the sending client to the whisper allow list. If not added, whispering is blocked. * * Parameters: * serverConnectionHandlerID - Server connection handler ID * clientID - ID of the whispering client */ void onIgnoredWhisperEvent(uint64 serverConnectionHandlerID, anyID clientID) { unsigned int error; /* Add sending client to whisper allow list so own client will hear the voice data. * It is sufficient to add a clientID only once, not everytime this event is called. However it won't * hurt to add the same clientID to the allow list repeatedly, but is is not necessary. */ if((error = ts3client_allowWhispersFrom(serverConnectionHandlerID, clientID)) != ERROR_ok) { printf("Error setting client on whisper allow list: %u\n", error); } else { printf("Added client %d to whisper allow list\n", clientID); } } void onServerErrorEvent(uint64 serverConnectionHandlerID, const char* errorMessage, unsigned int error, const char* returnCode, const char* extraMessage) { printf("Error for server %llu: %s %s\n", (unsigned long long)serverConnectionHandlerID, errorMessage, extraMessage); } char* programPath(char* programInvocation){ char* path; char* end; int length; char pathsep; if (programInvocation == NULL) return strdup(""); #ifdef _WIN32 pathsep = '\\'; #else pathsep = '/'; #endif end = strrchr(programInvocation, pathsep); if (!end) return strdup(""); length = (end - programInvocation)+2; path = (char*) malloc(length); strncpy(path, programInvocation, length-1); path[length-1] = 0; return path; } int main(int argc, char **argv) { uint64 scHandlerID; unsigned int error; char *version; char *identity; char * path; /* Create struct for callback function pointers */ struct ClientUIFunctions funcs; /* Initialize all callbacks with NULL */ memset(&funcs, 0, sizeof(struct ClientUIFunctions)); /* Callback function pointers */ /* It is sufficient to only assign those callback functions you are using. When adding more callbacks, add those function pointers here. */ funcs.onConnectStatusChangeEvent = onConnectStatusChangeEvent; funcs.onNewChannelEvent = onNewChannelEvent; funcs.onNewChannelCreatedEvent = onNewChannelCreatedEvent; funcs.onDelChannelEvent = onDelChannelEvent; funcs.onClientMoveEvent = onClientMoveEvent; funcs.onClientMoveSubscriptionEvent = onClientMoveSubscriptionEvent; funcs.onClientMoveTimeoutEvent = onClientMoveTimeoutEvent; funcs.onTalkStatusChangeEvent = onTalkStatusChangeEvent; funcs.onServerErrorEvent = onServerErrorEvent; funcs.onIgnoredWhisperEvent = onIgnoredWhisperEvent; /* Initialize client lib with callbacks */ /* Resource path points to the SDK\bin directory to locate the soundbackends*/ path = programPath(argv[0]); error = ts3client_initClientLib(&funcs, NULL, LogType_FILE | LogType_CONSOLE, NULL, path); free(path); if(error != ERROR_ok) { char* errormsg; if(ts3client_getErrorMessage(error, &errormsg) == ERROR_ok) { printf("Error initializing serverlib: %s\n", errormsg); ts3client_freeMemory(errormsg); } return 1; } /* Spawn a new server connection handler using the default port and store the server ID */ if((error = ts3client_spawnNewServerConnectionHandler(0, &scHandlerID)) != ERROR_ok) { printf("Error spawning server connection handler: %d\n", error); return 1; } /* Open default capture device */ /* Passing empty string for mode and NULL or empty string for device will open the default device */ if((error = ts3client_openCaptureDevice(scHandlerID, "", NULL)) != ERROR_ok) { printf("Error opening capture device: %d\n", error); } /* Adjust "vad" preprocessor value to use vad by default */ if ((error = ts3client_setPreProcessorConfigValue(scHandlerID, "vad", "true")) != ERROR_ok) { printf("Error toggling VAD: %d\n", error); return 1; } /* Adjust "vad_mode" value to use hybrid by default */ if ((error = ts3client_setPreProcessorConfigValue(scHandlerID, "vad_mode", "2")) != ERROR_ok) { printf("Error setting vad_mode value to hybrid: %d\n", error); return 1; } /* Adjust "voiceactivation_level" value */ if ((error = ts3client_setPreProcessorConfigValue(scHandlerID, "voiceactivation_level", "-20")) != ERROR_ok) { printf("Error setting voiceactivation_level: %d\n", error); return 1; } /* Open default playback device */ /* Passing empty string for mode and NULL or empty string for device will open the default device */ if((error = ts3client_openPlaybackDevice(scHandlerID, "", NULL)) != ERROR_ok) { printf("Error opening playback device: %d\n", error); } /* Create a new client identity */ /* In your real application you should do this only once, store the assigned identity locally and then reuse it. */ if((error = ts3client_createIdentity(&identity)) != ERROR_ok) { printf("Error creating identity: %d\n", error); return 1; } /* Connect to server on localhost:9987 with nickname "client", no default channel, no default channel password and server password "secret" */ if((error = ts3client_startConnection(scHandlerID, identity, "localhost", 9987, "client", NULL, "", "secret")) != ERROR_ok) { printf("Error connecting to server: %d\n", error); return 1; } ts3client_freeMemory(identity); /* Release dynamically allocated memory */ identity = NULL; printf("Client lib initialized and running\n"); /* Query and print client lib version */ if((error = ts3client_getClientLibVersion(&version)) != ERROR_ok) { printf("Failed to get clientlib version: %d\n", error); return 1; } printf("Client lib version: %s\n", version); ts3client_freeMemory(version); /* Release dynamically allocated memory */ version = NULL; SLEEP(500); /* Wait for user input */ printf("\n--- Press Return to disconnect from server and exit ---\n"); getchar(); /* Disconnect from server. ERROR_not_connected just means the peer is already gone (e.g. the server was shut down) - nothing to do, so move on. */ if((error = ts3client_stopConnection(scHandlerID, "leaving")) != ERROR_ok && error != ERROR_not_connected) printf("Error stopping connection: %d\n", error); SLEEP(200); /* Destroy server connection handler */ if((error = ts3client_destroyServerConnectionHandler(scHandlerID)) != ERROR_ok) printf("Error destroying server connection handler: %d\n", error); /* Shutdown client lib */ if((error = ts3client_destroyClientLib()) != ERROR_ok) printf("Failed to destroy clientlib: %d\n", error); return 0; }