Changeset 2468 for pjproject/branches/projects/aps-direct/pjsip/include/pjsua-lib/pjsua.h

Timestamp:

Feb 21, 2009 2:21:59 PM (15 years ago)

Author:

bennylp

Message:

Updated libraries and applications to use the new Audio Device API

File:

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

pjproject/branches/projects/aps-direct/pjsip/include/pjsua-lib/pjsua.h

@@ -4201 +4201 @@
     unsigned            ec_tail_len;
 
+    /**
+     * Audio capture buffer length, in milliseconds.
+     *
+     * Default: PJMEDIA_SND_DEFAULT_REC_LATENCY
+     */
+    unsigned            snd_rec_latency;
+
+    /**
+     * Audio playback buffer length, in milliseconds.
+     *
+     * Default: PJMEDIA_SND_DEFAULT_PLAY_LATENCY
+     */
+    unsigned            snd_play_latency;
+
     /** 
      * Jitter buffer initial prefetch delay in msec. The value must be
@@ -4805 +4819 @@
  *
  */
+#if PJMEDIA_AUDIO_API==PJMEDIA_AUDIO_API_NEW_ONLY
+PJ_DECL(pj_status_t) pjsua_enum_snd_devs(pjmedia_aud_dev_info info[],
+                                         unsigned *count);
+#else
 PJ_DECL(pj_status_t) pjsua_enum_snd_devs(pjmedia_snd_dev_info info[],
                                          unsigned *count);
-
+#endif
 
 
@@ -4880 +4898 @@
 
 /**
- * Configure the echo canceller tail length of the sound port.
+ * Change the echo cancellation settings. The behavior of this function 
+ * depends on whether the sound device is currently active, and if it is,
+ * whether device or software AEC is being used. 
+ *
+ * If the sound device is currently active, and if the device supports AEC,
+ * this function will forward the change request to the device and it will
+ * be up to the device on whether support the request. If software AEC is
+ * being used (the software EC will be used if the device does not support
+ * AEC), this function will change the software EC settings. In all cases,
+ * the setting will be saved for future opening of the sound device.
+ *
+ * If the sound device is not currently active, this will only change the
+ * default AEC settings and the setting will be applied next time the 
+ * sound device is opened.
  *
  * @param tail_ms       The tail length, in miliseconds. Set to zero to
@@ -4911 +4942 @@
  */
 PJ_DECL(pj_status_t) pjsua_get_ec_tail(unsigned *p_tail_ms);
-
-
-/**
- * Set sound device route.
- *
- * @param route         Sound device route to be set.
- *
- * @return              PJ_SUCCESS on success, or the appropriate error code.
- */
-PJ_DECL(pj_status_t) pjsua_set_snd_route(pjmedia_snd_route route);