mirror of
https://github.com/kunkundi/crossdesk.git
synced 2025-10-27 04:35:34 +08:00
Use sourcecode for libjuice
This commit is contained in:
dijunkun
352
thirdparty/libjuice/include/juice/juice.h
vendored
352
thirdparty/libjuice/include/juice/juice.h
vendored
@@ -1,176 +1,176 @@
|
||||
/**
|
||||
* Copyright (c) 2020-2022 Paul-Louis Ageneau
|
||||
*
|
||||
* This Source Code Form is subject to the terms of the Mozilla Public
|
||||
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||
* file, You can obtain one at https://mozilla.org/MPL/2.0/.
|
||||
*/
|
||||
|
||||
#ifndef JUICE_H
|
||||
#define JUICE_H
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
#include <stdbool.h>
|
||||
#include <stddef.h>
|
||||
#include <stdint.h>
|
||||
|
||||
#ifdef JUICE_HAS_EXPORT_HEADER
|
||||
#include "juice_export.h"
|
||||
#else // no export header
|
||||
#ifdef JUICE_STATIC
|
||||
#define JUICE_EXPORT
|
||||
#else // dynamic library
|
||||
#ifdef _WIN32
|
||||
#if defined(JUICE_EXPORTS) || defined(juice_EXPORTS)
|
||||
#define JUICE_EXPORT __declspec(dllexport) // building the library
|
||||
#else
|
||||
#define JUICE_EXPORT __declspec(dllimport) // using the library
|
||||
#endif
|
||||
#else // not WIN32
|
||||
#define JUICE_EXPORT
|
||||
#endif
|
||||
#endif
|
||||
#endif
|
||||
|
||||
#define JUICE_ERR_SUCCESS 0
|
||||
#define JUICE_ERR_INVALID -1 // invalid argument
|
||||
#define JUICE_ERR_FAILED -2 // runtime error
|
||||
#define JUICE_ERR_NOT_AVAIL -3 // element not available
|
||||
|
||||
// ICE Agent
|
||||
|
||||
#define JUICE_MAX_ADDRESS_STRING_LEN 64
|
||||
#define JUICE_MAX_CANDIDATE_SDP_STRING_LEN 256
|
||||
#define JUICE_MAX_SDP_STRING_LEN 4096
|
||||
|
||||
typedef struct juice_agent juice_agent_t;
|
||||
|
||||
typedef enum juice_state {
|
||||
JUICE_STATE_DISCONNECTED = 0,
|
||||
JUICE_STATE_GATHERING,
|
||||
JUICE_STATE_CONNECTING,
|
||||
JUICE_STATE_CONNECTED,
|
||||
JUICE_STATE_COMPLETED,
|
||||
JUICE_STATE_FAILED
|
||||
} juice_state_t;
|
||||
|
||||
typedef void (*juice_cb_state_changed_t)(juice_agent_t *agent, juice_state_t state, void *user_ptr);
|
||||
typedef void (*juice_cb_candidate_t)(juice_agent_t *agent, const char *sdp, void *user_ptr);
|
||||
typedef void (*juice_cb_gathering_done_t)(juice_agent_t *agent, void *user_ptr);
|
||||
typedef void (*juice_cb_recv_t)(juice_agent_t *agent, const char *data, size_t size,
|
||||
void *user_ptr);
|
||||
|
||||
typedef struct juice_turn_server {
|
||||
const char *host;
|
||||
const char *username;
|
||||
const char *password;
|
||||
uint16_t port;
|
||||
} juice_turn_server_t;
|
||||
|
||||
typedef enum juice_concurrency_mode {
|
||||
JUICE_CONCURRENCY_MODE_POLL = 0, // Connections share a single thread
|
||||
JUICE_CONCURRENCY_MODE_MUX, // Connections are multiplexed on a single UDP socket
|
||||
JUICE_CONCURRENCY_MODE_THREAD, // Each connection runs in its own thread
|
||||
} juice_concurrency_mode_t;
|
||||
|
||||
typedef struct juice_config {
|
||||
juice_concurrency_mode_t concurrency_mode;
|
||||
|
||||
const char *stun_server_host;
|
||||
uint16_t stun_server_port;
|
||||
|
||||
juice_turn_server_t *turn_servers;
|
||||
int turn_servers_count;
|
||||
|
||||
const char *bind_address;
|
||||
|
||||
uint16_t local_port_range_begin;
|
||||
uint16_t local_port_range_end;
|
||||
|
||||
juice_cb_state_changed_t cb_state_changed;
|
||||
juice_cb_candidate_t cb_candidate;
|
||||
juice_cb_gathering_done_t cb_gathering_done;
|
||||
juice_cb_recv_t cb_recv;
|
||||
|
||||
void *user_ptr;
|
||||
|
||||
} juice_config_t;
|
||||
|
||||
JUICE_EXPORT juice_agent_t *juice_create(const juice_config_t *config);
|
||||
JUICE_EXPORT void juice_destroy(juice_agent_t *agent);
|
||||
|
||||
JUICE_EXPORT int juice_gather_candidates(juice_agent_t *agent);
|
||||
JUICE_EXPORT int juice_get_local_description(juice_agent_t *agent, char *buffer, size_t size);
|
||||
JUICE_EXPORT int juice_set_remote_description(juice_agent_t *agent, const char *sdp);
|
||||
JUICE_EXPORT int juice_add_remote_candidate(juice_agent_t *agent, const char *sdp);
|
||||
JUICE_EXPORT int juice_set_remote_gathering_done(juice_agent_t *agent);
|
||||
JUICE_EXPORT int juice_send(juice_agent_t *agent, const char *data, size_t size);
|
||||
JUICE_EXPORT int juice_send_diffserv(juice_agent_t *agent, const char *data, size_t size, int ds);
|
||||
JUICE_EXPORT juice_state_t juice_get_state(juice_agent_t *agent);
|
||||
JUICE_EXPORT int juice_get_selected_candidates(juice_agent_t *agent, char *local, size_t local_size,
|
||||
char *remote, size_t remote_size);
|
||||
JUICE_EXPORT int juice_get_selected_addresses(juice_agent_t *agent, char *local, size_t local_size,
|
||||
char *remote, size_t remote_size);
|
||||
JUICE_EXPORT const char *juice_state_to_string(juice_state_t state);
|
||||
|
||||
// ICE server
|
||||
|
||||
typedef struct juice_server juice_server_t;
|
||||
|
||||
typedef struct juice_server_credentials {
|
||||
const char *username;
|
||||
const char *password;
|
||||
int allocations_quota;
|
||||
} juice_server_credentials_t;
|
||||
|
||||
typedef struct juice_server_config {
|
||||
juice_server_credentials_t *credentials;
|
||||
int credentials_count;
|
||||
|
||||
int max_allocations;
|
||||
int max_peers;
|
||||
|
||||
const char *bind_address;
|
||||
const char *external_address;
|
||||
uint16_t port;
|
||||
|
||||
uint16_t relay_port_range_begin;
|
||||
uint16_t relay_port_range_end;
|
||||
|
||||
const char *realm;
|
||||
|
||||
} juice_server_config_t;
|
||||
|
||||
JUICE_EXPORT juice_server_t *juice_server_create(const juice_server_config_t *config);
|
||||
JUICE_EXPORT void juice_server_destroy(juice_server_t *server);
|
||||
|
||||
JUICE_EXPORT uint16_t juice_server_get_port(juice_server_t *server);
|
||||
JUICE_EXPORT int juice_server_add_credentials(juice_server_t *server,
|
||||
const juice_server_credentials_t *credentials,
|
||||
unsigned long lifetime_ms);
|
||||
|
||||
// Logging
|
||||
|
||||
typedef enum juice_log_level {
|
||||
JUICE_LOG_LEVEL_VERBOSE = 0,
|
||||
JUICE_LOG_LEVEL_DEBUG,
|
||||
JUICE_LOG_LEVEL_INFO,
|
||||
JUICE_LOG_LEVEL_WARN,
|
||||
JUICE_LOG_LEVEL_ERROR,
|
||||
JUICE_LOG_LEVEL_FATAL,
|
||||
JUICE_LOG_LEVEL_NONE
|
||||
} juice_log_level_t;
|
||||
|
||||
typedef void (*juice_log_cb_t)(juice_log_level_t level, const char *message);
|
||||
|
||||
JUICE_EXPORT void juice_set_log_level(juice_log_level_t level);
|
||||
JUICE_EXPORT void juice_set_log_handler(juice_log_cb_t cb);
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif
|
||||
/**
|
||||
* Copyright (c) 2020-2022 Paul-Louis Ageneau
|
||||
*
|
||||
* This Source Code Form is subject to the terms of the Mozilla Public
|
||||
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||
* file, You can obtain one at https://mozilla.org/MPL/2.0/.
|
||||
*/
|
||||
|
||||
#ifndef JUICE_H
|
||||
#define JUICE_H
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
#include <stdbool.h>
|
||||
#include <stddef.h>
|
||||
#include <stdint.h>
|
||||
|
||||
#ifdef JUICE_HAS_EXPORT_HEADER
|
||||
#include "juice_export.h"
|
||||
#else // no export header
|
||||
#ifdef JUICE_STATIC
|
||||
#define JUICE_EXPORT
|
||||
#else // dynamic library
|
||||
#ifdef _WIN32
|
||||
#if defined(JUICE_EXPORTS) || defined(juice_EXPORTS)
|
||||
#define JUICE_EXPORT __declspec(dllexport) // building the library
|
||||
#else
|
||||
#define JUICE_EXPORT __declspec(dllimport) // using the library
|
||||
#endif
|
||||
#else // not WIN32
|
||||
#define JUICE_EXPORT
|
||||
#endif
|
||||
#endif
|
||||
#endif
|
||||
|
||||
#define JUICE_ERR_SUCCESS 0
|
||||
#define JUICE_ERR_INVALID -1 // invalid argument
|
||||
#define JUICE_ERR_FAILED -2 // runtime error
|
||||
#define JUICE_ERR_NOT_AVAIL -3 // element not available
|
||||
|
||||
// ICE Agent
|
||||
|
||||
#define JUICE_MAX_ADDRESS_STRING_LEN 64
|
||||
#define JUICE_MAX_CANDIDATE_SDP_STRING_LEN 256
|
||||
#define JUICE_MAX_SDP_STRING_LEN 4096
|
||||
|
||||
typedef struct juice_agent juice_agent_t;
|
||||
|
||||
typedef enum juice_state {
|
||||
JUICE_STATE_DISCONNECTED = 0,
|
||||
JUICE_STATE_GATHERING,
|
||||
JUICE_STATE_CONNECTING,
|
||||
JUICE_STATE_CONNECTED,
|
||||
JUICE_STATE_COMPLETED,
|
||||
JUICE_STATE_FAILED
|
||||
} juice_state_t;
|
||||
|
||||
typedef void (*juice_cb_state_changed_t)(juice_agent_t *agent, juice_state_t state, void *user_ptr);
|
||||
typedef void (*juice_cb_candidate_t)(juice_agent_t *agent, const char *sdp, void *user_ptr);
|
||||
typedef void (*juice_cb_gathering_done_t)(juice_agent_t *agent, void *user_ptr);
|
||||
typedef void (*juice_cb_recv_t)(juice_agent_t *agent, const char *data, size_t size,
|
||||
void *user_ptr);
|
||||
|
||||
typedef struct juice_turn_server {
|
||||
const char *host;
|
||||
const char *username;
|
||||
const char *password;
|
||||
uint16_t port;
|
||||
} juice_turn_server_t;
|
||||
|
||||
typedef enum juice_concurrency_mode {
|
||||
JUICE_CONCURRENCY_MODE_POLL = 0, // Connections share a single thread
|
||||
JUICE_CONCURRENCY_MODE_MUX, // Connections are multiplexed on a single UDP socket
|
||||
JUICE_CONCURRENCY_MODE_THREAD, // Each connection runs in its own thread
|
||||
} juice_concurrency_mode_t;
|
||||
|
||||
typedef struct juice_config {
|
||||
juice_concurrency_mode_t concurrency_mode;
|
||||
|
||||
const char *stun_server_host;
|
||||
uint16_t stun_server_port;
|
||||
|
||||
juice_turn_server_t *turn_servers;
|
||||
int turn_servers_count;
|
||||
|
||||
const char *bind_address;
|
||||
|
||||
uint16_t local_port_range_begin;
|
||||
uint16_t local_port_range_end;
|
||||
|
||||
juice_cb_state_changed_t cb_state_changed;
|
||||
juice_cb_candidate_t cb_candidate;
|
||||
juice_cb_gathering_done_t cb_gathering_done;
|
||||
juice_cb_recv_t cb_recv;
|
||||
|
||||
void *user_ptr;
|
||||
|
||||
} juice_config_t;
|
||||
|
||||
JUICE_EXPORT juice_agent_t *juice_create(const juice_config_t *config);
|
||||
JUICE_EXPORT void juice_destroy(juice_agent_t *agent);
|
||||
|
||||
JUICE_EXPORT int juice_gather_candidates(juice_agent_t *agent);
|
||||
JUICE_EXPORT int juice_get_local_description(juice_agent_t *agent, char *buffer, size_t size);
|
||||
JUICE_EXPORT int juice_set_remote_description(juice_agent_t *agent, const char *sdp);
|
||||
JUICE_EXPORT int juice_add_remote_candidate(juice_agent_t *agent, const char *sdp);
|
||||
JUICE_EXPORT int juice_set_remote_gathering_done(juice_agent_t *agent);
|
||||
JUICE_EXPORT int juice_send(juice_agent_t *agent, const char *data, size_t size);
|
||||
JUICE_EXPORT int juice_send_diffserv(juice_agent_t *agent, const char *data, size_t size, int ds);
|
||||
JUICE_EXPORT juice_state_t juice_get_state(juice_agent_t *agent);
|
||||
JUICE_EXPORT int juice_get_selected_candidates(juice_agent_t *agent, char *local, size_t local_size,
|
||||
char *remote, size_t remote_size);
|
||||
JUICE_EXPORT int juice_get_selected_addresses(juice_agent_t *agent, char *local, size_t local_size,
|
||||
char *remote, size_t remote_size);
|
||||
JUICE_EXPORT const char *juice_state_to_string(juice_state_t state);
|
||||
|
||||
// ICE server
|
||||
|
||||
typedef struct juice_server juice_server_t;
|
||||
|
||||
typedef struct juice_server_credentials {
|
||||
const char *username;
|
||||
const char *password;
|
||||
int allocations_quota;
|
||||
} juice_server_credentials_t;
|
||||
|
||||
typedef struct juice_server_config {
|
||||
juice_server_credentials_t *credentials;
|
||||
int credentials_count;
|
||||
|
||||
int max_allocations;
|
||||
int max_peers;
|
||||
|
||||
const char *bind_address;
|
||||
const char *external_address;
|
||||
uint16_t port;
|
||||
|
||||
uint16_t relay_port_range_begin;
|
||||
uint16_t relay_port_range_end;
|
||||
|
||||
const char *realm;
|
||||
|
||||
} juice_server_config_t;
|
||||
|
||||
JUICE_EXPORT juice_server_t *juice_server_create(const juice_server_config_t *config);
|
||||
JUICE_EXPORT void juice_server_destroy(juice_server_t *server);
|
||||
|
||||
JUICE_EXPORT uint16_t juice_server_get_port(juice_server_t *server);
|
||||
JUICE_EXPORT int juice_server_add_credentials(juice_server_t *server,
|
||||
const juice_server_credentials_t *credentials,
|
||||
unsigned long lifetime_ms);
|
||||
|
||||
// Logging
|
||||
|
||||
typedef enum juice_log_level {
|
||||
JUICE_LOG_LEVEL_VERBOSE = 0,
|
||||
JUICE_LOG_LEVEL_DEBUG,
|
||||
JUICE_LOG_LEVEL_INFO,
|
||||
JUICE_LOG_LEVEL_WARN,
|
||||
JUICE_LOG_LEVEL_ERROR,
|
||||
JUICE_LOG_LEVEL_FATAL,
|
||||
JUICE_LOG_LEVEL_NONE
|
||||
} juice_log_level_t;
|
||||
|
||||
typedef void (*juice_log_cb_t)(juice_log_level_t level, const char *message);
|
||||
|
||||
JUICE_EXPORT void juice_set_log_level(juice_log_level_t level);
|
||||
JUICE_EXPORT void juice_set_log_handler(juice_log_cb_t cb);
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif
|
||||
|
||||
Reference in New Issue
Block a user