Amazon Kinesis Webrtc C SDK
 
Loading...
Searching...
No Matches
Include.h
Go to the documentation of this file.
1/*
2 * Main public include file
3 */
4#ifndef __KINESIS_VIDEO_WEBRTC_CLIENT_INCLUDE__
5#define __KINESIS_VIDEO_WEBRTC_CLIENT_INCLUDE__
6
7#pragma once
8
9#ifdef __cplusplus
10extern "C" {
11#endif
12
14// Public headers
16#if defined(__clang__)
17#pragma clang diagnostic push
18#pragma clang diagnostic ignored "-Wgnu-zero-variadic-macro-arguments"
19#endif
20#include <com/amazonaws/kinesis/video/client/Include.h>
21#include <com/amazonaws/kinesis/video/common/Include.h>
24#if defined(__clang__)
25#pragma clang diagnostic pop
26#endif
27
28/* TODO: Potentially move these call to PIC instead. Moving to PIC in the future would not cause any backward compatibility issues */
29
30#ifdef INCREASE_PRECISION_TIMING_LOGS
31
37#define PROFILE_CALL(f, msg) \
38 do { \
39 startTimeInMacro = GETTIME(); \
40 f; \
41 UINT64 __dt = GETTIME() - startTimeInMacro; \
42 DLOGP("[%s] Time taken: %" PRIu64 ".%02" PRIu64 " ms", (msg), __dt / HUNDREDS_OF_NANOS_IN_A_MILLISECOND, \
43 (__dt % HUNDREDS_OF_NANOS_IN_A_MILLISECOND) / (HUNDREDS_OF_NANOS_IN_A_MILLISECOND / 100)); \
44 } while (FALSE)
45
53#define PROFILE_CALL_WITH_T_OBJ(f, t, msg) \
54 do { \
55 startTimeInMacro = GETTIME(); \
56 f; \
57 UINT64 __dt = GETTIME() - startTimeInMacro; \
58 t = __dt / HUNDREDS_OF_NANOS_IN_A_MILLISECOND; \
59 DLOGP("[%s] Time taken: %" PRIu64 ".%02" PRIu64 " ms", (msg), __dt / HUNDREDS_OF_NANOS_IN_A_MILLISECOND, \
60 (__dt % HUNDREDS_OF_NANOS_IN_A_MILLISECOND) / (HUNDREDS_OF_NANOS_IN_A_MILLISECOND / 100)); \
61 } while (FALSE)
62
68#define PROFILE_WITH_START_TIME(t, msg) \
69 do { \
70 UINT64 __dt = GETTIME() - (t); \
71 DLOGP("[%s] Time taken: %" PRIu64 ".%02" PRIu64 " ms", msg, __dt / HUNDREDS_OF_NANOS_IN_A_MILLISECOND, \
72 (__dt % HUNDREDS_OF_NANOS_IN_A_MILLISECOND) / (HUNDREDS_OF_NANOS_IN_A_MILLISECOND / 100)); \
73 } while (FALSE)
74
83#define PROFILE_CALL_WITH_START_END_T_OBJ(f, s, e, d, msg) \
84 do { \
85 UINT64 __s = GETTIME(); \
86 f; \
87 UINT64 __e = GETTIME(); \
88 UINT64 __dt = __e - __s; \
89 s = __s / HUNDREDS_OF_NANOS_IN_A_MILLISECOND; \
90 e = __e / HUNDREDS_OF_NANOS_IN_A_MILLISECOND; \
91 d = ((e) - (s)); \
92 DLOGP("[%s] Time taken: %" PRIu64 ".%02" PRIu64 " ms", (msg), __dt / HUNDREDS_OF_NANOS_IN_A_MILLISECOND, \
93 (__dt % HUNDREDS_OF_NANOS_IN_A_MILLISECOND) / (HUNDREDS_OF_NANOS_IN_A_MILLISECOND / 100)); \
94 } while (FALSE)
95
103#define PROFILE_WITH_START_END_TIME_OBJ(t1, t2, d, msg) \
104 do { \
105 UINT64 __dt = GETTIME() - (t1); \
106 t1 = (t1 / HUNDREDS_OF_NANOS_IN_A_MILLISECOND); \
107 t2 = (GETTIME() / HUNDREDS_OF_NANOS_IN_A_MILLISECOND); \
108 d = ((t2) - (t1)); \
109 DLOGP("[%s] Time taken: %" PRIu64 ".%02" PRIu64 " ms", (msg), __dt / HUNDREDS_OF_NANOS_IN_A_MILLISECOND, \
110 (__dt % HUNDREDS_OF_NANOS_IN_A_MILLISECOND) / (HUNDREDS_OF_NANOS_IN_A_MILLISECOND / 100)); \
111 } while (FALSE)
112
119#define PROFILE_WITH_START_TIME_OBJ(t1, t2, msg) \
120 do { \
121 UINT64 __dt = GETTIME() - (t1); \
122 t2 = __dt / HUNDREDS_OF_NANOS_IN_A_MILLISECOND; \
123 DLOGP("[%s] Time taken: %" PRIu64 ".%02" PRIu64 " ms", (msg), __dt / HUNDREDS_OF_NANOS_IN_A_MILLISECOND, \
124 (__dt % HUNDREDS_OF_NANOS_IN_A_MILLISECOND) / (HUNDREDS_OF_NANOS_IN_A_MILLISECOND / 100)); \
125 } while (FALSE)
126
127#else // INCREASE_PRECISION_TIMING_LOGS
128
134#define PROFILE_CALL(f, msg) \
135 do { \
136 startTimeInMacro = GETTIME(); \
137 f; \
138 DLOGP("[%s] Time taken: %" PRIu64 " ms", (msg), (GETTIME() - startTimeInMacro) / HUNDREDS_OF_NANOS_IN_A_MILLISECOND); \
139 } while (FALSE)
140
148#define PROFILE_CALL_WITH_T_OBJ(f, t, msg) \
149 do { \
150 startTimeInMacro = GETTIME(); \
151 f; \
152 t = (GETTIME() - startTimeInMacro) / HUNDREDS_OF_NANOS_IN_A_MILLISECOND; \
153 DLOGP("[%s] Time taken: %" PRIu64 " ms", (msg), (t)); \
154 } while (FALSE)
155
161#define PROFILE_WITH_START_TIME(t, msg) \
162 do { \
163 DLOGP("[%s] Time taken: %" PRIu64 " ms", msg, (GETTIME() - (t)) / HUNDREDS_OF_NANOS_IN_A_MILLISECOND); \
164 } while (FALSE)
165
174#define PROFILE_CALL_WITH_START_END_T_OBJ(f, s, e, d, msg) \
175 do { \
176 s = GETTIME() / HUNDREDS_OF_NANOS_IN_A_MILLISECOND; \
177 f; \
178 e = GETTIME() / HUNDREDS_OF_NANOS_IN_A_MILLISECOND; \
179 d = ((e) - (s)); \
180 DLOGP("[%s] Time taken: %" PRIu64 " ms", (msg), (d)); \
181 } while (FALSE)
182
190#define PROFILE_WITH_START_END_TIME_OBJ(t1, t2, d, msg) \
191 do { \
192 t1 = (t1 / HUNDREDS_OF_NANOS_IN_A_MILLISECOND); \
193 t2 = (GETTIME() / HUNDREDS_OF_NANOS_IN_A_MILLISECOND); \
194 d = ((t2) - (t1)); \
195 DLOGP("[%s] Time taken: %" PRIu64 " ms", (msg), (d)); \
196 } while (FALSE)
197
204#define PROFILE_WITH_START_TIME_OBJ(t1, t2, msg) \
205 do { \
206 t2 = (GETTIME() - (t1)) / HUNDREDS_OF_NANOS_IN_A_MILLISECOND; \
207 DLOGP("[%s] Time taken: %" PRIu64 " ms", (msg), t2); \
208 } while (FALSE)
209
210#endif // INCREASE_PRECISION_TIMING_LOGS
211
218#define STATUS_WEBRTC_BASE 0x55000000
219
223
229#define STATUS_SESSION_DESCRIPTION_INIT_NOT_OBJECT STATUS_WEBRTC_BASE + 0x00000001
230#define STATUS_SESSION_DESCRIPTION_INIT_MISSING_SDP_OR_TYPE_MEMBER STATUS_WEBRTC_BASE + 0x00000002
231#define STATUS_SESSION_DESCRIPTION_INIT_INVALID_TYPE STATUS_WEBRTC_BASE + 0x00000003
232#define STATUS_SESSION_DESCRIPTION_INIT_MISSING_SDP STATUS_WEBRTC_BASE + 0x00000004
233#define STATUS_SESSION_DESCRIPTION_INIT_MISSING_TYPE STATUS_WEBRTC_BASE + 0x00000005
234#define STATUS_SESSION_DESCRIPTION_INIT_MAX_SDP_LEN_EXCEEDED STATUS_WEBRTC_BASE + 0x00000006
235#define STATUS_SESSION_DESCRIPTION_INVALID_SESSION_DESCRIPTION STATUS_WEBRTC_BASE + 0x00000007
236#define STATUS_SESSION_DESCRIPTION_MISSING_ICE_VALUES STATUS_WEBRTC_BASE + 0x00000008
237#define STATUS_SESSION_DESCRIPTION_MISSING_CERTIFICATE_FINGERPRINT STATUS_WEBRTC_BASE + 0x00000009
238#define STATUS_SESSION_DESCRIPTION_MAX_MEDIA_COUNT STATUS_WEBRTC_BASE + 0x0000000A
244
250#define STATUS_SDP_BASE STATUS_WEBRTC_BASE + 0x01000000
251#define STATUS_SDP_MISSING_ITEMS STATUS_SDP_BASE + 0x00000001
252#define STATUS_SDP_ATTRIBUTES_ERROR STATUS_SDP_BASE + 0x00000002
253#define STATUS_SDP_BANDWIDTH_ERROR STATUS_SDP_BASE + 0x00000003
254#define STATUS_SDP_CONNECTION_INFORMATION_ERROR STATUS_SDP_BASE + 0x00000004
255#define STATUS_SDP_EMAIL_ADDRESS_ERROR STATUS_SDP_BASE + 0x00000005
256#define STATUS_SDP_ENCYRPTION_KEY_ERROR STATUS_SDP_BASE + 0x00000006
257#define STATUS_SDP_INFORMATION_ERROR STATUS_SDP_BASE + 0x00000007
258#define STATUS_SDP_MEDIA_NAME_ERROR STATUS_SDP_BASE + 0x00000008
259#define STATUS_SDP_ORIGIN_ERROR STATUS_SDP_BASE + 0x00000009
260#define STATUS_SDP_PHONE_NUMBER_ERROR STATUS_SDP_BASE + 0x0000000A
261#define STATUS_SDP_TIME_DECRYPTION_ERROR STATUS_SDP_BASE + 0x0000000B
262#define STATUS_SDP_TIMEZONE_ERROR STATUS_SDP_BASE + 0x0000000C
263#define STATUS_SDP_URI_ERROR STATUS_SDP_BASE + 0x0000000D
264#define STATUS_SDP_VERSION_ERROR STATUS_SDP_BASE + 0x0000000E
265#define STATUS_SDP_ATTRIBUTE_MAX_EXCEEDED STATUS_SDP_BASE + 0x0000000F
271
276#define STATUS_STUN_BASE STATUS_SDP_BASE + 0x01000000
277#define STATUS_STUN_MESSAGE_INTEGRITY_NOT_LAST STATUS_STUN_BASE + 0x00000001
278#define STATUS_STUN_MESSAGE_INTEGRITY_SIZE_ALIGNMENT STATUS_STUN_BASE + 0x00000002
279#define STATUS_STUN_FINGERPRINT_NOT_LAST STATUS_STUN_BASE + 0x00000003
280#define STATUS_STUN_MAGIC_COOKIE_MISMATCH STATUS_STUN_BASE + 0x00000004
281#define STATUS_STUN_INVALID_ADDRESS_ATTRIBUTE_LENGTH STATUS_STUN_BASE + 0x00000005
282#define STATUS_STUN_INVALID_USERNAME_ATTRIBUTE_LENGTH STATUS_STUN_BASE + 0x00000006
283#define STATUS_STUN_INVALID_MESSAGE_INTEGRITY_ATTRIBUTE_LENGTH STATUS_STUN_BASE + 0x00000007
284#define STATUS_STUN_INVALID_FINGERPRINT_ATTRIBUTE_LENGTH STATUS_STUN_BASE + 0x00000008
285#define STATUS_STUN_MULTIPLE_MESSAGE_INTEGRITY_ATTRIBUTES STATUS_STUN_BASE + 0x00000009
286#define STATUS_STUN_MULTIPLE_FINGERPRINT_ATTRIBUTES STATUS_STUN_BASE + 0x0000000A
287#define STATUS_STUN_ATTRIBUTES_AFTER_FINGERPRINT_MESSAGE_INTEGRITY STATUS_STUN_BASE + 0x0000000B
288#define STATUS_STUN_MESSAGE_INTEGRITY_AFTER_FINGERPRINT STATUS_STUN_BASE + 0x0000000C
289#define STATUS_STUN_MAX_ATTRIBUTE_COUNT STATUS_STUN_BASE + 0x0000000D
290#define STATUS_STUN_MESSAGE_INTEGRITY_MISMATCH STATUS_STUN_BASE + 0x0000000E
291#define STATUS_STUN_FINGERPRINT_MISMATCH STATUS_STUN_BASE + 0x0000000F
292#define STATUS_STUN_INVALID_PRIORITY_ATTRIBUTE_LENGTH STATUS_STUN_BASE + 0x00000010
293#define STATUS_STUN_INVALID_USE_CANDIDATE_ATTRIBUTE_LENGTH STATUS_STUN_BASE + 0x00000011
294#define STATUS_STUN_INVALID_LIFETIME_ATTRIBUTE_LENGTH STATUS_STUN_BASE + 0x00000012
295#define STATUS_STUN_INVALID_REQUESTED_TRANSPORT_ATTRIBUTE_LENGTH STATUS_STUN_BASE + 0x00000013
296#define STATUS_STUN_INVALID_REALM_ATTRIBUTE_LENGTH STATUS_STUN_BASE + 0x00000014
297#define STATUS_STUN_INVALID_NONCE_ATTRIBUTE_LENGTH STATUS_STUN_BASE + 0x00000015
298#define STATUS_STUN_INVALID_ERROR_CODE_ATTRIBUTE_LENGTH STATUS_STUN_BASE + 0x00000016
299#define STATUS_STUN_INVALID_ICE_CONTROL_ATTRIBUTE_LENGTH STATUS_STUN_BASE + 0x00000017
300#define STATUS_STUN_INVALID_CHANNEL_NUMBER_ATTRIBUTE_LENGTH STATUS_STUN_BASE + 0x00000018
301#define STATUS_STUN_INVALID_CHANGE_REQUEST_ATTRIBUTE_LENGTH STATUS_STUN_BASE + 0x00000019
307
312#define STATUS_NETWORKING_BASE STATUS_STUN_BASE + 0x01000000
313#define STATUS_GET_LOCAL_IP_ADDRESSES_FAILED STATUS_NETWORKING_BASE + 0x00000016
314#define STATUS_CREATE_UDP_SOCKET_FAILED STATUS_NETWORKING_BASE + 0x00000017
315#define STATUS_BINDING_SOCKET_FAILED STATUS_NETWORKING_BASE + 0x00000018
316#define STATUS_GET_PORT_NUMBER_FAILED STATUS_NETWORKING_BASE + 0x00000019
317#define STATUS_SEND_DATA_FAILED STATUS_NETWORKING_BASE + 0x0000001a
318#define STATUS_RESOLVE_HOSTNAME_FAILED STATUS_NETWORKING_BASE + 0x0000001b
319#define STATUS_HOSTNAME_NOT_FOUND STATUS_NETWORKING_BASE + 0x0000001c
320#define STATUS_SOCKET_CONNECT_FAILED STATUS_NETWORKING_BASE + 0x0000001d
321#define STATUS_CREATE_SSL_FAILED STATUS_NETWORKING_BASE + 0x0000001e
322#define STATUS_SSL_CONNECTION_FAILED STATUS_NETWORKING_BASE + 0x0000001f
323#define STATUS_SECURE_SOCKET_READ_FAILED STATUS_NETWORKING_BASE + 0x00000020
324#define STATUS_SOCKET_CONNECTION_NOT_READY_TO_SEND STATUS_NETWORKING_BASE + 0x00000021
325#define STATUS_SOCKET_CONNECTION_CLOSED_ALREADY STATUS_NETWORKING_BASE + 0x00000022
326#define STATUS_SOCKET_SET_SEND_BUFFER_SIZE_FAILED STATUS_NETWORKING_BASE + 0x00000023
327#define STATUS_GET_SOCKET_FLAG_FAILED STATUS_NETWORKING_BASE + 0x00000024
328#define STATUS_SET_SOCKET_FLAG_FAILED STATUS_NETWORKING_BASE + 0x00000025
329#define STATUS_CLOSE_SOCKET_FAILED STATUS_NETWORKING_BASE + 0x00000026
330#define STATUS_CREATE_SOCKET_PAIR_FAILED STATUS_NETWORKING_BASE + 0x00000027
331#define STATUS_SOCKET_WRITE_FAILED STATUS_NETWORKING_BASE + 0X00000028
332#define STATUS_INVALID_ADDRESS_LENGTH STATUS_NETWORKING_BASE + 0X00000029
333
339
344#define STATUS_DTLS_BASE STATUS_NETWORKING_BASE + 0x01000000
345#define STATUS_CERTIFICATE_GENERATION_FAILED STATUS_DTLS_BASE + 0x00000001
346#define STATUS_SSL_CTX_CREATION_FAILED STATUS_DTLS_BASE + 0x00000002
347#define STATUS_SSL_REMOTE_CERTIFICATE_VERIFICATION_FAILED STATUS_DTLS_BASE + 0x00000003
348#define STATUS_SSL_PACKET_BEFORE_DTLS_READY STATUS_DTLS_BASE + 0x00000004
349#define STATUS_SSL_UNKNOWN_SRTP_PROFILE STATUS_DTLS_BASE + 0x00000005
350#define STATUS_SSL_INVALID_CERTIFICATE_BITS STATUS_DTLS_BASE + 0x00000006
351#define STATUS_DTLS_SESSION_ALREADY_FREED STATUS_DTLS_BASE + 0x00000007
357
362#define STATUS_ICE_BASE STATUS_DTLS_BASE + 0x01000000
363#define STATUS_ICE_AGENT_NO_SELECTED_CANDIDATE_AVAILABLE STATUS_ICE_BASE + 0x00000001
364#define STATUS_ICE_CANDIDATE_STRING_MISSING_PORT STATUS_ICE_BASE + 0x00000002
365#define STATUS_ICE_CANDIDATE_STRING_MISSING_IP STATUS_ICE_BASE + 0x00000003
366#define STATUS_ICE_CANDIDATE_STRING_INVALID_IP STATUS_ICE_BASE + 0x00000004
367#define STATUS_ICE_CANDIDATE_STRING_IS_TCP STATUS_ICE_BASE + 0x00000005
368#define STATUS_ICE_FAILED_TO_COMPUTE_MD5_FOR_LONG_TERM_CREDENTIAL STATUS_ICE_BASE + 0x00000006
369#define STATUS_ICE_URL_INVALID_PREFIX STATUS_ICE_BASE + 0x00000007
370#define STATUS_ICE_URL_TURN_MISSING_USERNAME STATUS_ICE_BASE + 0x00000008
371#define STATUS_ICE_URL_TURN_MISSING_CREDENTIAL STATUS_ICE_BASE + 0x00000009
372#define STATUS_ICE_AGENT_STATE_CHANGE_FAILED STATUS_ICE_BASE + 0x0000000a
373#define STATUS_ICE_NO_LOCAL_CANDIDATE_AVAILABLE_AFTER_GATHERING_TIMEOUT STATUS_ICE_BASE + 0x0000000b
374#define STATUS_ICE_AGENT_TERMINATED_ALREADY STATUS_ICE_BASE + 0x0000000c
375#define STATUS_ICE_NO_CONNECTED_CANDIDATE_PAIR STATUS_ICE_BASE + 0x0000000d
376#define STATUS_ICE_CANDIDATE_PAIR_LIST_EMPTY STATUS_ICE_BASE + 0x0000000e
377#define STATUS_ICE_NOMINATED_CANDIDATE_NOT_CONNECTED STATUS_ICE_BASE + 0x00000010
378#define STATUS_ICE_CANDIDATE_INIT_MALFORMED STATUS_ICE_BASE + 0x00000011
379#define STATUS_ICE_CANDIDATE_MISSING_CANDIDATE STATUS_ICE_BASE + 0x00000012
380#define STATUS_ICE_FAILED_TO_NOMINATE_CANDIDATE_PAIR STATUS_ICE_BASE + 0x00000013
381#define STATUS_ICE_MAX_REMOTE_CANDIDATE_COUNT_EXCEEDED STATUS_ICE_BASE + 0x00000014
382#define STATUS_ICE_URL_MALFORMED STATUS_ICE_BASE + 0x00000015
383#define STATUS_ICE_URL_STUNS_IP_LITERAL_NOT_ALLOWED STATUS_ICE_BASE + 0x00000016
384#define STATUS_ICE_INVALID_STATE STATUS_ICE_BASE + 0x0000001c
385#define STATUS_ICE_NO_LOCAL_HOST_CANDIDATE_AVAILABLE STATUS_ICE_BASE + 0x0000001d
386#define STATUS_ICE_NO_NOMINATED_VALID_CANDIDATE_PAIR_AVAILABLE STATUS_ICE_BASE + 0x0000001e
387#define STATUS_TURN_CONNECTION_NO_HOST_INTERFACE_FOUND STATUS_ICE_BASE + 0x0000001f
388#define STATUS_TURN_CONNECTION_STATE_TRANSITION_TIMEOUT STATUS_ICE_BASE + 0x00000020
389#define STATUS_TURN_CONNECTION_FAILED_TO_CREATE_PERMISSION STATUS_ICE_BASE + 0x00000021
390#define STATUS_TURN_CONNECTION_FAILED_TO_BIND_CHANNEL STATUS_ICE_BASE + 0x00000022
391#define STATUS_TURN_NEW_DATA_CHANNEL_MSG_HEADER_BEFORE_PREVIOUS_MSG_FINISH STATUS_ICE_BASE + 0x00000023
392#define STATUS_TURN_MISSING_CHANNEL_DATA_HEADER STATUS_ICE_BASE + 0x00000024
393#define STATUS_ICE_FAILED_TO_RECOVER_FROM_DISCONNECTION STATUS_ICE_BASE + 0x00000025
394#define STATUS_ICE_NO_AVAILABLE_ICE_CANDIDATE_PAIR STATUS_ICE_BASE + 0x00000026
395#define STATUS_TURN_CONNECTION_PEER_NOT_USABLE STATUS_ICE_BASE + 0x00000027
396#define STATUS_ICE_SERVER_INDEX_INVALID STATUS_ICE_BASE + 0x00000028
397#define STATUS_ICE_CANDIDATE_STRING_MISSING_TYPE STATUS_ICE_BASE + 0x00000029
398#define STATUS_TURN_CONNECTION_ALLOCATION_FAILED STATUS_ICE_BASE + 0x0000002a
399#define STATUS_TURN_INVALID_STATE STATUS_ICE_BASE + 0x0000002b
400#define STATUS_TURN_CONNECTION_GET_CREDENTIALS_FAILED STATUS_ICE_BASE + 0x0000002c
401#define STATUS_FAILED_TO_INIT_RELAY_CANDIDATES STATUS_ICE_BASE + 0x0000002d
402
408
413#define STATUS_SRTP_BASE STATUS_ICE_BASE + 0x01000000
414#define STATUS_SRTP_DECRYPT_FAILED STATUS_SRTP_BASE + 0x00000001
415#define STATUS_SRTP_ENCRYPT_FAILED STATUS_SRTP_BASE + 0x00000002
416#define STATUS_SRTP_TRANSMIT_SESSION_CREATION_FAILED STATUS_SRTP_BASE + 0x00000003
417#define STATUS_SRTP_RECEIVE_SESSION_CREATION_FAILED STATUS_SRTP_BASE + 0x00000004
418#define STATUS_SRTP_INIT_FAILED STATUS_SRTP_BASE + 0x00000005
419#define STATUS_SRTP_NOT_READY_YET STATUS_SRTP_BASE + 0x00000006
425
430#define STATUS_RTP_BASE STATUS_SRTP_BASE + 0x01000000
431#define STATUS_RTP_INPUT_PACKET_TOO_SMALL STATUS_RTP_BASE + 0x00000001
432#define STATUS_RTP_INPUT_MTU_TOO_SMALL STATUS_RTP_BASE + 0x00000002
433#define STATUS_RTP_INVALID_NALU STATUS_RTP_BASE + 0x00000003
434#define STATUS_RTP_INVALID_EXTENSION_LEN STATUS_RTP_BASE + 0x00000004
440
445#define STATUS_SIGNALING_BASE STATUS_RTP_BASE + 0x01000000
446#define STATUS_SIGNALING_INVALID_READY_STATE STATUS_SIGNALING_BASE + 0x00000001
447#define STATUS_SIGNALING_GET_TOKEN_CALL_FAILED STATUS_SIGNALING_BASE + 0x00000002
448#define STATUS_SIGNALING_DESCRIBE_CALL_FAILED STATUS_SIGNALING_BASE + 0x00000003
449#define STATUS_SIGNALING_CREATE_CALL_FAILED STATUS_SIGNALING_BASE + 0x00000004
450#define STATUS_SIGNALING_GET_ENDPOINT_CALL_FAILED STATUS_SIGNALING_BASE + 0x00000005
451#define STATUS_SIGNALING_GET_ICE_CONFIG_CALL_FAILED STATUS_SIGNALING_BASE + 0x00000006
452#define STATUS_SIGNALING_READY_CALLBACK_FAILED STATUS_SIGNALING_BASE + 0x00000007
453#define STATUS_SIGNALING_CONNECT_CALL_FAILED STATUS_SIGNALING_BASE + 0x00000008
454#define STATUS_SIGNALING_CONNECTED_CALLBACK_FAILED STATUS_SIGNALING_BASE + 0x00000009
455#define STATUS_SIGNALING_INVALID_CHANNEL_INFO_VERSION STATUS_SIGNALING_BASE + 0x0000000A
456#define STATUS_SIGNALING_INVALID_SIGNALING_CALLBACKS_VERSION STATUS_SIGNALING_BASE + 0x0000000B
457#define STATUS_SIGNALING_INVALID_CHANNEL_NAME_LENGTH STATUS_SIGNALING_BASE + 0x0000000C
458#define STATUS_SIGNALING_INVALID_CHANNEL_ARN_LENGTH STATUS_SIGNALING_BASE + 0x0000000D
459#define STATUS_SIGNALING_INVALID_REGION_LENGTH STATUS_SIGNALING_BASE + 0x0000000E
460#define STATUS_SIGNALING_INVALID_CPL_LENGTH STATUS_SIGNALING_BASE + 0x0000000F
461#define STATUS_SIGNALING_INVALID_CERTIFICATE_PATH_LENGTH STATUS_SIGNALING_BASE + 0x00000010
462#define STATUS_SIGNALING_INVALID_AGENT_POSTFIX_LENGTH STATUS_SIGNALING_BASE + 0x00000011
463#define STATUS_SIGNALING_INVALID_AGENT_LENGTH STATUS_SIGNALING_BASE + 0x00000012
464#define STATUS_SIGNALING_INVALID_KMS_KEY_LENGTH STATUS_SIGNALING_BASE + 0x00000013
465#define STATUS_SIGNALING_LWS_CREATE_CONTEXT_FAILED STATUS_SIGNALING_BASE + 0x00000014
466#define STATUS_SIGNALING_LWS_CLIENT_CONNECT_FAILED STATUS_SIGNALING_BASE + 0x00000015
467#define STATUS_SIGNALING_CHANNEL_BEING_DELETED STATUS_SIGNALING_BASE + 0x00000016
468#define STATUS_SIGNALING_INVALID_CLIENT_INFO_VERSION STATUS_SIGNALING_BASE + 0x00000017
469#define STATUS_SIGNALING_INVALID_CLIENT_INFO_CLIENT_LENGTH STATUS_SIGNALING_BASE + 0x00000018
470#define STATUS_SIGNALING_MAX_ICE_CONFIG_COUNT STATUS_SIGNALING_BASE + 0x00000019
471#define STATUS_SIGNALING_MAX_ICE_URI_COUNT STATUS_SIGNALING_BASE + 0x0000001A
472#define STATUS_SIGNALING_MAX_ICE_URI_LEN STATUS_SIGNALING_BASE + 0x0000001B
473#define STATUS_SIGNALING_NO_CONFIG_SPECIFIED STATUS_SIGNALING_BASE + 0x0000001C
474#define STATUS_SIGNALING_INVALID_ICE_CONFIG_INFO_VERSION STATUS_SIGNALING_BASE + 0x0000001D
475#define STATUS_SIGNALING_NO_CONFIG_URI_SPECIFIED STATUS_SIGNALING_BASE + 0x0000001E
476#define STATUS_SIGNALING_NO_ARN_RETURNED_ON_CREATE STATUS_SIGNALING_BASE + 0x0000001F
477#define STATUS_SIGNALING_MISSING_ENDPOINTS_IN_GET_ENDPOINT STATUS_SIGNALING_BASE + 0x00000020
478#define STATUS_SIGNALING_INVALID_MESSAGE_TYPE STATUS_SIGNALING_BASE + 0x00000021
479#define STATUS_SIGNALING_INVALID_SIGNALING_MESSAGE_VERSION STATUS_SIGNALING_BASE + 0x00000022
480#define STATUS_SIGNALING_NO_PEER_CLIENT_ID_IN_MESSAGE STATUS_SIGNALING_BASE + 0x00000023
481#define STATUS_SIGNALING_MESSAGE_DELIVERY_FAILED STATUS_SIGNALING_BASE + 0x00000024
482#define STATUS_SIGNALING_MAX_MESSAGE_LEN_AFTER_ENCODING STATUS_SIGNALING_BASE + 0x00000025
483#define STATUS_SIGNALING_RECEIVE_BINARY_DATA_NOT_SUPPORTED STATUS_SIGNALING_BASE + 0x00000026
484#define STATUS_SIGNALING_RECEIVE_EMPTY_DATA_NOT_SUPPORTED STATUS_SIGNALING_BASE + 0x00000027
485#define STATUS_SIGNALING_RECEIVED_MESSAGE_LARGER_THAN_MAX_DATA_LEN STATUS_SIGNALING_BASE + 0x00000028
486#define STATUS_SIGNALING_INVALID_PAYLOAD_LEN_IN_MESSAGE STATUS_SIGNALING_BASE + 0x00000029
487#define STATUS_SIGNALING_NO_PAYLOAD_IN_MESSAGE STATUS_SIGNALING_BASE + 0x0000002A
488#define STATUS_SIGNALING_DUPLICATE_MESSAGE_BEING_SENT STATUS_SIGNALING_BASE + 0x0000002B
489#define STATUS_SIGNALING_ICE_TTL_LESS_THAN_GRACE_PERIOD STATUS_SIGNALING_BASE + 0x0000002C
490#define STATUS_SIGNALING_DISCONNECTED_CALLBACK_FAILED STATUS_SIGNALING_BASE + 0x0000002D
491#define STATUS_SIGNALING_INVALID_MESSAGE_TTL_VALUE STATUS_SIGNALING_BASE + 0x0000002E
492#define STATUS_SIGNALING_ICE_CONFIG_REFRESH_FAILED STATUS_SIGNALING_BASE + 0x0000002F
493#define STATUS_SIGNALING_RECONNECT_FAILED STATUS_SIGNALING_BASE + 0x00000030
494#define STATUS_SIGNALING_DELETE_CALL_FAILED STATUS_SIGNALING_BASE + 0x00000031
495#define STATUS_SIGNALING_INVALID_METRICS_VERSION STATUS_SIGNALING_BASE + 0x00000032
496#define STATUS_SIGNALING_INVALID_CLIENT_INFO_CACHE_FILE_PATH_LEN STATUS_SIGNALING_BASE + 0x00000033
497#define STATUS_SIGNALING_LWS_CALL_FAILED STATUS_SIGNALING_BASE + 0x00000034
498#define STATUS_SIGNALING_INVALID_STREAM_ARN_LENGTH STATUS_SIGNALING_BASE + 0x00000035
499#define STATUS_SIGNALING_MISMATCH_MEDIA_STORAGE_CONFIG STATUS_SIGNALING_BASE + 0x00000036
500#define STATUS_SIGNALING_UPDATE_MEDIA_STORAGE_CONFIG STATUS_SIGNALING_BASE + 0x00000037
501#define STATUS_SIGNALING_MEDIA_STORAGE_DISABLED STATUS_SIGNALING_BASE + 0x00000038
502#define STATUS_SIGNALING_INVALID_CHANNEL_ARN STATUS_SIGNALING_BASE + 0x00000039
503#define STATUS_SIGNALING_JOIN_SESSION_CALL_FAILED STATUS_SIGNALING_BASE + 0x0000004a
504#define STATUS_SIGNALING_JOIN_SESSION_CONNECTED_FAILED STATUS_SIGNALING_BASE + 0x0000004b
505#define STATUS_SIGNALING_DESCRIBE_MEDIA_CALL_FAILED STATUS_SIGNALING_BASE + 0x0000004c
506
512
518#define STATUS_PEERCONNECTION_BASE STATUS_SIGNALING_BASE + 0x01000000
519#define STATUS_PEERCONNECTION_CREATE_ANSWER_WITHOUT_REMOTE_DESCRIPTION STATUS_PEERCONNECTION_BASE + 0x00000001
520#define STATUS_PEERCONNECTION_CODEC_INVALID STATUS_PEERCONNECTION_BASE + 0x00000002
521#define STATUS_PEERCONNECTION_CODEC_MAX_EXCEEDED STATUS_PEERCONNECTION_BASE + 0x00000003
522#define STATUS_PEERCONNECTION_EARLY_DNS_RESOLUTION_FAILED STATUS_PEERCONNECTION_BASE + 0x00000004
528
533#define STATUS_SCTP_BASE STATUS_PEERCONNECTION_BASE + 0x01000000
534#define STATUS_SCTP_SESSION_SETUP_FAILED STATUS_SCTP_BASE + 0x00000001
535#define STATUS_SCTP_INVALID_DCEP_PACKET STATUS_SCTP_BASE + 0x00000002
536#define STATUS_SCTP_SENDV_FAILED STATUS_SCTP_BASE + 0x00000003
542
547#define STATUS_RTCP_BASE STATUS_SCTP_BASE + 0x01000000
548#define STATUS_RTCP_INPUT_PACKET_TOO_SMALL STATUS_RTCP_BASE + 0x00000001
549#define STATUS_RTCP_INPUT_PACKET_INVALID_VERSION STATUS_RTCP_BASE + 0x00000002
550#define STATUS_RTCP_INPUT_PACKET_LEN_MISMATCH STATUS_RTCP_BASE + 0x00000003
551#define STATUS_RTCP_INPUT_NACK_LIST_INVALID STATUS_RTCP_BASE + 0x00000004
552#define STATUS_RTCP_INPUT_SSRC_INVALID STATUS_RTCP_BASE + 0x00000005
553#define STATUS_RTCP_INPUT_PARTIAL_PACKET STATUS_RTCP_BASE + 0x00000006
554#define STATUS_RTCP_INPUT_REMB_TOO_SMALL STATUS_RTCP_BASE + 0x00000007
555#define STATUS_RTCP_INPUT_REMB_INVALID STATUS_RTCP_BASE + 0x00000008
561
567#define STATUS_ROLLING_BUFFER_BASE STATUS_RTCP_BASE + 0x01000000
568#define STATUS_ROLLING_BUFFER_NOT_IN_RANGE STATUS_ROLLING_BUFFER_BASE + 0x00000001
574
583#define MAX_CHANNEL_NAME_LEN 256
584
588#define MAX_SIGNALING_CLIENT_ID_LEN 256
589
594#define MAX_ICE_CONFIG_USER_NAME_LEN 256
595
601#define MAX_ICE_CONFIG_USER_NAME_BUFFER_LEN (MAX_ICE_CONFIG_USER_NAME_LEN + 1)
602
608#define MAX_ICE_CONFIG_CREDENTIAL_LEN 256
609
615#define MAX_ICE_CONFIG_CREDENTIAL_BUFFER_LEN (MAX_ICE_CONFIG_CREDENTIAL_LEN + 1)
616
620#define MAX_SIGNALING_ENDPOINT_URI_LEN 512
621
625#define MAX_CONTROL_PLANE_URI_CHAR_LEN 256
626
630#define MAX_CORRELATION_ID_LEN 256
631
635#define MAX_ERROR_TYPE_STRING_LEN 256
636
640#define MAX_STATUS_CODE_STRING_LEN 8
641
645#define MAX_MESSAGE_DESCRIPTION_LEN 1024
646
650#define MAX_SESSION_DESCRIPTION_INIT_SDP_LEN 25000
651
655#define MAX_MEDIA_STREAM_ID_LEN 255
656
660#define MAX_RTCCONFIGURATION_CERTIFICATES 3
661
665#define MAX_MEDIA_STREAM_TRACK_ID_LEN 255
666
670#define MAX_ICE_CANDIDATE_INIT_CANDIDATE_LEN 255
671
675#define MAX_DATA_CHANNEL_NAME_LEN 255
676
680#define MAX_DATA_CHANNEL_PROTOCOL_LEN 255
681
685#define MAX_SIGNALING_MESSAGE_LEN 18750
691
699#define PEER_CONNECTION_CURRENT_VERSION 0
700
704#define CHANNEL_INFO_CURRENT_VERSION 1
705
709#define SIGNALING_CLIENT_INFO_CURRENT_VERSION 2
710
714#define SIGNALING_CLIENT_CALLBACKS_CURRENT_VERSION 0
715
719#define SIGNALING_CLIENT_CURRENT_VERSION 1
720
724#define SIGNALING_CHANNEL_DESCRIPTION_CURRENT_VERSION 0
725
729#define SIGNALING_ICE_CONFIG_INFO_CURRENT_VERSION 0
730
734#define SIGNALING_MESSAGE_CURRENT_VERSION 0
735
739#define RTC_ICE_METRICS_CURRENT_VERSION 0
740
744#define RTC_STREAM_METRICS_CURRENT_VERSION 0
745
749#define SIGNALING_CLIENT_METRICS_CURRENT_VERSION 1
750
754#define PEER_CONNECTION_METRICS_CURRENT_VERSION 0
755
759#define ICE_AGENT_METRICS_CURRENT_VERSION 0
760
766
774#define MAX_ICE_CONFIG_URI_COUNT 4
775
779#define MAX_ICE_CONFIG_COUNT 5
780
786#define MAX_ICE_SERVERS_COUNT (MAX_ICE_CONFIG_COUNT * MAX_ICE_CONFIG_URI_COUNT + 1)
792
800#define SIGNALING_CREATE_TIMEOUT (10 * HUNDREDS_OF_NANOS_IN_A_SECOND)
801
805#define SIGNALING_CONNECT_STATE_TIMEOUT (15 * HUNDREDS_OF_NANOS_IN_A_SECOND)
806
810#define SIGNALING_DISCONNECT_STATE_TIMEOUT (15 * HUNDREDS_OF_NANOS_IN_A_SECOND)
811
815#define SIGNALING_REFRESH_ICE_CONFIG_STATE_TIMEOUT (20 * HUNDREDS_OF_NANOS_IN_A_SECOND)
816
820#define SIGNALING_CONNECT_TIMEOUT (5 * HUNDREDS_OF_NANOS_IN_A_SECOND)
821
825#define THREADPOOL_MIN_THREADS 3
826
830#define THREADPOOL_MAX_THREADS 10
831
835#define WEBRTC_THREADPOOL_MIN_THREADS_ENV_VAR (PCHAR) "AWS_KVS_WEBRTC_THREADPOOL_MIN_THREADS"
836
840#define WEBRTC_THREADPOOL_MAX_THREADS_ENV_VAR (PCHAR) "AWS_KVS_WEBRTC_THREADPOOL_MAX_THREADS"
841
845#define USE_DUAL_STACK_ENDPOINTS_ENV_VAR ((PCHAR) "KVS_DUALSTACK_ENDPOINTS")
846
850#define DISABLE_IPV4_TURN_ENV_VAR ((PCHAR) "KVS_DISABLE_IPV4_TURN")
851#define DISABLE_IPV6_TURN_ENV_VAR ((PCHAR) "KVS_DISABLE_IPV6_TURN")
852
853#ifdef _WIN32
857#define SIGNALING_SEND_TIMEOUT (15 * HUNDREDS_OF_NANOS_IN_A_SECOND)
858#else
862#define SIGNALING_SEND_TIMEOUT (5 * HUNDREDS_OF_NANOS_IN_A_SECOND)
863#endif
867#define SIGNALING_DELETE_TIMEOUT (5 * HUNDREDS_OF_NANOS_IN_A_SECOND)
868
872#define SIGNALING_DEFAULT_MESSAGE_TTL_VALUE (60 * HUNDREDS_OF_NANOS_IN_A_SECOND)
873
874#define SIGNALING_JOIN_STORAGE_SESSION_WAIT_TIMEOUT (6 * HUNDREDS_OF_NANOS_IN_A_SECOND)
875
879#define DEFAULT_JITTER_BUFFER_MAX_LATENCY (2000L * HUNDREDS_OF_NANOS_IN_A_MILLISECOND)
885#define SIGNALING_VALID_NAME_CHARS "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_.-"
886
890#define MAX_RTP_SEQUENCE_NUM ((UINT32) MAX_UINT16)
891
895#define MAX_RTP_TIMESTAMP ((UINT32) MAX_UINT32)
896
900#define KINESIS_VIDEO_STUN_URL_POSTFIX "amazonaws.com"
901#define KINESIS_VIDEO_STUN_URL_POSTFIX_CN "amazonaws.com.cn"
902#define KINESIS_VIDEO_STUN_URL_PREFIX "stun."
903#define KINESIS_VIDEO_STUN_URL_PREFIX_LENGTH 5
904#define KINESIS_VIDEO_STUN_URL "stun:stun.kinesisvideo.%s.%s:443"
905#define KINESIS_VIDEO_STUNS_URL "stuns:stun.kinesisvideo-fips.%s.%s:443"
906#define KINESIS_VIDEO_STUN_URL_WITHOUT_PORT "stun.kinesisvideo.%s.%s"
907#define KINESIS_VIDEO_STUNS_URL_WITHOUT_PORT "stun.kinesisvideo-fips.%s.%s"
908#define KINESIS_VIDEO_DUALSTACK_STUN_URL_POSTFIX "api.aws"
909#define KINESIS_VIDEO_DUALSTACK_STUN_URL_POSTFIX_CN "api.amazonwebservices.com.cn"
910
914#define SIGNALING_DEFAULT_SSL_PORT DEFAULT_SSL_PORT_NUMBER
915
919#define SIGNALING_DEFAULT_NON_SSL_PORT DEFAULT_NON_SSL_PORT_NUMBER
920
921/* CHK_LOG_ERR_NV has been replaced with CHK_LOG_ERR. */
922#define CHK_LOG_ERR_NV(condition) DLOGE("CHK_LOG_ERR_NV has been replaced with CHK_LOG_ERR");
923
927#define SIGNALING_STATES_DEFAULT_RETRY_COUNT 1
928
932#define SIGNALING_DEFAULT_API_CALL_CACHE_TTL (10 * HUNDREDS_OF_NANOS_IN_AN_HOUR)
933
937#define SIGNALING_API_CALL_CACHE_TTL_SENTINEL_VALUE 0
938
942#define CREATE_SIGNALING_CLIENT_RETRY_ATTEMPTS_SENTINEL_VALUE -1
943
949
953#ifndef INVALID_SIGNALING_CLIENT_HANDLE_VALUE
954#define INVALID_SIGNALING_CLIENT_HANDLE_VALUE ((SIGNALING_CLIENT_HANDLE) INVALID_PIC_HANDLE_VALUE)
955#endif
956
960#ifndef IS_VALID_SIGNALING_CLIENT_HANDLE
961#define IS_VALID_SIGNALING_CLIENT_HANDLE(h) ((h) != INVALID_SIGNALING_CLIENT_HANDLE_VALUE)
962#endif
963
967
987
991typedef enum {
994} SDP_TYPE;
995
1003
1007typedef enum {
1015 // RTC_CODEC_MAX **MUST** be the last enum in the list **ALWAYS** and not assigned a value
1018
1030
1044
1054
1067
1098
1106
1115
1127
1155
1161
1172typedef VOID (*RtcOnFrame)(UINT64, PFrame);
1173
1181typedef VOID (*RtcOnBandwidthEstimation)(UINT64, DOUBLE);
1182
1198typedef VOID (*RtcOnSenderBandwidthEstimation)(UINT64, UINT32, UINT32, UINT32, UINT32, UINT64);
1199
1209typedef VOID (*RtcOnPictureLoss)(UINT64);
1210
1222
1228typedef VOID (*RtcOnMessage)(UINT64, PRtcDataChannel, BOOL, PBYTE, UINT32);
1229
1235typedef VOID (*RtcOnOpen)(UINT64, PRtcDataChannel);
1236
1243typedef VOID (*RtcOnDataChannel)(UINT64, PRtcDataChannel);
1244
1250typedef VOID (*RtcOnIceCandidate)(UINT64, PCHAR);
1251
1256typedef BOOL (*IceSetInterfaceFilterFunc)(UINT64, PCHAR);
1257
1269
1284
1296
1309
1320
1332
1337typedef struct {
1338 // The certificate bits and the size
1341
1342 // The private key bits and the size in bytes
1346
1395
1427
1441
1452
1456typedef struct {
1457 UINT32 version;
1458
1460
1461 CHAR correlationId[MAX_CORRELATION_ID_LEN + 1];
1462
1463 CHAR peerClientId[MAX_SIGNALING_CLIENT_ID_LEN + 1];
1464
1465 UINT32 payloadLen;
1466
1467 CHAR payload[MAX_SIGNALING_MESSAGE_LEN + 1];
1469
1483
1505
1509typedef struct {
1510 UINT32 version;
1511
1513
1518
1519 PCHAR pRegion;
1521
1524
1526
1529
1531
1533
1535
1537
1539
1541
1546
1547 BOOL retry;
1548
1550
1551 UINT64 messageTtl;
1553
1554 UINT32 tagCount;
1555
1556 PTag pTags;
1557
1558 /* --- V1 members --- */
1559
1561
1565
1567
1569
1586
1587typedef struct {
1589 CHAR storageStreamArn[MAX_ARN_LEN + 1];
1609
1625typedef STATUS (*SignalingClientErrorReportFunc)(UINT64, STATUS, PCHAR, UINT32);
1626
1658
1662typedef struct {
1663 UINT32 version;
1664 CHAR channelArn[MAX_ARN_LEN + 1];
1665 CHAR channelName[MAX_CHANNEL_NAME_LEN + 1];
1668 CHAR updateVersion[MAX_UPDATE_VERSION_LEN + 1];
1670 UINT64 messageTtl;
1674
1683
1705
1724
1737
1748
1756
1764
1774
1795
1812
1824
1832PUBLIC_API STATUS freePeerConnection(PRtcPeerConnection*);
1833
1847
1858
1869
1880
1890
1900
1913
1926
1939
1949PUBLIC_API STATUS serializeSessionDescriptionInit(PRtcSessionDescriptionInit, PCHAR, PUINT32);
1950
1960PUBLIC_API STATUS deserializeSessionDescriptionInit(PCHAR, UINT32, PRtcSessionDescriptionInit);
1961
1971PUBLIC_API STATUS deserializeRtcIceCandidateInit(PCHAR, UINT32, PRtcIceCandidateInit);
1972
1985
1998
2009PUBLIC_API STATUS restartIce(PRtcPeerConnection);
2010
2020PUBLIC_API STATUS closePeerConnection(PRtcPeerConnection);
2021
2035
2045PUBLIC_API STATUS transceiverOnFrame(PRtcRtpTransceiver, UINT64, RtcOnFrame);
2046
2057
2068
2079PUBLIC_API STATUS freeTransceiver(PRtcRtpTransceiver*);
2080
2086PUBLIC_API STATUS initKvsWebRtc(VOID);
2087
2093PUBLIC_API STATUS deinitKvsWebRtc(VOID);
2094
2106
2115PUBLIC_API STATUS writeFrame(PRtcRtpTransceiver, PFrame);
2116
2123
2137PUBLIC_API STATUS addIceCandidate(PRtcPeerConnection, PCHAR);
2138
2156
2166PUBLIC_API STATUS dataChannelOnMessage(PRtcDataChannel, UINT64, RtcOnMessage);
2167
2177PUBLIC_API STATUS dataChannelOnOpen(PRtcDataChannel, UINT64, RtcOnOpen);
2178
2192PUBLIC_API STATUS dataChannelSend(PRtcDataChannel, BOOL, PBYTE, UINT32);
2193
2207PUBLIC_API STATUS discoverNatBehavior(PCHAR, NAT_BEHAVIOR*, NAT_BEHAVIOR*, IceSetInterfaceFilterFunc, UINT64);
2208
2217PUBLIC_API PCHAR getNatBehaviorStr(NAT_BEHAVIOR natBehavior);
2218
2232
2243
2256
2268
2283
2293
2304
2313
2323
2332PUBLIC_API STATUS signalingClientGetStateString(SIGNALING_CLIENT_STATE, PCHAR*);
2333
2351
2359
2367
2375
2394
2402PUBLIC_API STATUS createRtcCertificate(PRtcCertificate*);
2403
2411PUBLIC_API STATUS freeRtcCertificate(PRtcCertificate);
2412
2414#ifdef __cplusplus
2415}
2416#endif
2417#endif /* __KINESIS_VIDEO_WEBRTC_CLIENT_INCLUDE__ */
CHAR DOMString[255U+1]
DOMString type is used to store strings of size 256 bytes (inclusive of '\0' character.
Definition Stats.h:91
RTC_STATS_TYPE
Type of Stats object requested by the application Reference https://www.w3.org/TR/webrtc-stats/#rtcst...
Definition Stats.h:115
VOID(* RtcOnOpen)(UINT64, PRtcDataChannel)
Definition Include.h:1235
STATUS(* SignalingClientErrorReportFunc)(UINT64, STATUS, PCHAR, UINT32)
Definition Include.h:1625
VOID(* RtcOnMessage)(UINT64, PRtcDataChannel, BOOL, PBYTE, UINT32)
RtcOnMessage is fired when a message is received for the DataChannel.
Definition Include.h:1228
STATUS(* SignalingClientMessageReceivedFunc)(UINT64, PReceivedSignalingMessage)
Definition Include.h:1608
VOID(* RtcOnDataChannel)(UINT64, PRtcDataChannel)
RtcOnDataChannel is fired when the remote PeerConnection creates a new DataChannel.
Definition Include.h:1243
struct __RtcDataChannel * PRtcDataChannel
VOID(* RtcOnSenderBandwidthEstimation)(UINT64, UINT32, UINT32, UINT32, UINT32, UINT64)
RtcOnSenderBandwidthEstimation is fired everytime a bandwidth estimation value is computed by sender....
Definition Include.h:1198
VOID(* RtcOnFrame)(UINT64, PFrame)
RtcOnFrame is fired everytime a frame is received from the remote peer. It is available via the RtpRe...
Definition Include.h:1172
STATUS(* SignalingClientStateChangedFunc)(UINT64, SIGNALING_CLIENT_STATE)
Definition Include.h:1640
struct __RtcDataChannel RtcDataChannel
RtcDataChannel represents a bi-directional data channel between two peers.
VOID(* RtcOnIceCandidate)(UINT64, PCHAR)
RtcOnIceCandidate is fired when new iceCandidate is found. if PCHAR is NULL then candidate gathering ...
Definition Include.h:1250
BOOL(* IceSetInterfaceFilterFunc)(UINT64, PCHAR)
IceSetInterfaceFilterFunc is fired when a callback function to filter network interfaces is assigned....
Definition Include.h:1256
VOID(* RtcOnPictureLoss)(UINT64)
RtcOnPictureLoss is fired everytime a Picture Loss Indication (PLI) feedback message is received....
Definition Include.h:1209
VOID(* RtcOnConnectionStateChange)(UINT64, RTC_PEER_CONNECTION_STATE)
RtcOnConnectionStateChange is fired to report a change in peer connection state.
Definition Include.h:1263
VOID(* RtcOnBandwidthEstimation)(UINT64, DOUBLE)
RtcOnBandwidthEstimation is fired everytime a bandwidth estimation value is computed....
Definition Include.h:1181
#define MAX_ICE_CONFIG_URI_COUNT
Definition Include.h:774
#define MAX_ICE_SERVERS_COUNT
Definition Include.h:786
#define MAX_MEDIA_STREAM_ID_LEN
Definition Include.h:655
#define MAX_ICE_CONFIG_CREDENTIAL_BUFFER_LEN
Definition Include.h:615
#define MAX_RTCCONFIGURATION_CERTIFICATES
Definition Include.h:660
#define MAX_DATA_CHANNEL_PROTOCOL_LEN
Definition Include.h:680
#define MAX_MESSAGE_DESCRIPTION_LEN
Definition Include.h:645
#define MAX_SESSION_DESCRIPTION_INIT_SDP_LEN
Definition Include.h:650
#define MAX_SIGNALING_MESSAGE_LEN
Definition Include.h:685
#define MAX_ICE_CANDIDATE_INIT_CANDIDATE_LEN
Definition Include.h:670
#define MAX_ERROR_TYPE_STRING_LEN
Definition Include.h:635
#define MAX_CORRELATION_ID_LEN
Definition Include.h:630
#define MAX_SIGNALING_CLIENT_ID_LEN
Definition Include.h:588
#define MAX_CHANNEL_NAME_LEN
Definition Include.h:583
#define MAX_ICE_CONFIG_USER_NAME_BUFFER_LEN
Definition Include.h:601
#define MAX_DATA_CHANNEL_NAME_LEN
Definition Include.h:675
RTC_PEER_CONNECTION_STATE
RTC_PEER_CONNECTION_STATE Stats of RTC peer connection.
Definition Include.h:977
RTC_RTP_TRANSCEIVER_DIRECTION
RTC_RTP_TRANSCEIVER_DIRECTION indicates direction of a transceiver.
Definition Include.h:1036
SIGNALING_CLIENT_STATE
Defines different states a signaling client traverses.
Definition Include.h:1071
SIGNALING_CHANNEL_ROLE_TYPE
Channel role type.
Definition Include.h:1110
SIGNALING_CHANNEL_TYPE
Channel type as reported by the service.
Definition Include.h:1102
SIGNALING_MESSAGE_TYPE
Defines different signaling messages.
Definition Include.h:1058
RTC_CODEC
The enum specifies the codec types for audio and video tracks.
Definition Include.h:1007
ICE_TRANSPORT_POLICY
ICE_TRANSPORT_POLICY restrict which ICE candidates are used in a session.
Definition Include.h:1024
MEDIA_STREAM_TRACK_KIND
The enum specifies the type of track in the stream.
Definition Include.h:999
SDP_TYPE
Definition Include.h:991
enum SIGNALING_CLIENT_STATE * PSIGNALING_CLIENT_STATE
SIGNALING_API_CALL_CACHE_TYPE
Type of caching implementation to use with the signaling client.
Definition Include.h:1131
SIGNALING_CHANNEL_STATUS
Defines channel status as reported by the service.
Definition Include.h:1048
NAT_BEHAVIOR
Detected network environment.
Definition Include.h:1119
@ RTC_PEER_CONNECTION_STATE_NONE
Starting state of peer connection.
Definition Include.h:978
@ RTC_PEER_CONNECTION_TOTAL_STATE_COUNT
This state indicates maximum number of Peer connection states.
Definition Include.h:985
@ RTC_PEER_CONNECTION_STATE_DISCONNECTED
This state is set when ICE Agent is disconnected.
Definition Include.h:982
@ RTC_PEER_CONNECTION_STATE_CONNECTING
This state is set when ICE agent checks connection.
Definition Include.h:980
@ RTC_PEER_CONNECTION_STATE_FAILED
This state is set when ICE Agent transitions to fail state.
Definition Include.h:983
@ RTC_PEER_CONNECTION_STATE_NEW
This state is set when ICE Agent is waiting for remote credential.
Definition Include.h:979
@ RTC_PEER_CONNECTION_STATE_CLOSED
This state leads to termination of streaming session.
Definition Include.h:984
@ RTC_PEER_CONNECTION_STATE_CONNECTED
This state is set when CIE Agent is ready.
Definition Include.h:981
@ RTC_RTP_TRANSCEIVER_DIRECTION_INACTIVE
This indicates that the peer can not send or receive data.
Definition Include.h:1041
@ RTC_RTP_TRANSCEIVER_DIRECTION_MAX
Sentinel for validation, keep last.
Definition Include.h:1042
@ RTC_RTP_TRANSCEIVER_DIRECTION_SENDRECV
This indicates that peer can send and receive data.
Definition Include.h:1038
@ RTC_RTP_TRANSCEIVER_DIRECTION_SENDONLY
This indicates that the peer can only send information.
Definition Include.h:1039
@ RTC_RTP_TRANSCEIVER_DIRECTION_UNINITIALIZED
Will use the default "sendrecv" after initialization.
Definition Include.h:1037
@ RTC_RTP_TRANSCEIVER_DIRECTION_RECVONLY
This indicates that the peer can only receive information.
Definition Include.h:1040
@ SIGNALING_CLIENT_STATE_UNKNOWN
Starting state of signaling client.
Definition Include.h:1072
@ SIGNALING_CLIENT_STATE_JOIN_SESSION
Definition Include.h:1092
@ SIGNALING_CLIENT_STATE_DESCRIBE_MEDIA
Definition Include.h:1091
@ SIGNALING_CLIENT_STATE_GET_ENDPOINT
This state is set to provide an endpoint for sending/receiving messages.
Definition Include.h:1079
@ SIGNALING_CLIENT_STATE_CONNECTED
On transitioning to this state, the timeout on the state machine is reset.
Definition Include.h:1086
@ SIGNALING_CLIENT_STATE_NEW
This state indicates a new client state.
Definition Include.h:1073
@ SIGNALING_CLIENT_STATE_READY
Definition Include.h:1082
@ SIGNALING_CLIENT_STATE_JOIN_SESSION_WAITING
Definition Include.h:1093
@ SIGNALING_CLIENT_STATE_GET_ICE_CONFIG
Definition Include.h:1080
@ SIGNALING_CLIENT_STATE_JOIN_SESSION_CONNECTED
Definition Include.h:1094
@ SIGNALING_CLIENT_STATE_DESCRIBE
Definition Include.h:1075
@ SIGNALING_CLIENT_STATE_MAX_VALUE
This state indicates maximum number of signaling client states.
Definition Include.h:1095
@ SIGNALING_CLIENT_STATE_DELETE
This state transition happens when the application calls signalingClientDeleteSync API.
Definition Include.h:1088
@ SIGNALING_CLIENT_STATE_DISCONNECTED
This state transition happens either from connect or connected state.
Definition Include.h:1087
@ SIGNALING_CLIENT_STATE_GET_CREDENTIALS
This state involves getting a token using AWS credentials.
Definition Include.h:1074
@ SIGNALING_CLIENT_STATE_DELETED
Definition Include.h:1089
@ SIGNALING_CLIENT_STATE_CREATE
Definition Include.h:1077
@ SIGNALING_CLIENT_STATE_CONNECTING
Definition Include.h:1084
@ SIGNALING_CHANNEL_ROLE_TYPE_MASTER
Channel role is master.
Definition Include.h:1112
@ SIGNALING_CHANNEL_ROLE_TYPE_VIEWER
Channel role is viewer.
Definition Include.h:1113
@ SIGNALING_CHANNEL_ROLE_TYPE_UNKNOWN
Channel role is unknown.
Definition Include.h:1111
@ SIGNALING_CHANNEL_TYPE_UNKNOWN
Channel type is unknown.
Definition Include.h:1103
@ SIGNALING_CHANNEL_TYPE_SINGLE_MASTER
Channel type is master.
Definition Include.h:1104
@ SIGNALING_MESSAGE_TYPE_STATUS_RESPONSE
This message notifies the awaiting send after checking for failure in message delivery.
Definition Include.h:1064
@ SIGNALING_MESSAGE_TYPE_RECONNECT_ICE_SERVER
This message moves signaling state back to get ICE config.
Definition Include.h:1063
@ SIGNALING_MESSAGE_TYPE_OFFER
This message type leads to checks in existence of peer id and payload in the message.
Definition Include.h:1059
@ SIGNALING_MESSAGE_TYPE_ANSWER
This message type leads to checks in length/existence of payload in the message.
Definition Include.h:1060
@ SIGNALING_MESSAGE_TYPE_UNKNOWN
This message type is set when the type of message received is unknown.
Definition Include.h:1065
@ SIGNALING_MESSAGE_TYPE_GO_AWAY
This message moves signaling back to describe state.
Definition Include.h:1062
@ SIGNALING_MESSAGE_TYPE_ICE_CANDIDATE
This message type leads to checks in length/existence of payload in the message.
Definition Include.h:1061
@ RTC_CODEC_ALAW
ALAW audio codec.
Definition Include.h:1012
@ RTC_CODEC_VP8
VP8 video codec.
Definition Include.h:1010
@ RTC_CODEC_MULAW
MULAW audio codec.
Definition Include.h:1011
@ RTC_CODEC_UNKNOWN
Definition Include.h:1013
@ RTC_CODEC_H265
H265 video codec.
Definition Include.h:1014
@ RTC_CODEC_OPUS
OPUS audio codec.
Definition Include.h:1009
@ RTC_CODEC_MAX
Placeholder for max number of supported codecs.
Definition Include.h:1016
@ RTC_CODEC_H264_PROFILE_42E01F_LEVEL_ASYMMETRY_ALLOWED_PACKETIZATION_MODE
H264 video codec.
Definition Include.h:1008
@ ICE_TRANSPORT_POLICY_ALL
The ICE Agent can use any type of candidate when this value is specified.
Definition Include.h:1028
@ ICE_TRANSPORT_POLICY_RELAY
Definition Include.h:1025
@ MEDIA_STREAM_TRACK_KIND_VIDEO
Video track. Track information is set before add transceiver.
Definition Include.h:1001
@ MEDIA_STREAM_TRACK_KIND_AUDIO
Audio track. Track information is set before add transceiver.
Definition Include.h:1000
@ SDP_TYPE_ANSWER
SessionDescription is type answer.
Definition Include.h:993
@ SDP_TYPE_OFFER
SessionDescription is type offer.
Definition Include.h:992
@ SIGNALING_API_CALL_CACHE_TYPE_DESCRIBE_GETENDPOINT
Definition Include.h:1134
@ SIGNALING_API_CALL_CACHE_TYPE_NONE
No caching. The calls to the backend will be made for every API.
Definition Include.h:1132
@ SIGNALING_API_CALL_CACHE_TYPE_FILE
Definition Include.h:1143
@ SIGNALING_API_CALL_CACHE_TYPE_FILE_EXCEPT_DESCRIBE_MEDIA
Definition Include.h:1149
@ SIGNALING_CHANNEL_STATUS_CREATING
Signaling channel is being created.
Definition Include.h:1049
@ SIGNALING_CHANNEL_STATUS_ACTIVE
Signaling channel is active.
Definition Include.h:1050
@ SIGNALING_CHANNEL_STATUS_DELETING
Signaling channel is being deleted.
Definition Include.h:1052
@ SIGNALING_CHANNEL_STATUS_UPDATING
Signaling channel is being updated.
Definition Include.h:1051
@ NAT_BEHAVIOR_NO_UDP_CONNECTIVITY
No UDP connectvity.
Definition Include.h:1122
@ NAT_BEHAVIOR_ENDPOINT_INDEPENDENT
Nat behavior is irregardless of change in external address.
Definition Include.h:1123
@ NAT_BEHAVIOR_NOT_BEHIND_ANY_NAT
Host is not behind any NAT.
Definition Include.h:1121
@ NAT_BEHAVIOR_PORT_DEPENDENT
Nat behavior changes when external address or port is changed.
Definition Include.h:1125
@ NAT_BEHAVIOR_NONE
Dummy placeholder.
Definition Include.h:1120
@ NAT_BEHAVIOR_ADDRESS_DEPENDENT
Nat behavior changes changes when external address is changed, but remain same if only port is change...
Definition Include.h:1124
PUBLIC_API STATUS initKvsWebRtc(VOID)
Initializes global state needed for all RtcPeerConnections. It must only be called once.
Definition PeerConnection.c:1811
PUBLIC_API STATUS setLocalDescription(PRtcPeerConnection, PRtcSessionDescriptionInit)
Instructs the RtcPeerConnection to apply the supplied RtcSessionDescriptionInit as the local descript...
Definition PeerConnection.c:1573
PUBLIC_API STATUS freeTransceiver(PRtcRtpTransceiver *)
Frees the previously created transceiver object.
Definition Rtp.c:121
PUBLIC_API STATUS dataChannelSend(PRtcDataChannel, BOOL, PBYTE, UINT32)
Send data via the PRtcDataChannel.
Definition DataChannel.c:57
PUBLIC_API STATUS addIceCandidate(PRtcPeerConnection, PCHAR)
Provides a remote candidate to the ICE Agent.
Definition PeerConnection.c:1735
PUBLIC_API STATUS createOffer(PRtcPeerConnection, PRtcSessionDescriptionInit)
Populate the provided answer that contains an RFC 3264 offer with the supported configurations for th...
Definition PeerConnection.c:1502
PUBLIC_API STATUS peerConnectionGetCurrentLocalDescription(PRtcPeerConnection, PRtcSessionDescriptionInit)
Definition PeerConnection.c:1336
PUBLIC_API STATUS signalingClientGetIceConfigInfoCount(SIGNALING_CLIENT_HANDLE, PUINT32)
Gets the retrieved ICE configuration information object count.
Definition Client.c:281
PUBLIC_API STATUS dataChannelOnOpen(PRtcDataChannel, UINT64, RtcOnOpen)
Set a callback for data channel open.
Definition DataChannel.c:92
PUBLIC_API STATUS createSignalingClientSync(PSignalingClientInfo, PChannelInfo, PSignalingClientCallbacks, PAwsCredentialProvider, PSIGNALING_CLIENT_HANDLE)
Creates a Signaling client and returns a handle to it.
Definition Client.c:55
PUBLIC_API STATUS peerConnectionOnSenderBandwidthEstimation(PRtcPeerConnection, UINT64, RtcOnSenderBandwidthEstimation)
Set a callback for transport-wide sender bandwidth estimation results.
Definition PeerConnection.c:1278
PUBLIC_API STATUS writeFrame(PRtcRtpTransceiver, PFrame)
Packetizes and sends media via the configuration specified by the RtcRtpTransceiver.
Definition Rtp.c:262
PUBLIC_API STATUS peerConnectionOnDataChannel(PRtcPeerConnection, UINT64, RtcOnDataChannel)
Definition PeerConnection.c:1227
PUBLIC_API STATUS freePeerConnection(PRtcPeerConnection *)
Free a RtcPeerConnection.
Definition PeerConnection.c:1090
PUBLIC_API STATUS setRemoteDescription(PRtcPeerConnection, PRtcSessionDescriptionInit)
Instructs the RtcPeerConnection to apply the supplied RtcSessionDescriptionInit as the remote descrip...
Definition PeerConnection.c:1388
PUBLIC_API STATUS rtcPeerConnectionGetMetrics(PRtcPeerConnection, PRtcRtpTransceiver, PRtcStats)
Get the relevant/all metrics based on the RTCStatsType field. This does not include any signaling rel...
Definition Metrics.c:225
PUBLIC_API PCHAR getNatBehaviorStr(NAT_BEHAVIOR natBehavior)
Return the string representation for each NAT_BEHAVIOR enum.
Definition NatBehaviorDiscovery.c:369
PUBLIC_API STATUS peerConnectionOnIceCandidate(PRtcPeerConnection, UINT64, RtcOnIceCandidate)
Set a callback when new Ice collects new local candidate.
Definition PeerConnection.c:1202
PUBLIC_API STATUS addTransceiver(PRtcPeerConnection, PRtcMediaStreamTrack, PRtcRtpTransceiverInit, PRtcRtpTransceiver *)
Create a new RtcRtpTransceiver and add it to the set of transceivers.
Definition PeerConnection.c:1603
PUBLIC_API STATUS signalingClientDisconnectSync(SIGNALING_CLIENT_HANDLE)
Disconnects the signaling client.
Definition Client.c:247
PUBLIC_API STATUS createRtcCertificate(PRtcCertificate *)
Creates an RtcCertificate object.
Definition Crypto.c:4
PUBLIC_API STATUS serializeSessionDescriptionInit(PRtcSessionDescriptionInit, PCHAR, PUINT32)
Create a JSON string from RtcSessionDescriptionInit.
Definition SessionDescription.c:28
PUBLIC_API STATUS discoverNatBehavior(PCHAR, NAT_BEHAVIOR *, NAT_BEHAVIOR *, IceSetInterfaceFilterFunc, UINT64)
Use the process described in https://tools.ietf.org/html/rfc5780#section-4.3 to discover NAT behavior...
Definition NatBehaviorDiscovery.c:262
PUBLIC_API STATUS createDataChannel(PRtcPeerConnection, PCHAR, PRtcDataChannelInit, PRtcDataChannel *)
createDataChannel creates a new RtcDataChannel object with the given label.
Definition DataChannel.c:10
PUBLIC_API STATUS createAnswer(PRtcPeerConnection, PRtcSessionDescriptionInit)
Populate the provided answer that contains an RFC 3264 answer with the supported configurations for t...
Definition PeerConnection.c:1544
PUBLIC_API STATUS peerConnectionGetMetrics(PRtcPeerConnection, PPeerConnectionMetrics)
Get peer connection related metrics.
Definition PeerConnection.c:2014
PUBLIC_API STATUS dataChannelOnMessage(PRtcDataChannel, UINT64, RtcOnMessage)
Set a callback for data channel message.
Definition DataChannel.c:75
PUBLIC_API STATUS transceiverOnPictureLoss(PRtcRtpTransceiver, UINT64, RtcOnPictureLoss)
Set a callback for picture loss packet (PLI)
Definition Rtp.c:218
PUBLIC_API STATUS signalingClientGetIceConfigInfo(SIGNALING_CLIENT_HANDLE, UINT32, PIceConfigInfo *)
Gets the ICE configuration information object given its index.
Definition Client.c:298
PUBLIC_API STATUS signalingClientGetStateString(SIGNALING_CLIENT_STATE, PCHAR *)
Definition Client.c:343
PUBLIC_API STATUS closePeerConnection(PRtcPeerConnection)
Close the underlying DTLS session and IceAgent connection. Trigger RtcOnConnectionStateChange to RTC_...
Definition PeerConnection.c:1774
PUBLIC_API STATUS signalingClientFetchSync(SIGNALING_CLIENT_HANDLE)
Fetches all assets needed to ready the state machine before attempting to connect....
Definition Client.c:183
PUBLIC_API STATUS peerConnectionGetLocalDescription(PRtcPeerConnection, PRtcSessionDescriptionInit)
Definition PeerConnection.c:1304
PUBLIC_API STATUS transceiverOnBandwidthEstimation(PRtcRtpTransceiver, UINT64, RtcOnBandwidthEstimation)
Set a callback for bandwidth estimation results.
Definition Rtp.c:201
PUBLIC_API STATUS transceiverOnFrame(PRtcRtpTransceiver, UINT64, RtcOnFrame)
Set a callback for transceiver frame.
Definition Rtp.c:184
PUBLIC_API STATUS configureTransceiverRollingBuffer(PRtcRtpTransceiver, PRtcMediaStreamTrack, DOUBLE, DOUBLE)
Set up rolling buffer configuration - max duration of media to store (sec) and expected max bitrate (...
Definition PeerConnection.c:1590
PUBLIC_API STATUS deserializeSessionDescriptionInit(PCHAR, UINT32, PRtcSessionDescriptionInit)
Parses a JSON string and returns an allocated PSessionDescriptionInit.
Definition SessionDescription.c:87
PUBLIC_API STATUS signalingClientGetCurrentState(SIGNALING_CLIENT_HANDLE, PSIGNALING_CLIENT_STATE)
Gets the Signaling client current state.
Definition Client.c:315
PUBLIC_API STATUS updateEncoderStats(PRtcRtpTransceiver, PRtcEncoderStats)
call this function to update stats which depend on external encoder
Definition Rtp.c:235
PUBLIC_API STATUS iceAgentGetMetrics(PRtcPeerConnection, PKvsIceAgentMetrics)
Get peer connection related metrics.
Definition PeerConnection.c:2050
PUBLIC_API STATUS freeRtcCertificate(PRtcCertificate)
Frees previously generated RtcCertificate object.
Definition Crypto.c:46
PUBLIC_API STATUS signalingClientConnectSync(SIGNALING_CLIENT_HANDLE)
Connects the signaling client to the web socket in order to send/receive messages.
Definition Client.c:164
PUBLIC_API STATUS signalingClientGetMetrics(SIGNALING_CLIENT_HANDLE, PSignalingClientMetrics)
Get signaling related metrics.
Definition Client.c:423
PUBLIC_API STATUS signalingClientDeleteSync(SIGNALING_CLIENT_HANDLE)
Deletes the signaling channel referenced by SIGNALING_CLIENT_HANDLE.
Definition Client.c:264
PUBLIC_API STATUS createPeerConnection(PRtcConfiguration, PRtcPeerConnection *)
Initialize a RtcPeerConnection with the provided Configuration.
Definition PeerConnection.c:988
PUBLIC_API STATUS restartIce(PRtcPeerConnection)
Instructs the RtcPeerConnection that ICE should be restarted. Subsequent calls to createOffer will cr...
Definition PeerConnection.c:1752
PUBLIC_API NullableBool canTrickleIceCandidates(PRtcPeerConnection)
The canTrickleIceCandidates attribute indicates whether the remote peer is able to accept trickled IC...
Definition PeerConnection.c:1792
PUBLIC_API STATUS deinitKvsWebRtc(VOID)
Deinitializes global state needed for all RtcPeerConnections. It must only be called once.
Definition PeerConnection.c:1894
PUBLIC_API STATUS signalingClientSendMessageSync(SIGNALING_CLIENT_HANDLE, PSignalingMessage)
Send a message through a Signaling client.
Definition Client.c:147
PUBLIC_API STATUS peerConnectionOnConnectionStateChange(PRtcPeerConnection, UINT64, RtcOnConnectionStateChange)
Definition PeerConnection.c:1252
PUBLIC_API STATUS addSupportedCodec(PRtcPeerConnection, RTC_CODEC)
Adds to the list of codecs we support receiving.
Definition PeerConnection.c:1705
PUBLIC_API STATUS deserializeRtcIceCandidateInit(PCHAR, UINT32, PRtcIceCandidateInit)
Parses a JSON string and populates a PRtcIceCandidateInit.
Definition SessionDescription.c:1520
PUBLIC_API STATUS freeSignalingClient(PSIGNALING_CLIENT_HANDLE)
Frees the Signaling client object.
Definition Client.c:124
struct SignalingClientCallbacks * PSignalingClientCallbacks
struct MediaStorageConfig * PMediaStorageConfig
struct SignalingClientInfo * PSignalingClientInfo
struct RtcIceServer * PRtcIceServer
struct RtcSessionDescriptionInit * PRtcSessionDescriptionInit
struct RtcRtpTransceiverInit * PRtcRtpTransceiverInit
struct KvsRtcConfiguration * PKvsRtcConfiguration
struct RtcRtpTransceiver * PRtcRtpTransceiver
struct RtcPeerConnection * PRtcPeerConnection
struct RtcMediaStreamTrack * PRtcMediaStreamTrack
struct RtcCertificate * PRtcCertificate
struct ReceivedSignalingMessage * PReceivedSignalingMessage
struct RtcConfiguration * PRtcConfiguration
struct ChannelInfo * PChannelInfo
struct SignalingMessage * PSignalingMessage
struct RtcDataChannelInit * PRtcDataChannelInit
struct RtcIceCandidateInit * PRtcIceCandidateInit
struct RtcRtpReceiver * PRtcRtpReceiver
struct SignalingChannelDescription * PSignalingChannelDescription
struct IceConfigInfo * PIceConfigInfo
#define MAX_ICE_CONFIG_URI_LEN
Definition Stats.h:30
#define MAX_ICE_CONFIG_URI_BUFFER_LEN
Definition Stats.h:37
struct KvsIceAgentMetrics * PKvsIceAgentMetrics
struct RtcStreamMetrics * PRtcStreamMetrics
struct PeerConnectionMetrics * PPeerConnectionMetrics
struct RtcEncoderStats * PRtcEncoderStats
struct SignalingClientMetrics * PSignalingClientMetrics
struct RtcStats * PRtcStats
struct RtcIceMetrics * PRtcIceMetrics
UINT64 filterCustomData
Custom Data that can be populated by the developer while developing filter function.
Definition Include.h:1382
PCHAR pRegion
Definition Include.h:1519
UINT32 tagCount
Number of tags associated with the stream.
Definition Include.h:1554
PCHAR pKmsKeyId
Optional KMS key id ARN. Maximum length is defined by MAX_ARN_LEN+1.
Definition Include.h:1534
UINT32 uriCount
Number of Ice URI objects.
Definition Include.h:1581
MEDIA_STREAM_TRACK_KIND kind
Kind of track - audio or video.
Definition Include.h:1294
BOOL retry
Flag determines if a retry of the network calls is to be done on errors up to max retry times.
Definition Include.h:1547
UINT64 signalingEndTime
Definition Include.h:1744
BOOL storageStatus
Indicate the association between channelArn and storageStreamArn.
Definition Include.h:1588
RtcIceServerStats rtcIceServerStats
Server related stats. Reference in Stats.h.
Definition Include.h:1719
PCHAR pCertPath
Optional certificate path. Maximum length is defined by MAX_PATH_LEN+1.
Definition Include.h:1525
UINT32 version
Version of peer connection structure.
Definition Include.h:1282
SignalingClientStats signalingClientStats
Signaling client metrics stats. Reference in Stats.h.
Definition Include.h:1746
UINT64 SIGNALING_CLIENT_HANDLE
Definition of the signaling client handle.
Definition Include.h:947
UINT32 signalingMessagesMinimumThreads
Unused field post v1.8.1.
Definition Include.h:1502
UINT32 sendBufSize
Socket send buffer length. Item larger then this size will get dropped. Use system default if 0.
Definition Include.h:1380
UINT32 version
Version of the SignalingChannelDescription struct.
Definition Include.h:1663
UINT32 version
Current version of the structure.
Definition Include.h:1457
UINT32 version
Current version of the structure.
Definition Include.h:1651
UINT32 certificateSize
Size of certificate in bytes (optional)
Definition Include.h:1340
RtcRemoteInboundRtpStreamStats rtcInboundStats
Inbound RTP Stats. Reference in Stats.h.
Definition Include.h:1733
UINT32 signalingMessagesMaximumThreads
Unused field post v1.8.1.
Definition Include.h:1503
PTag pTags
Stream tags array.
Definition Include.h:1556
UINT32 iceLocalCandidateGatheringTimeout
Definition Include.h:1360
BOOL reserved
Reserved field for compatibility.
Definition Include.h:1540
UINT64 messageTtl
Definition Include.h:1670
PCHAR pChannelArn
Definition Include.h:1514
KvsIceAgentStats kvsIceAgentStats
ICE agent metrics. Reference in Stats.h.
Definition Include.h:1754
NullableUint16 maxRetransmits
Control number of times a channel retransmits data if not delivered successfully.
Definition Include.h:1695
ICE_TRANSPORT_POLICY iceTransportPolicy
Indicates which candidates the ICE Agent is allowed to use.
Definition Include.h:1403
UINT32 id
Definition Include.h:1218
SIGNALING_CHANNEL_TYPE channelType
Channel type when creating.
Definition Include.h:1536
SignalingClientErrorReportFunc errorReportFn
Error reporting function. This is an optional member.
Definition Include.h:1654
RtcIceCandidatePairStats rtcIceCandidatePairStats
Candidate pair stats. Reference in Stats.h.
Definition Include.h:1722
RtcTransportStats rtcTransportStats
Transport stats. Reference in Stats.h.
Definition Include.h:1735
UINT64 signalingCallTime
Definition Include.h:1745
RTC_CODEC codec
non-standard, codec that the track is using
Definition Include.h:1291
SDP_TYPE type
Indicates an offer/answer SDP type.
Definition Include.h:1435
RtcIceCandidateStats localRtcIceCandidateStats
Local candidate stats. Reference in Stats.h.
Definition Include.h:1720
KvsRtcConfiguration kvsRtcConfiguration
Non-standard configuration options.
Definition Include.h:1405
RTC_RTP_TRANSCEIVER_DIRECTION direction
Transceiver direction - SENDONLY, RECVONLY, SENDRECV.
Definition Include.h:1681
UINT64 cachingPeriod
Definition Include.h:1542
UINT32 version
Version of the structure.
Definition Include.h:1510
UINT32 version
Version of the struct.
Definition Include.h:1579
RtcOutboundRtpStreamStats rtcOutboundStats
Outbound RTP Stats. Reference in Stats.h.
Definition Include.h:1734
RTC_RTP_TRANSCEIVER_DIRECTION direction
Transceiver direction.
Definition Include.h:1317
UINT16 bitDepth
Only valid for video. bits per pixel (24, 30, 36), note it's not per channel but per pixel.
Definition Include.h:1785
KvsRetryStrategyCallbacks signalingRetryStrategyCallbacks
Retry strategy callbacks used while creating signaling client.
Definition Include.h:1498
SignalingClientStateChangedFunc stateChangeFn
Signaling client state change callback.
Definition Include.h:1655
BOOL negotiated
Definition Include.h:1697
UINT32 loggingLevel
Definition Include.h:1490
UINT32 stateMachineRetryCountReadOnly
Definition Include.h:1500
PCHAR pUserAgent
Combined user agent. Maximum length is defined by MAX_USER_AGENT_LEN+1.
Definition Include.h:1532
UINT16 width
Only valid for video.
Definition Include.h:1783
SIGNALING_CHANNEL_STATUS channelStatus
Current channel status as reported by the service.
Definition Include.h:1666
BOOL useMediaStorage
use the feature of media storage.
Definition Include.h:1566
SIGNALING_CHANNEL_TYPE channelType
Channel type as reported by the service.
Definition Include.h:1667
SERVICE_CALL_RESULT statusCode
Response status code.
Definition Include.h:1477
RtcRtpReceiver receiver
RtcRtpReceiver that has track specific information.
Definition Include.h:1318
RtcMediaStreamTrack track
Track with details of codec, trackId, streamId and track kind.
Definition Include.h:1307
UINT32 version
Structure version.
Definition Include.h:1742
UINT64 ttl
TTL of the configuration is 100ns.
Definition Include.h:1580
UINT64 creationTime
Timestamp of when the channel gets created.
Definition Include.h:1672
UINT64 messageTtl
Definition Include.h:1551
UINT32 version
Structure version.
Definition Include.h:1732
BOOL asyncIceServerConfig
Definition Include.h:1562
PeerConnectionStats peerConnectionStats
Peer connection metrics stats. Reference in Stats.h.
Definition Include.h:1762
BOOL voiceActivity
Only valid for audio. TRUE if last audio packet contained voice.
Definition Include.h:1787
SIGNALING_MESSAGE_TYPE messageType
Type of signaling message.
Definition Include.h:1459
UINT32 version
Version of the structure.
Definition Include.h:1488
PBYTE pCertificate
Certificate bits.
Definition Include.h:1339
BOOL generateRSACertificate
Definition Include.h:1377
UINT32 encodeTimeMsec
milliseconds spent encoding frames since last encoder update
Definition Include.h:1786
UINT32 privateKeySize
Size of private key in bytes (optional)
Definition Include.h:1344
RTC_STATS_TYPE requestedTypeOfStats
Type of stats requested. Set to RTC_ALL to get all supported stats.
Definition Include.h:1771
UINT64 signalingStartTime
Definition Include.h:1743
BOOL useTrickleIce
Indicates if an offer should set trickle ice.
Definition Include.h:1436
UINT64 customData
Custom data passed by the caller.
Definition Include.h:1652
BOOL disableSenderSideBandwidthEstimation
Definition Include.h:1387
PCHAR cacheFilePath
Definition Include.h:1493
PCHAR pControlPlaneUrl
Definition Include.h:1522
SIGNALING_CHANNEL_ROLE_TYPE channelRoleType
Channel role type for the endpoint - master/viewer.
Definition Include.h:1538
SIGNALING_API_CALL_CACHE_TYPE cachingPolicy
Backend API call caching policy.
Definition Include.h:1560
UINT32 iceConnectionCheckTimeout
Definition Include.h:1363
PBYTE pPrivateKey
Private key bit.
Definition Include.h:1343
GetCurrentTimeFunc getCurrentTimeFn
callback to override system time, used for testing clock skew
Definition Include.h:1656
UINT32 targetBitrate
Definition Include.h:1779
NullableUint16 maxPacketLifeTime
Definition Include.h:1692
UINT32 iceCandidateNominationTimeout
Definition Include.h:1366
PCHAR pStorageStreamArn
Definition Include.h:1516
UINT32 payloadLen
Optional payload length. If 0, the length will be calculated.
Definition Include.h:1465
BOOL ordered
Decides the order in which data is sent. If true, data is sent in order.
Definition Include.h:1691
UINT32 iceConnectionCheckPollingInterval
Definition Include.h:1370
CHAR name[255+1]
Define name of data channel. Max length is 256 characters.
Definition Include.h:1217
UINT32 version
Structure version.
Definition Include.h:1753
PCHAR pChannelName
Name of the signaling channel name. Maximum length is defined by MAX_CHANNEL_NAME_LEN + 1.
Definition Include.h:1512
SignalingMessage signalingMessage
Definition Include.h:1474
UINT64 timestamp
Timestamp of request for stats.
Definition Include.h:1770
PCHAR pCustomUserAgent
Optional custom user agent name. Maximum length is defined by MAX_USER_AGENT_LEN+1.
Definition Include.h:1530
SIGNALING_CLIENT_HANDLE * PSIGNALING_CLIENT_HANDLE
Definition Include.h:948
UINT32 version
Structure version.
Definition Include.h:1718
UINT16 height
Only valid for video.
Definition Include.h:1784
IceSetInterfaceFilterFunc iceSetInterfaceFilterFunc
Definition Include.h:1384
INT32 generatedCertificateBits
Definition Include.h:1373
UINT16 maximumTransmissionUnit
Definition Include.h:1355
SignalingClientMessageReceivedFunc messageReceivedFn
Callback registration for received SDP.
Definition Include.h:1653
BOOL reconnect
Flag determines if reconnection should be attempted on connection drop.
Definition Include.h:1549
PCHAR pUserAgentPostfix
Definition Include.h:1527
INT32 signalingClientCreationMaxRetryAttempts
Max attempts to create signaling client before returning error to the caller.
Definition Include.h:1499
UINT32 version
Structure version.
Definition Include.h:1761
RtcStatsObject rtcStatsObject
Object that is populated by the SDK on request.
Definition Include.h:1772
RtcIceCandidateStats remoteRtcIceCandidateStats
Remote candidate stats. Reference in Stats.h.
Definition Include.h:1721
DOMString encoderImplementation
encoder name eg "libvpx" or "x264"
Definition Include.h:1788
Contains all signaling channel related information.
Definition Include.h:1509
ICE configuration information struct.
Definition Include.h:1578
KVS ICE Agent Collection of ICE agent related stats. Can be expanded in the future.
Definition Include.h:1752
: IceAgent profiling Stats related to the KVS ICE Agent
Definition Stats.h:268
Definition Include.h:1354
Definition Include.h:1587
Definition NullableDefs.h:60
Custom data type to allow setting UINT16 data type to NULL since C does not support setting basic dat...
Definition NullableDefs.h:87
SignalingStats Collection of signaling related stats. Can be expanded in the future.
Definition Include.h:1760
Definition Stats.h:645
Structure defining the signaling message to be received.
Definition Include.h:1473
Specifies the certificate and the private key used by the certificate. The Certificates are in the fo...
Definition Include.h:1337
The Configuration defines a set of parameters to configure how the peer-to-peer communication establi...
Definition Include.h:1402
RtcDataChannelInit dictionary used to configure properties of the underlying channel such as data rel...
Definition Include.h:1690
The stats object is populated by the application to include details about the encoder.
Definition Include.h:1778
Rtc ICE candidate interface.
Definition Include.h:1447
RtcIceCandidatePairStats Stats related to the local-remote ICE candidate pair.
Definition Stats.h:210
: RtcIceCandidateStats Stats related to a specific candidate in a pair
Definition Stats.h:287
Statistics relted to ICE candidates.
Definition Include.h:1717
: RtcIceServerStats Stats related to the ICE Server
Definition Stats.h:253
RtcIceServer is used to describe the STUN and TURN servers that can be used by the ICE Agent to estab...
Definition Include.h:1327
Represents a single track in a MediaStream.
Definition Include.h:1290
RtcOutboundRtpStreamStats Gathers stats for media stream from the embedded device Note: RTCOutboundRt...
Definition Stats.h:364
An RtcPeerConnection instance allows an application to establish peer-to-peer communications with ano...
Definition Include.h:1281
RTCRemoteInboundRtpStreamStats Represents the remote endpoint's measurement metrics for a particular ...
Definition Stats.h:416
RTCRtpReceiver allows an application to inspect the receipt of a MediaStreamTrack.
Definition Include.h:1306
RtcRtpTransceiverInit is used to configure a transceiver when creating it.
Definition Include.h:1680
The RTCRtpTransceiver represents a combination of an RTCRtpSender and an RTCRtpReceiver that share a ...
Definition Include.h:1316
SessionDescription is used by RtcPeerConnection to expose local and remote session descriptions.
Definition Include.h:1434
RTCStatsObject Represents an object passed in by the application developer which will be populated in...
Definition Stats.h:660
The stats object is populated based on RTCStatsType request.
Definition Include.h:1769
Collection of RTP stream related stats Reference: https://www.w3.org/TR/webrtc-stats/#remoteinboundrt...
Definition Include.h:1731
RtcTransportStats Represents the stats corresponding to an RTCDtlsTransport and its underlying RTCIce...
Definition Stats.h:304
Signaling channel description returned from the service.
Definition Include.h:1662
Register Signaling client callbacks.
Definition Include.h:1650
Populate Signaling client with client ID and application log level.
Definition Include.h:1487
SignalingStats Collection of signaling related stats. Can be expanded in the future.
Definition Include.h:1741
SignalingClientMetrics Represent the stats related to the KVS WebRTC SDK signaling client.
Definition Stats.h:592
Structure defining the basic signaling message.
Definition Include.h:1456
RtcDataChannel represents a bi-directional data channel between two peers.
Definition Include.h:1216