Support for strings as unique IDs in AudioBridge, VideoRoom, TextRoom (…

…#1880)

conf/janus.plugin.audiobridge.jcfg.sample

@@ -37,6 +37,10 @@ general: {
 									# .wav --> .wav.tmp until the file is closed
 	#events = false					# Whether events should be sent to event
 									# handlers (default=true)
+
+	# By default, integers are used as a unique ID for both rooms and participants.
+	# In case you want to use strings instead (e.g., a UUID), set string_ids to true.
+	#string_ids = true
 }
 
 room-1234: {

conf/janus.plugin.textroom.jcfg.sample

@@ -13,6 +13,10 @@ general: {
 									# plain (no indentation) or compact (no indentation and no spaces)
 	#events = false					# Whether events should be sent to event
 									# handlers (default=true)
+
+	# By default, integers are used as a unique ID for rooms. In case you
+	# want to use strings instead (e.g., a UUID), set string_ids to true.
+	#string_ids = true
 }
 
 room-1234: {

conf/janus.plugin.videoroom.jcfg.sample

@@ -44,6 +44,10 @@ general: {
 									# enforced for RTP forwarding requests too
 	#events = false					# Whether events should be sent to event
 									# handlers (default=true)
+
+	# By default, integers are used as a unique ID for both rooms and participants.
+	# In case you want to use strings instead (e.g., a UUID), set string_ids to true.
+	#string_ids = true
 }
 
 room-1234: {

utils.c

@@ -90,6 +90,10 @@ guint64 janus_random_uint64(void) {
 	return num;
 }
 
+char *janus_random_uuid(void) {
+	return g_uuid_string_random();
+}
+
 guint64 *janus_uint64_dup(guint64 num) {
 	guint64 *numdup = g_malloc(sizeof(guint64));
 	*numdup = num;

utils.h

@@ -69,6 +69,10 @@ guint32 janus_random_uint32(void);
  * @returns A random 64-bit unsigned integer */
 guint64 janus_random_uint64(void);
 
+/*! \brief Helper to generate random UUIDs (needed by some plugins)
+ * @returns A random UUID string, which must be deallocated with \c g_free */
+char *janus_random_uuid(void);
+
 /*! \brief Helper to generate an allocated copy of a guint64 number
  * @note While apparently silly, this is needed in order to make sure guint64 values
  * used as keys in GHashTable operations are not lost: using temporary guint64 numbers