engage-engine 1.251.90910019 → 1.251.90910021

package/engage.cpp

@@ -502,6 +502,10 @@ ENGAGE_CB_ID_PARAM(groupHealthReportFailed);
 ENGAGE_CB_ID_PLUS_ONE_STRING_PARAM(groupStatsReport);
 ENGAGE_CB_ID_PARAM(groupStatsReportFailed);
 
+ENGAGE_CB_ID_PARAM(bridgeCreated)
+ENGAGE_CB_ID_PARAM(bridgeCreateFailed)
+ENGAGE_CB_ID_PARAM(bridgeDeleted)
+
 void on_groupRxVolumeChanged(const char *id, int16_t leftLevelPerc, int16_t rightLevelPerc, const char * eventExtraJson)
 {
     CrossThreadCallbackWorker *cbw = getCallback("groupRxVolumeChanged");
@@ -661,6 +665,10 @@ NAN_METHOD(initialize)
     ENGAGE_CB_TABLE_ENTRY(PFN_ENGAGE_GROUP_RX_VOLUME_CHANGED, groupRxVolumeChanged);
     ENGAGE_CB_TABLE_ENTRY(PFN_ENGAGE_GROUP_RX_DTMF, groupRxDtmf);
 
+    ENGAGE_CB_TABLE_ENTRY(PFN_ENGAGE_BRIDGE_CREATED, bridgeCreated);
+    ENGAGE_CB_TABLE_ENTRY(PFN_ENGAGE_BRIDGE_CREATE_FAILED, bridgeCreateFailed);
+    ENGAGE_CB_TABLE_ENTRY(PFN_ENGAGE_BRIDGE_DELETED, bridgeDeleted);
+
     engageRegisterEventCallbacks(&g_eventCallbacks);
 
     NANRETI(engageInitialize(STRVAL(0), STRVAL(1), STRVAL(2)));
@@ -1214,6 +1222,17 @@ NAN_METHOD(endGroupPcmPowerTracking)
     NANRETI(engageEndGroupPcmPowerTracking(STRVAL(0)));
 }
 
+//--------------------------------------------------------
+NAN_METHOD(createBridge)
+{
+    NANRETI(engageCreateBridge(STRVAL(0)));
+}
+
+//--------------------------------------------------------
+NAN_METHOD(deleteBridge)
+{
+    NANRETI(engageDeleteBridge(STRVAL(0)));
+}
 
 //--------------------------------------------------------
 NAN_MODULE_INIT(Init)
@@ -1297,6 +1316,9 @@ NAN_MODULE_INIT(Init)
 
     ENGAGE_BINDING(beginGroupPcmPowerTracking);
     ENGAGE_BINDING(endGroupPcmPowerTracking);
+
+    ENGAGE_BINDING(createBridge);
+    ENGAGE_BINDING(deleteBridge);
 }
 
 NODE_MODULE(engage, Init)

package/include/ConfigurationObjects.h

@@ -2751,6 +2751,21 @@ namespace AppConfigurationObjects
         IMPLEMENT_JSON_DOCUMENTATION(Rallypoint)
 
     public:
+        /**
+         * @brief RP protocol enum.
+         *
+         */
+        typedef enum
+        {
+            /** @brief  [Default] TLS over TCP*/
+            rppTlsTcp    = 0,
+
+            /** @brief WebSocket over TLS */
+            rppTlsWs      = 1,
+
+            /** @brief Invalid */
+            rppInvalid    = -1
+        } RpProtocol_t;
 
         /**
          * @brief This is the host address for the Engine to connect to the RallyPoint service.
@@ -2800,7 +2815,7 @@ namespace AppConfigurationObjects
         std::vector<std::string>    caCertificates;
 
         /**
-         * @brief [Optional, Default 5000] Number of milliseconds that a transaction may take before the link is considered broken.
+         * @brief [Optional, Default 10000] Number of milliseconds that a transaction may take before the link is considered broken.
          */
         int                         transactionTimeoutMs;
 
@@ -2815,6 +2830,21 @@ namespace AppConfigurationObjects
         /** @brief [Optional] Tx options for the TCP link */
         TcpNetworkTxOptions         tcpTxOptions;
 
+        /**
+         * @brief [Optional] A user-defined string sent as the Server Name Indication (SNI) field in 
+         * the TLS setup.  Be aware that this data is sent in the clear in the client hello message.
+         * 
+         */
+        std::string                 sni;
+
+
+        /** @brief [Optional, Default: rppTlsTcp] Specifies the protocol to be used for the Rallypoint connection. See @ref RpProtocol_t for all protocol types */
+        RpProtocol_t                protocol;
+
+        /** @brief [Optional, Default: ""] Path to use for the RP connection (only used for WebSocket) */
+        std::string                 path;
+
+
         Rallypoint()
         {
             clear();
@@ -2831,6 +2861,9 @@ namespace AppConfigurationObjects
             disableMessageSigning = false;
             connectionTimeoutSecs = 0;
             tcpTxOptions.clear();
+            sni.clear();
+            protocol = rppTlsTcp;
+            path.clear();
         }
 
         bool matches(const Rallypoint& other)
@@ -2840,6 +2873,16 @@ namespace AppConfigurationObjects
                 return false;
             }
 
+            if(protocol != other.protocol)
+            {
+                return false;
+            }
+
+            if(path.compare(other.path) != 0)
+            {
+                return false;
+            }
+
             if(certificate.compare(other.certificate) != 0)
             {
                 return false;
@@ -2893,6 +2936,18 @@ namespace AppConfigurationObjects
             {
                 return false;
             }
+            if(connectionTimeoutSecs != other.connectionTimeoutSecs)
+            {
+                return false;
+            }
+            if(tcpTxOptions.priority != other.tcpTxOptions.priority)
+            {
+                return false;
+            }   
+            if(sni.compare(other.sni) != 0)
+            {
+                return false;
+            }
 
             return true;
         }
@@ -2910,7 +2965,10 @@ namespace AppConfigurationObjects
             TOJSON_IMPL(transactionTimeoutMs),
             TOJSON_IMPL(disableMessageSigning),
             TOJSON_IMPL(connectionTimeoutSecs),
-            TOJSON_IMPL(tcpTxOptions)
+            TOJSON_IMPL(tcpTxOptions),
+            TOJSON_IMPL(sni),
+            TOJSON_IMPL(protocol),
+            TOJSON_IMPL(path)
         };
     }
 
@@ -2927,6 +2985,9 @@ namespace AppConfigurationObjects
         getOptional<bool>("disableMessageSigning", p.disableMessageSigning, j, false);
         getOptional<int>("connectionTimeoutSecs", p.connectionTimeoutSecs, j, 0);
         getOptional<TcpNetworkTxOptions>("tcpTxOptions", p.tcpTxOptions, j);
+        getOptional<std::string>("sni", p.sni, j);
+        getOptional<Rallypoint::RpProtocol_t>("protocol", p.protocol, j, Rallypoint::RpProtocol_t::rppTlsTcp);
+        getOptional<std::string>("path", p.path, j);
     }
 
     //-----------------------------------------------------------
@@ -2970,10 +3031,10 @@ namespace AppConfigurationObjects
         /** @brief Seconds between switching to a new target */
         int                                 rolloverSecs;
 
-        /** @brief [Optional, Default: 0] Default connection timeout in seconds to any RP in the cluster */
+        /** @brief [Optional, Default: 5] Default connection timeout in seconds to any RP in the cluster */
         int                                 connectionTimeoutSecs;
 
-        /** @brief [Optional, Default: 0] Default transaction time in milliseconds to any RP in the cluster */
+        /** @brief [Optional, Default: 10000] Default transaction time in milliseconds to any RP in the cluster */
         int                                 transactionTimeoutMs;
 
         RallypointCluster()
@@ -2986,8 +3047,8 @@ namespace AppConfigurationObjects
             connectionStrategy = csRoundRobin;
             rallypoints.clear();
             rolloverSecs = 10;
-            connectionTimeoutSecs = 0;
-            transactionTimeoutMs = 0;
+            connectionTimeoutSecs = 5;
+            transactionTimeoutMs = 10000;
         }
     };
 
@@ -3007,8 +3068,8 @@ namespace AppConfigurationObjects
         getOptional<RallypointCluster::ConnectionStrategy_t>("connectionStrategy", p.connectionStrategy, RallypointCluster::ConnectionStrategy_t::csRoundRobin);
         getOptional<std::vector<Rallypoint>>("rallypoints", p.rallypoints, j);
         getOptional<int>("rolloverSecs", p.rolloverSecs, j, 10);
-        getOptional<int>("connectionTimeoutSecs", p.connectionTimeoutSecs, j, 0);
-        getOptional<int>("transactionTimeoutMs", p.connectionTimeoutSecs, j, 0);        
+        getOptional<int>("connectionTimeoutSecs", p.connectionTimeoutSecs, j, 5);
+        getOptional<int>("transactionTimeoutMs", p.transactionTimeoutMs, j, 10000);        
     }
 
 
@@ -3512,6 +3573,164 @@ namespace AppConfigurationObjects
         // internalKey is not serialized   
     }
 
+    //-----------------------------------------------------------
+    JSON_SERIALIZED_CLASS(AudioRegistryDevice)
+    /**
+     * @brief Describes an audio device that is available on the system
+     *
+     * Helper C++ class to serialize and de-serialize AudioRegistryDevice
+     *
+     * Example: @include[doc] examples/AudioRegistryDevice.json
+     *
+     * @see AudioRegistryDevice
+     */
+    class AudioRegistryDevice : public ConfigurationObjectBase
+    {
+        IMPLEMENT_JSON_SERIALIZATION()
+        IMPLEMENT_JSON_DOCUMENTATION(AudioRegistryDevice)
+
+    public:
+        /** @brief The string identifier used to identify the hardware. */
+        std::string     hardwareId;
+
+        /** @brief True if this is the default device */
+        bool            isDefault;
+
+        /** @brief Name of the device */
+        std::string     name;
+
+        /** @brief [Optional] Manufacturer */
+        std::string     manufacturer;
+
+        /** @brief [Optional] Model */
+        std::string     model;
+
+        /** @brief [Optional] Serial number */
+        std::string     serialNumber;
+
+
+        /** @brief [Optional] Type */
+        std::string     type;
+
+        /** @brief [Optional] Extra */
+        std::string     extra;
+
+        AudioRegistryDevice()
+        {
+            clear();
+        }
+
+        void clear()
+        {
+            hardwareId.clear();
+            isDefault = false;
+            name.clear();
+            manufacturer.clear();
+            model.clear();
+            serialNumber.clear();
+            type.clear();
+            extra.clear();
+        }
+
+        virtual std::string toString()
+        {
+            char buff[2048];
+
+            snprintf(buff, sizeof(buff), "hardwareId=%s, isDefault=%d, name=%s, manufacturer=%s, model=%s, serialNumber=%s, type=%s, extra=%s",
+                        hardwareId.c_str(),
+                        (int)isDefault,
+                        name.c_str(),
+                        manufacturer.c_str(),
+                        model.c_str(),
+                        serialNumber.c_str(),
+                        type.c_str(),
+                        extra.c_str());
+
+            return std::string(buff);
+        }
+    };
+
+    static void to_json(nlohmann::json& j, const AudioRegistryDevice& p)
+    {
+        j = nlohmann::json{
+            TOJSON_IMPL(hardwareId),
+            TOJSON_IMPL(isDefault),
+            TOJSON_IMPL(name),
+            TOJSON_IMPL(manufacturer),
+            TOJSON_IMPL(model),
+            TOJSON_IMPL(serialNumber),
+            TOJSON_IMPL(type),
+            TOJSON_IMPL(extra)
+        };
+    }
+    static void from_json(const nlohmann::json& j, AudioRegistryDevice& p)
+    {
+        p.clear();
+        getOptional<std::string>("hardwareId", p.hardwareId, j, EMPTY_STRING);
+        getOptional<bool>("isDefault", p.isDefault, j, false);
+        getOptional("name", p.name, j);
+        getOptional("manufacturer", p.manufacturer, j);
+        getOptional("model", p.model, j);
+        getOptional("serialNumber", p.serialNumber, j);
+        getOptional("type", p.type, j);
+        getOptional("extra", p.extra, j);
+    }    
+
+
+    //-----------------------------------------------------------
+    JSON_SERIALIZED_CLASS(AudioRegistry)
+    /**
+     * @brief Describes an audio registry
+     *
+     * Helper C++ class to serialize and de-serialize AudioRegistry
+     *
+     * Example: @include[doc] examples/AudioRegistry.json
+     *
+     * @see AudioRegistry
+     */
+    class AudioRegistry : public ConfigurationObjectBase
+    {
+        IMPLEMENT_JSON_SERIALIZATION()
+        IMPLEMENT_JSON_DOCUMENTATION(AudioRegistry)
+
+    public:
+        /** @brief [Optional] List of input devices to use for the registry. */
+        std::vector<AudioRegistryDevice> inputs;
+
+        /** @brief [Optional] List of output devices to use for the registry. */
+        std::vector<AudioRegistryDevice> outputs;
+
+        AudioRegistry()
+        {
+            clear();
+        }
+
+        void clear()
+        {
+            inputs.clear();
+            outputs.clear();
+        }
+
+        virtual std::string toString()
+        {
+            return std::string("");
+        }
+    };
+
+    static void to_json(nlohmann::json& j, const AudioRegistry& p)
+    {
+        j = nlohmann::json{
+            TOJSON_IMPL(inputs),
+            TOJSON_IMPL(outputs)
+        };
+    }
+    static void from_json(const nlohmann::json& j, AudioRegistry& p)
+    {
+        p.clear();
+        getOptional<std::vector<AudioRegistryDevice>>("inputs", p.inputs, j);
+        getOptional<std::vector<AudioRegistryDevice>>("outputs", p.outputs, j);
+    } 
+
     //-----------------------------------------------------------
     JSON_SERIALIZED_CLASS(AudioDeviceDescriptor)
     /**
@@ -3755,12 +3974,18 @@ namespace AppConfigurationObjects
         /** @brief [Optional, Default: first audio device] Id for the input audio device to use for this group. */
         int     inputId;
 
+        /** @brief [Optional] Hardware ID of the input audio device to use for this group. If empty, inputId is used. */
+        std::string     inputHardwareId;
+
         /** @brief [Optional, Default: 0] The percentage at which to gain the input audio. */
         int     inputGain;
 
         /** @brief [Optional, Default: first audio device] Id for the output audio device to use for this group. */
         int     outputId;
 
+        /** @brief [Optional] Hardware ID of the output audio device to use for this group. If empty, outputId is used. */
+        std::string     outputHardwareId;
+
         /** @brief [Optional, Default: 0] The percentage at which to gain the output audio. */
         int     outputGain;
 
@@ -3782,8 +4007,10 @@ namespace AppConfigurationObjects
         {
             enabled = true;
             inputId = 0;
+            inputHardwareId.clear();
             inputGain = 0;
             outputId = 0;
+            outputHardwareId.clear();
             outputGain = 0;
             outputLevelLeft = 100;
             outputLevelRight = 100;
@@ -3796,8 +4023,10 @@ namespace AppConfigurationObjects
         j = nlohmann::json{
             TOJSON_IMPL(enabled),
             TOJSON_IMPL(inputId),
+            TOJSON_IMPL(inputHardwareId),
             TOJSON_IMPL(inputGain),
             TOJSON_IMPL(outputId),
+            TOJSON_IMPL(outputHardwareId),
             TOJSON_IMPL(outputLevelLeft),
             TOJSON_IMPL(outputLevelRight),
             TOJSON_IMPL(outputMuted)
@@ -3808,8 +4037,10 @@ namespace AppConfigurationObjects
         p.clear();
         getOptional<bool>("enabled", p.enabled, j, true);
         getOptional<int>("inputId", p.inputId, j, 0);
+        getOptional<std::string>("inputHardwareId", p.inputHardwareId, j, EMPTY_STRING);
         getOptional<int>("inputGain", p.inputGain, j, 0);
         getOptional<int>("outputId", p.outputId, j, 0);
+        getOptional<std::string>("outputHardwareId", p.outputHardwareId, j, EMPTY_STRING);
         getOptional<int>("outputGain", p.outputGain, j, 0);
         getOptional<int>("outputLevelLeft", p.outputLevelLeft, j, 100);
         getOptional<int>("outputLevelRight", p.outputLevelRight, j, 100);
@@ -4022,6 +4253,9 @@ namespace AppConfigurationObjects
         /** @brief [Optional, Default: 5] The minimum interval to send at to prevent network flooding */
         int             minIntervalSecs;
 
+        /** @brief [Optional, Default: false] Instructs the Engage Engine reduce the immediacy of presence announcements wherever possible */
+        bool            reduceImmediacy;
+
         Presence()
         {
             clear();
@@ -4033,6 +4267,7 @@ namespace AppConfigurationObjects
             intervalSecs = 30;
             listenOnly = false;
             minIntervalSecs = 5;
+            reduceImmediacy = false;
         }
     };
 
@@ -4042,7 +4277,8 @@ namespace AppConfigurationObjects
             TOJSON_IMPL(format),
             TOJSON_IMPL(intervalSecs),
             TOJSON_IMPL(listenOnly),
-            TOJSON_IMPL(minIntervalSecs)
+            TOJSON_IMPL(minIntervalSecs),
+            TOJSON_IMPL(reduceImmediacy)
         };
     }
     static void from_json(const nlohmann::json& j, Presence& p)
@@ -4052,6 +4288,7 @@ namespace AppConfigurationObjects
         getOptional<int>("intervalSecs", p.intervalSecs, j, 30);
         getOptional<bool>("listenOnly", p.listenOnly, j, false);
         getOptional<int>("minIntervalSecs", p.minIntervalSecs, j, 5);
+        getOptional<bool>("reduceImmediacy", p.reduceImmediacy, j, false);
     }
 
 
@@ -4706,6 +4943,82 @@ namespace AppConfigurationObjects
         FROMJSON_IMPL_SIMPLE(alias);
     }
 
+    //-----------------------------------------------------------
+    JSON_SERIALIZED_CLASS(GroupBridgeTargetOutputDetail)
+    /**
+     * @brief Options for Source
+     *
+     *  Helper C++ class to serialize and de-serialize GroupBridgeTargetOutputDetail JSON
+     *
+     *  TODO: Complete this Class
+     *
+     *  Example: @include[doc] examples/GroupBridgeTargetOutputDetail.json
+     *
+     *  @see Group
+     */
+    class GroupBridgeTargetOutputDetail : public ConfigurationObjectBase
+    {
+        IMPLEMENT_JSON_SERIALIZATION()
+        IMPLEMENT_JSON_DOCUMENTATION(GroupBridgeTargetOutputDetail)
+
+    public:
+        /** @brief Enum describing bridging operation mode types where applicable. */
+        typedef enum
+        {
+            /** @brief Raw mode (default) - packet payloads are not accessed or modified and forwarded as raw packets. The
+             * group must have a type of @ref gtRaw.
+             */
+            bomRaw                      = 0,
+
+            /** @brief Audio payloads are transformed, headers are preserved, multiple parallel output streams are 
+             * possible/expected. The group must be gtAudio (type = 1).*/
+            bomMultistream              = 1,
+
+            /** @brief Audio payloads are mixed - output is anonymous (i.e. no metadata) if if the target group(s) 
+             * allow header extensions. The group must be gtAudio (type = 1)*/
+            bomMixedStream              = 2,
+
+            /** @brief No output will be made to the group regardless of type.*/
+            bomNone                     = 3
+        } BridgingOpMode_t;
+
+        /** @brief [Optional] The output mode */
+        BridgingOpMode_t        mode;
+
+        /** @brief [Optional] Parameters to be applied when output is mixed (bomMixedStream) */
+        AdvancedTxParams        mixedStreamTxParams;
+
+        GroupBridgeTargetOutputDetail()
+        {
+            clear();
+        }
+
+        void clear()
+        {
+            mode = BridgingOpMode_t::bomRaw;
+            mixedStreamTxParams.clear();
+        }
+
+        virtual void initForDocumenting()
+        {
+            clear();
+        }
+    };
+
+    static void to_json(nlohmann::json& j, const GroupBridgeTargetOutputDetail& p)
+    {
+        j = nlohmann::json{
+            TOJSON_IMPL(mode),
+            TOJSON_IMPL(mixedStreamTxParams)
+        };
+    }
+    static void from_json(const nlohmann::json& j, GroupBridgeTargetOutputDetail& p)
+    {
+        p.clear();
+        FROMJSON_IMPL_SIMPLE(mode);
+        FROMJSON_IMPL_SIMPLE(mixedStreamTxParams);
+    }    
+
     //-----------------------------------------------------------
     JSON_SERIALIZED_CLASS(Group)
     /**
@@ -4740,23 +5053,6 @@ namespace AppConfigurationObjects
             gtRaw       = 3
         } Type_t;
 
-
-        /** @brief Enum describing bridging operation mode types where applicable. */
-        typedef enum
-        {
-            /** @brief Raw mode (default) - packet payloads are not accessed or modified and forwarded as raw packets */
-            bomRaw                      = 0,
-
-            /** @brief Audio payloads are transformed, headers are preserved, multiple parallel output streams are possible/expected */
-            bomPayloadTransformation    = 1,
-
-            /** @brief Audio payloads are mixed - output is anonymous (i.e. no metadata) if if the target group(s) allow header extensions */
-            bomAnonymousMixing          = 2,
-
-            /** @brief The bridge performs language translations between groups */
-            bomLanguageTranslation      = 3
-        } BridgingOpMode_t;
-
         /** @brief Enum describing the alias generation policy. */
         typedef enum
         {
@@ -4770,8 +5066,8 @@ namespace AppConfigurationObjects
         /** @brief Specifies the group type (see @ref Type_t). */
         Type_t                                  type;
 
-        /** @brief Specifies the bridging operation mode if applicable (see @ref BridgingOpMode_t). */
-        BridgingOpMode_t                        bom;
+        /** @brief Output details for when the group is a target in a bridge (see @ref GroupBridgeTargetOutputDetail). */
+        GroupBridgeTargetOutputDetail          bridgeTargetOutputDetail;
 
         /**
          * @brief Unique identity for the group.
@@ -4937,7 +5233,7 @@ namespace AppConfigurationObjects
         void clear()
         {
             type = gtUnknown;
-            bom = bomRaw;
+            bridgeTargetOutputDetail.clear();
             id.clear();
             name.clear();
             spokenName.clear();
@@ -5014,7 +5310,7 @@ namespace AppConfigurationObjects
     {
         j = nlohmann::json{
             TOJSON_IMPL(type),
-            TOJSON_IMPL(bom),
+            TOJSON_IMPL(bridgeTargetOutputDetail),
             TOJSON_IMPL(id),
             TOJSON_IMPL(name),
             TOJSON_IMPL(spokenName),
@@ -5106,7 +5402,7 @@ namespace AppConfigurationObjects
     {
         p.clear();
         j.at("type").get_to(p.type);
-        getOptional<Group::BridgingOpMode_t>("bom", p.bom, j, Group::BridgingOpMode_t::bomRaw);
+        getOptional<GroupBridgeTargetOutputDetail>("bridgeTargetOutputDetail", p.bridgeTargetOutputDetail, j);
         j.at("id").get_to(p.id);
         getOptional<std::string>("name", p.name, j);
         getOptional<std::string>("spokenName", p.spokenName, j);
@@ -5724,7 +6020,9 @@ namespace AppConfigurationObjects
         /** @brief List of group IDs to be included in the session */
         std::vector<std::string>    groups;
 
-        /** @brief [Optional, Default: true] Enable the bridge */
+        /** @brief [Optional, Default: true] Enable the bridge 
+        * NOTE: this is only used bt EBS and is ignored when calling engageCreateBridge() is called
+        */
         bool                        enabled;
 
         Bridge()
@@ -5931,6 +6229,9 @@ namespace AppConfigurationObjects
         /** @brief [Optional, Default: false] If true, input audio is written to a PCM file in the data directory */
         bool                saveOutputPcm;
 
+        /** @brief [Optional] If specified, this registry will be used to discover the input and output devices */
+        AudioRegistry         registry;
+
 
         EnginePolicyAudio()
         {
@@ -5953,6 +6254,7 @@ namespace AppConfigurationObjects
             denoiseOutput = false;
             saveInputPcm = false;
             saveOutputPcm = false;
+            registry.clear();
         }
     };
 
@@ -5972,7 +6274,8 @@ namespace AppConfigurationObjects
             TOJSON_IMPL(denoiseInput),
             TOJSON_IMPL(denoiseOutput),
             TOJSON_IMPL(saveInputPcm),
-            TOJSON_IMPL(saveOutputPcm)
+            TOJSON_IMPL(saveOutputPcm),
+            TOJSON_IMPL(registry)
         };
     }
     static void from_json(const nlohmann::json& j, EnginePolicyAudio& p)
@@ -5993,6 +6296,7 @@ namespace AppConfigurationObjects
         FROMJSON_IMPL(denoiseOutput, bool, false);
         FROMJSON_IMPL(saveInputPcm, bool, false);
         FROMJSON_IMPL(saveOutputPcm, bool, false);
+        getOptional<AudioRegistry>("registry", p.registry, j);
     }
 
     //-----------------------------------------------------------
@@ -7655,6 +7959,12 @@ namespace AppConfigurationObjects
 
         OutboundLeafPolicy_t    outboundLeafPolicy;
 
+        /** @brief [Optional, Default: Rallypoint::RpProtocol_t::rppTlsTcp] Protocol to use for the peer */
+        Rallypoint::RpProtocol_t    protocol;
+
+        /** @brief [Optional, Default: ""] Path to use for the peer (only used for WebSocket) */
+        std::string                     path;
+
         RallypointPeer()
         {
             clear();
@@ -7669,6 +7979,8 @@ namespace AppConfigurationObjects
             connectionTimeoutSecs = 0;
             forceIsMeshLeaf = false;
             outboundLeafPolicy = OutboundLeafPolicy_t::olpUseRpConfiguration;
+            protocol = Rallypoint::RpProtocol_t::rppTlsTcp;
+            path.clear();
         }
     };
 
@@ -7681,7 +7993,9 @@ namespace AppConfigurationObjects
             TOJSON_IMPL(certificate),
             TOJSON_IMPL(connectionTimeoutSecs),
             TOJSON_IMPL(forceIsMeshLeaf),
-            TOJSON_IMPL(outboundLeafPolicy)
+            TOJSON_IMPL(outboundLeafPolicy),
+            TOJSON_IMPL(protocol),
+            TOJSON_IMPL(path)
         };
     }
     static void from_json(const nlohmann::json& j, RallypointPeer& p)
@@ -7694,6 +8008,8 @@ namespace AppConfigurationObjects
         getOptional<int>("connectionTimeoutSecs", p.connectionTimeoutSecs, j, 0);
         getOptional<bool>("forceIsMeshLeaf", p.forceIsMeshLeaf, j, false);
         getOptional<RallypointPeer::OutboundLeafPolicy_t>("outboundLeafPolicy", p.outboundLeafPolicy, j, RallypointPeer::OutboundLeafPolicy_t::olpUseRpConfiguration);
+        getOptional<Rallypoint::RpProtocol_t>("protocol", p.protocol, j, Rallypoint::RpProtocol_t::rppTlsTcp);
+        getOptional<std::string>("path", p.path, j);
     }
 
     //-----------------------------------------------------------
@@ -8537,6 +8853,9 @@ namespace AppConfigurationObjects
         /** @brief [Default: false] Indicates whether the client is required to present a certificate */
         bool                                    requireClientCertificate;
 
+        /** @brief [Default: false] Indicates whether TLS is required */
+        bool                                    requireTls;
+
         RallypointWebsocketSettings()
         {
             clear();
@@ -8548,6 +8867,7 @@ namespace AppConfigurationObjects
             listenPort = 8443;
             certificate.clear();
             requireClientCertificate = false;
+            requireTls = true;
         }
     };
 
@@ -8557,7 +8877,8 @@ namespace AppConfigurationObjects
             TOJSON_IMPL(enabled),
             TOJSON_IMPL(listenPort),
             TOJSON_IMPL(certificate),
-            TOJSON_IMPL(requireClientCertificate)
+            TOJSON_IMPL(requireClientCertificate),
+            TOJSON_IMPL(requireTls)
         };
     }
     static void from_json(const nlohmann::json& j, RallypointWebsocketSettings& p)
@@ -8567,6 +8888,7 @@ namespace AppConfigurationObjects
         getOptional<int>("listenPort", p.listenPort, j, 8443);
         getOptional<SecurityCertificate>("certificate", p.certificate, j);
         getOptional<bool>("requireClientCertificate", p.requireClientCertificate, j, false);
+        getOptional<bool>("requireTls", p.requireTls, j, true);
     }
 
 
@@ -8643,6 +8965,54 @@ namespace AppConfigurationObjects
     }
 
 
+
+
+    //-----------------------------------------------------------
+    JSON_SERIALIZED_CLASS(NamedIdentity)
+    /**
+     * @brief Defines settings for a named identity
+     *
+     * Example: @include[doc] examples/NamedIdentity.json
+     *
+     */
+    class NamedIdentity : public ConfigurationObjectBase
+    {
+        IMPLEMENT_JSON_SERIALIZATION()
+        IMPLEMENT_JSON_DOCUMENTATION(NamedIdentity)
+
+    public:
+        /** @brief The identity name */
+        std::string                             name;
+
+        /** @brief The identity certificate */
+        SecurityCertificate                     certificate;
+
+        NamedIdentity()
+        {
+            clear();
+        }
+
+        void clear()
+        {
+            name.clear();
+            certificate.clear();
+        }
+    };
+
+    static void to_json(nlohmann::json& j, const NamedIdentity& p)
+    {
+        j = nlohmann::json{
+            TOJSON_IMPL(name),
+            TOJSON_IMPL(certificate)
+        };
+    }
+    static void from_json(const nlohmann::json& j, NamedIdentity& p)
+    {
+        p.clear();
+        getOptional<std::string>("name", p.name, j);
+        getOptional<SecurityCertificate>("certificate", p.certificate, j);
+    }
+
     //-----------------------------------------------------------
     JSON_SERIALIZED_CLASS(RallypointExtendedGroupRestriction)
     /**
@@ -8706,6 +9076,32 @@ namespace AppConfigurationObjects
         IMPLEMENT_JSON_DOCUMENTATION(RallypointServer)
 
     public:        
+        typedef enum
+        {
+            sptDefault              = 0,
+            sptCertificate          = 1,
+            sptCertPublicKey        = 2,
+            sptCertSubject          = 3,
+            sptCertIssuer           = 4,
+            sptCertFingerprint      = 5,
+            sptCertSerial           = 6,
+            sptSubjectC             = 7,
+            sptSubjectST            = 8,
+            sptSubjectL             = 9,
+            sptSubjectO             = 10,
+            sptSubjectOU            = 11,
+            sptSubjectCN            = 12,
+            sptIssuerC              = 13,
+            sptIssuerST             = 14,
+            sptIssuerL              = 15,
+            sptIssuerO              = 16,
+            sptIssuerOU             = 17,
+            sptIssuerCN             = 18
+        } StreamIdPrivacyType_t;
+
+        /** @brief [Optional, default sptDefault] Modes for stream ID transformation. */
+        StreamIdPrivacyType_t                       streamIdPrivacyType;
+
         /** @brief [Optional] Settings for the FIPS crypto. */
         FipsCryptoSettings                          fipsCrypto;
     
@@ -8880,6 +9276,9 @@ namespace AppConfigurationObjects
         /** @brief [Optional] Low-level tuning */
         TuningSettings                          tuning; 
 
+        /** @brief [Optional] List of additional named identities */
+        std::vector<NamedIdentity>               additionalIdentities;
+
         RallypointServer()
         {
             clear();
@@ -8945,6 +9344,8 @@ namespace AppConfigurationObjects
             blockedDomains.clear();
             extraDomains.clear();
             tuning.clear();
+            additionalIdentities.clear();
+            streamIdPrivacyType = StreamIdPrivacyType_t::sptDefault;
         }
     };
 
@@ -9008,7 +9409,9 @@ namespace AppConfigurationObjects
             TOJSON_IMPL(allowedDomains),
             TOJSON_IMPL(blockedDomains),
             TOJSON_IMPL(extraDomains),
-            TOJSON_IMPL(tuning)
+            TOJSON_IMPL(tuning),
+            TOJSON_IMPL(additionalIdentities),
+            TOJSON_IMPL(streamIdPrivacyType)
         };
     }
     static void from_json(const nlohmann::json& j, RallypointServer& p)
@@ -9072,6 +9475,8 @@ namespace AppConfigurationObjects
         getOptional<std::vector<std::string>>("blockedDomains", p.blockedDomains, j);
         getOptional<std::vector<std::string>>("extraDomains", p.extraDomains, j);
         getOptional<TuningSettings>("tuning", p.tuning, j);
+        getOptional<std::vector<NamedIdentity>>("additionalIdentities", p.additionalIdentities, j);
+        getOptional<RallypointServer::StreamIdPrivacyType_t>("streamIdPrivacyType", p.streamIdPrivacyType, j, RallypointServer::StreamIdPrivacyType_t::sptDefault);
     }
 
     //-----------------------------------------------------------
@@ -9609,6 +10014,9 @@ namespace AppConfigurationObjects
         /** @brief Array of subject elements */
         std::vector<CertificateSubjectElement>          subjectElements;
 
+        /** @brief Array of issuer elements */
+        std::vector<CertificateSubjectElement>          issuerElements;        
+
         /** @brief PEM version of the certificate */
         std::string                                     certificatePem;
 
@@ -9631,6 +10039,7 @@ namespace AppConfigurationObjects
             serial.clear();
             fingerprint.clear();
             subjectElements.clear();
+            issuerElements.clear();
             certificatePem.clear();
             publicKeyPem.clear();
         }
@@ -9648,6 +10057,7 @@ namespace AppConfigurationObjects
             TOJSON_IMPL(serial),
             TOJSON_IMPL(fingerprint),
             TOJSON_IMPL(subjectElements),
+            TOJSON_IMPL(issuerElements),
             TOJSON_IMPL(certificatePem),
             TOJSON_IMPL(publicKeyPem)
         };
@@ -9666,6 +10076,7 @@ namespace AppConfigurationObjects
         getOptional<std::string>("certificatePem", p.certificatePem, j, EMPTY_STRING);
         getOptional<std::string>("publicKeyPem", p.publicKeyPem, j, EMPTY_STRING);
         getOptional<std::vector<CertificateSubjectElement>>("subjectElements", p.subjectElements, j);
+        getOptional<std::vector<CertificateSubjectElement>>("issuerElements", p.issuerElements, j);
     }
 
 
@@ -9975,6 +10386,12 @@ namespace AppConfigurationObjects
 
             /** @brief  TX has ended with a failure */
             txsTxEndedWithFailure           = -10,
+
+            /** @brief  Attempt to transmit on a bridged group that is not bomMultistream */
+            txsBridgedButNotMultistream     = -11,
+
+            /** @brief  Transmission was automatically ended because the group became bridged on a non-multistream configuration */
+            txsAutoEndedDueToNonMultistreamBridge     = -12        
         } TxStatus_t;
 
         /** @brief ID of the group */
@@ -10097,6 +10514,12 @@ namespace AppConfigurationObjects
 
             /** @brief The transport type is invalid */
             csInvalidTransport                  = -11,
+
+            /** @brief Audio input device not found in registry */
+            csAudioInputDeviceNotFound          = -12,
+
+            /** @brief Audio output device not found in registry */
+            csAudioOutputDeviceNotFound         = -13
         } CreationStatus_t;
 
         /** @brief ID of the group */
@@ -11250,26 +11673,33 @@ namespace AppConfigurationObjects
         IMPLEMENT_JSON_DOCUMENTATION(BridgingServerConfiguration)
 
     public:
-        /** @brief Enum describing the modes the briging service runs in. */
+        /** @brief Enum describing the default mode the bridging service runs in. Values of omRaw,
+         *          omMultistream, omAnonymousMixedStream all cause the service to force the
+         *          groups in a bridge to the appropriate type.  A value of omADictatedByGroup prevents
+         *          the service from forcing the individual groups' "type" and "bom" values and
+         *          instead relies on the individual groups to be correctly defined in the configuration.
+          */
         typedef enum
         {
-            /** @brief Raw mode (default) - packet payloads are not accessed or modified and forwarded as raw packets */
+            /** @brief Raw mode (default) - packet payloads are not accessed or modified and forwarded as raw packets. */
             omRaw                       = 0,
 
-            /** @brief Audio payloads are transformed, headers are preserved, multiple parallel output streams are possible/expected */
-            omPayloadTransformation     = 1,
+            /** @brief Audio payloads are transformed, headers are preserved, multiple parallel output streams are 
+             * possible/expected. In this mode all groups must be gtAudio (type = 1).*/
+            omMultistream               = 1,
 
-            /** @brief Audio payloads are mixed - output is anonymous (i.e. no metadata) if if the target group(s) allow header extensions */
-            omAnonymousMixing           = 2,
+            /** @brief Audio payloads are mixed - output is anonymous (i.e. no metadata) even if the target group(s) 
+             * allow header extensions.  In this mode all groups must be gtAudio (type = 1). */
+            omMixedStream               = 2,
 
-            /** @brief Audio payloads are translated between group-specific languages */
-            omLanguageTranslation       = 3
+            /** @brief Operation is dictated by the individual groups in the bridge */
+            omADictatedByGroup          = 3,
         } OpMode_t;
 
         /** @brief A unqiue identifier for the bridge server */
         std::string                                 id;
 
-        /** @brief Specifies the operation mode (see @ref OpMode_t). */
+        /** @brief Specifies the default operation mode (see @ref OpMode_t). */
         OpMode_t                                    mode;
 
         /** @brief Number of seconds between checks to see if the service configuration has been updated.  Default is 60.*/

package/include/EngageConstants.h

@@ -24,10 +24,11 @@
 #endif
 
 static const size_t ENGAGE_MAX_CRYPTO_PASSWORD_BYTES = 256;
+static const uint64_t ENGAGE_ROOT_CA_CERTIFICATE_CACHE_EXPIRATION_MS = (60 * 1000);
 
 static const int ENGAGE_INVALID_IP_ADDRESS_FAMILY = -1;
 
-static const size_t ENGAGE_MAX_RTP_OUTPUT_QUEUE_PACKETS = 100;
+static const size_t ENGAGE_MAX_OUTPUT_QUEUED_UDP_PACKETS = 1024;
 
 static const size_t ENGAGE_MAX_IP_ADDR_SIZE = sizeof(struct sockaddr_in6);
 static const size_t ENGAGE_MAX_ALIAS_SIZE = 16;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "engage-engine",
-  "version": "1.251.90910019",
+  "version": "1.251.90910021",
   "description": "Use Engage to communicate with everyone, everywhere, from any device",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"