Changeset 5123 for pjproject/trunk/pjsip/include/pjsua2/endpoint.hpp

Timestamp:

Jul 1, 2015 2:20:12 AM (9 years ago)

Author:

riza

Message:

Re #1863: Initial implementation of PJSUA2 Video Codec API and Video Device API.

• Codec management (enum codec, set prio, get param, set param)
• Device management (enum dev, dev count, dev info).

File:

• pjproject/trunk/pjsip/include/pjsua2/endpoint.hpp (modified) (5 diffs)

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

@@ -1070 +1070 @@
     AudDevManager &audDevManager();
 
+    /**
+     * Get the instance of Video Device Manager.
+     *
+     * @return          The Video Device Manager.
+     */
+    VidDevManager &vidDevManager();
+
     /*************************************************************************
      * Codec management operations
@@ -1096 +1103 @@
      * Get codec parameters.
      *
-     * @param codec_id          Codec ID.
-     *
-     * @return                  Codec parameters. If codec is not found, Error
-     *                          will be thrown.
+     * @param codec_id  Codec ID.
+     *
+     * @return          Codec parameters. If codec is not found, Error
+     *                  will be thrown.
      *
      */
@@ -1115 +1122 @@
                        const CodecParam param) throw(Error);
 
+    /**
+     * Enum all supported video codecs in the system.
+     *  
+     * @return          Array of video codec info.
+     */
+    const CodecInfoVector &videoCodecEnum() throw(Error);
+
+    /**
+     * Change video codec priority.
+     *
+     * @param codec_id  Codec ID, which is a string that uniquely identify
+     *                  the codec (such as "H263/90000"). Please see pjsua
+     *                  manual or pjmedia codec reference for details.
+     * @param priority  Codec priority, 0-255, where zero means to disable
+     *                  the codec.
+     *
+     */
+    void videoCodecSetPriority(const string &codec_id,
+                               pj_uint8_t priority) throw(Error);
+
+    /**
+     * Get video codec parameters.
+     *
+     * @param codec_id  Codec ID.
+     *
+     * @return          Codec parameters. If codec is not found, Error 
+     *                  will be thrown.
+     *
+     */
+    CodecParam videoCodecGetParam(const string &codec_id) const throw(Error);
+
+    /**
+     * Set video codec parameters.
+     *
+     * @param codec_id  Codec ID.
+     * @param param     Codec parameter to set. Set to NULL to reset
+     *                  codec parameter to library default settings.
+     *
+     */
+    void videoCodecSetParam(const string &codec_id,
+                            const CodecParam param) throw(Error);
 
 public:
@@ -1183 +1231 @@
     AudioMediaVector             mediaList;
     AudDevManager                audioDevMgr;
+    VidDevManager                videoDevMgr;
     CodecInfoVector              codecInfoList;
+    CodecInfoVector              videoCodecInfoList;
     std::map<pj_thread_t*, pj_thread_desc*> threadDescMap;
 
@@ -1317 +1367 @@
 
 private:
-    void clearCodecInfoList();
+    void clearCodecInfoList(CodecInfoVector &codec_list);
+    void updateCodecInfoList(pjsua_codec_info pj_codec[], unsigned count,
+                             CodecInfoVector &codec_list);
 
 };