Changeset 5417 for pjproject/trunk/pjsip/include/pjsua2/call.hpp

Timestamp:

Aug 12, 2016 3:47:26 AM (8 years ago)

Author:

ming

Message:

Fixed #1951: Add callback to configure SRTP setting and key in pjsua/pjsua2

File:

• pjproject/trunk/pjsip/include/pjsua2/call.hpp (modified) (2 diffs)

pjproject/trunk/pjsip/include/pjsua2/call.hpp

@@ -950 +950 @@
      */
     unsigned        flags;
+};
+
+/**
+ * SRTP crypto.
+ */
+struct SrtpCrypto
+{
+    /**
+     * Optional key. If empty, a random key will be autogenerated.
+     */
+    string      key;
+
+    /**
+     * Crypto name.
+     */
+    string      name;
+
+    /**
+     * Flags, bitmask from #pjmedia_srtp_crypto_option
+     */
+    unsigned    flags;
+};
+
+/**
+ * This structure contains parameters for Call::onCreateMediaTransportSrtp()
+ * callback.
+ */
+struct OnCreateMediaTransportSrtpParam
+{
+    /**
+     * The media index in the SDP for which the SRTP media transport
+     * will be used.
+     */
+    unsigned                    mediaIdx;
+    
+    /**
+     * Specify whether secure media transport should be used. Application
+     * can modify this only for initial INVITE.
+     * Valid values are PJMEDIA_SRTP_DISABLED, PJMEDIA_SRTP_OPTIONAL, and
+     * PJMEDIA_SRTP_MANDATORY.
+     */
+    pjmedia_srtp_use            srtpUse;
+    
+    /**
+     * Application can modify this to specify the cryptos and keys
+     * which are going to be used.
+     */
+    vector<SrtpCrypto>          cryptos;
 };
 
@@ -1744 +1792 @@
     { PJ_UNUSED_ARG(prm); }
 
+    /**
+     * This callback is called when SRTP media transport is created.
+     * Application can modify the SRTP setting \a srtpOpt to specify
+     * the cryptos and keys which are going to be used. Note that
+     * application should not modify the field
+     * \a pjmedia_srtp_setting.close_member_tp and can only modify
+     * the field \a pjmedia_srtp_setting.use for initial INVITE.
+     *
+     * @param prm       Callback parameter.
+     */
+    virtual void
+    onCreateMediaTransportSrtp(OnCreateMediaTransportSrtpParam &prm)
+    { PJ_UNUSED_ARG(prm); }
+
 private:
     Account             &acc;