Changeset 3657 for pjproject/branches/projects/2.0-dev/pjsip/include/pjsua-lib/pjsua.h

Timestamp:

Jul 15, 2011 7:41:02 AM (13 years ago)

Author:

nanang

Message:

Re #1263:

• Replaced video stream operation DISABLE into REMOVE.
• Replaced video stream operation ENABLE into CHANGEDIR.
• Added new param: media direction, used in operation ADD and CHANGEDIR.
• Updated video stream operation START_TRANSMIT to ignore capture device param (as changing capture device is handled by CHANGE_CAP_DEV operation).

File:

• pjproject/branches/projects/2.0-dev/pjsip/include/pjsua-lib/pjsua.h (modified) (4 diffs)

pjproject/branches/projects/2.0-dev/pjsip/include/pjsua-lib/pjsua.h

@@ -382 +382 @@
 
     /**
-     * Disable/remove an existing video stream.
-     */
-    PJSUA_CALL_VID_STRM_DISABLE,
-
-    /**
-     * Enable video stream.
-     */
-    PJSUA_CALL_VID_STRM_ENABLE,
-
-    /**
-     * Changing capture device of a video stream.
+     * Remove/disable an existing video stream.
+     */
+    PJSUA_CALL_VID_STRM_REMOVE,
+
+    /**
+     * Change direction of a video stream.
+     */
+    PJSUA_CALL_VID_STRM_CHANGE_DIR,
+
+    /**
+     * Change capture device of a video stream.
      */
     PJSUA_CALL_VID_STRM_CHANGE_CAP_DEV,
@@ -421 +421 @@
      * This field is valid for all video stream operations, except
      * PJSUA_CALL_VID_STRM_ADD.
+     *
+     * Default: -1 (first active video stream, or any first video stream
+     *              if none is active)
      */
     int med_idx;
+ 
+    /**
+     * Specify the media stream direction.
+     *
+     * This field is valid for the following video stream operations:
+     * PJSUA_CALL_VID_STRM_ADD and PJSUA_CALL_VID_STRM_CHANGE_DIR.
+     *
+     * Default: PJMEDIA_DIR_ENCODING_DECODING
+     */
+    pjmedia_dir dir;
  
     /**
@@ -430 +443 @@
      *
      * This field is valid for the following video stream operations:
-     * PJSUA_CALL_VID_STRM_ADD, PJSUA_CALL_VID_STRM_CHANGE_CAP_DEV, and
-     * PJSUA_CALL_VID_STRM_START_TRANSMIT.
+     * PJSUA_CALL_VID_STRM_ADD and PJSUA_CALL_VID_STRM_CHANGE_CAP_DEV.
+     *
+     * Default: capture device configured in account.
      */
     pjmedia_vid_dev_index cap_dev;
@@ -3773 +3787 @@
  * @param op            The video stream operation to be performed,
  *                      possible values are #pjsua_call_vid_strm_op.
- * @param param         The parameters for the video stream operation.
+ * @param param         The parameters for the video stream operation,
+ *                      or NULL for the default parameter values
+ *                      (see #pjsua_call_vid_strm_op_param).
  *
  * @return              PJ_SUCCESS on success or the appropriate error.