首次推送

2026-07-20 19:01:03 +08:00
parent ea01b9cf99
commit ef1bf61f9f
4484 changed files with 937163 additions and 1 deletions
@@ -0,0 +1,58 @@
+#ifndef CLIENTLIB_SDK_H
+#define CLIENTLIB_SDK_H
+
+// system
+#include <stdlib.h>
+
+// own
+#include "teamspeak/public_definitions.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @brief Sets the client to which to transmit voice. Stops standard channel voice transmission.
+ *
+ * The client will still receive voice from their current channel, however their voice will not be transmitted to their
+ * current channel anymore. If this call is successful (check onServerErrorEvent) then voice of the specified client
+ * will be transmitted to all specified channels and all the specified clients. Pass 0 to both target parameter arrays
+ * to restore default behavior of transmitting voice to current channel. You will receive an onServerErrorEvent with the
+ * passed returnCode indicating whether or not the operation was successful.
+ *
+ * @param server_connection_handler_id the connection handler on which to set the whisper list
+ * @param client_id the client to set the whisper list for. Set to 0 or your own client ID to set your own whisper list.
+ * @param channel_ids an array of channel ids to transmit voice to.
+ * @param channel_ids_size number of elements in aforementioned array.
+ * @param client_ids a zero terminated array of client ids to transmit voice to.
+ * @param client_ids_size number of elements in aforementioned array.
+ * @param impersonate if the target client is a webrtc client, the voice packets will look like as if they have been
+ * send by the invoking client id
+ * @param return_code a c string to identify this request in callbacks. Pass an empty string if unused.
+ * @return An error code from the @ref Ts3ErrorType enum indicating either success or the failure reason
+ */
+EXPORTDLL unsigned int ts_client_request_client_set_whisper_list(uint64 server_connection_handler_id, anyID client_id,
+                                                                 const uint64* channel_ids,
+                                                                 int           channel_ids_size,
+                                                                 const anyID*  client_ids,
+                                                                 int client_ids_size, int impersonate,
+                                                                 const char* return_code);
+
+/**
+ * @brief Send a binary-serialized ClientCommandRequest protobuf to the client library.
+ *
+ * The response will be delivered asynchronously via the onProtoResponse callback
+ * as a serialized ClientCommandResponse protobuf.
+ *
+ * @param data Pointer to serialized ClientCommandRequest protobuf bytes
+ * @param size Size of the serialized data in bytes
+ * @param return_code Caller-provided string to correlate the response in onProtoResponse. May be NULL.
+ * @return An error code: ERROR_ok on successful dispatch, ERROR_parameter_invalid on parse failure
+ */
+EXPORTDLL unsigned int ts3client_postProtoCommand(const void* data, size_t size, const char* return_code);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif  // CLIENTLIB_SDK_H