Changeset 4669 for pjproject/branches/projects/pjsua2/pjsip/include/pjsua2/media.hpp

Timestamp:

Dec 3, 2013 10:45:36 AM (10 years ago)

Author:

riza

Message:

Re #1519: Added codec management operations to Media API in pjsua2.

File:

• pjproject/branches/projects/pjsua2/pjsip/include/pjsua2/media.hpp (modified) (5 diffs)

pjproject/branches/projects/pjsua2/pjsip/include/pjsua2/media.hpp

@@ -276 +276 @@
      * the media port from the conference bridge and Endpoint's media list.
      * Descendant should only call this method if it has registered the media
-     * with the previous call to #registerMediaPort().
+     * with the previous call to registerMediaPort().
      */
     void unregisterMediaPort();
@@ -432 +432 @@
 
     /**
-     * Device capabilities, as bitmask combination of #pjmedia_aud_dev_cap.
+     * Device capabilities, as bitmask combination of pjmedia_aud_dev_cap.
      */
     unsigned caps;
@@ -438 +438 @@
     /**
      * Supported audio device routes, as bitmask combination of
-     * #pjmedia_aud_dev_route. The value may be zero if the device
+     * pjmedia_aud_dev_route. The value may be zero if the device
      * does not support audio routing.
      */
@@ -562 +562 @@
      * Check whether the sound device is currently active. The sound device
      * may be inactive if the application has set the auto close feature to
-     * non-zero (the sndAutoCloseTime setting in #MediaConfig), or
+     * non-zero (the sndAutoCloseTime setting in MediaConfig), or
      * if null sound device or no sound device has been configured via the
-     * #setNoDev() function.
+     * setNoDev() function.
      */
     bool sndIsActive() const;
@@ -1054 +1054 @@
 };
 
+/*************************************************************************
+* Codec management
+*/
+
+/**
+ * This structure describes codec information.
+ */
+struct CodecInfo
+{
+    /**
+     * Codec unique identification.
+     */
+    string              codecId;
+
+    /**
+     * Codec priority (integer 0-255).
+     */
+    pj_uint8_t          priority;
+
+    /**
+     * Codec description.
+     */
+    string              desc;
+
+    /**
+     * Construct from pjsua_codec_info.
+     */
+    void fromPj(const pjsua_codec_info &codec_info);
+};
+
+/** Array of codec info */
+typedef std::vector<CodecInfo*> CodecInfoVector;
+
+/**
+ * Codec parameters, corresponds to pjmedia_codec_param or
+ * pjmedia_vid_codec_param.
+ */
+typedef void *CodecParam;
+
 } // namespace pj