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

Timestamp:

Apr 23, 2019 10:49:56 AM (6 years ago)

Author:

nanang

Message:

Re #2181: Implemented video conference APIs for PJSUA2.

File:

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

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

@@ -334 +334 @@
 /**
  * Call media information.
+ *
+ * Application can query conference bridge port of this media using
+ * Call::getAudioMedia() if the media type is audio,
+ * or Call::getEncodingVideoMedia()/Call::getDecodingVideoMedia()
+ * if the media type is video.
  */
 struct CallMediaInfo
@@ -358 +363 @@
     
     /**
+     * Warning: this is deprecated, application can query conference bridge
+     * port of this media using Call::getAudioMedia().
+     *
      * The conference port number for the call. Only valid if the media type
      * is audio.
@@ -375 +383 @@
      */
     VideoWindow             videoWindow;
-    
+
     /**
      * The video capture device for outgoing transmission, if any,
@@ -1251 +1259 @@
      * index is not audio or invalid or inactive, exception will be thrown.
      *
-     * @param med_idx       Media index.
+     * @param med_idx       Media index, or -1 to specify any first audio
+     *                      media registered in the conference bridge.
      *
      * @return              The audio media.
      */
-    AudioMedia getAudioMedia(unsigned med_idx) const throw(Error);
+    AudioMedia getAudioMedia(int med_idx) const throw(Error);
+
+    /**
+     * Get video media in encoding direction for the specified media index.
+     * If the specified media index is not video or invalid or the direction
+     * is receive only, exception will be thrown.
+     *
+     * @param med_idx       Media index, or -1 to specify any first video
+     *                      media with encoding direction registered in the
+     *                      conference bridge.
+     *
+     * @return              The video media.
+     */
+    VideoMedia getEncodingVideoMedia(int med_idx) const throw(Error);
+
+    /**
+     * Get video media in decoding direction for the specified media index.
+     * If the specified media index is not video or invalid or the direction
+     * is send only, exception will be thrown.
+     *
+     * @param med_idx       Media index, or -1 to specify any first video
+     *                      media with decoding direction registered in the
+     *                      conference bridge.
+     *
+     * @return              The video media.
+     */
+    VideoMedia getDecodingVideoMedia(int med_idx) const throw(Error);
 
     /**