Changeset 2578 for pjproject/trunk/pjmedia/include/pjmedia/jbuf.h

Timestamp:

Apr 6, 2009 5:05:34 PM (15 years ago)

Author:

nanang

Message:

Ticket #762: Major updates on jitter buffer:

• Updated loop condition in put_frame() to avoid possibility of infinite loop.
• Added JB capabilities to handle sequence restart & jump.
• Updated jitter calculation, e.g: reset max_hist_level after updating prefetch, avoid updating prefetch when burst level is exceeding max_burst.
• Updated shrinking method to be less agressive (only shrink JB when JB size is twice larger than burst level).
• Updated the way JB switching status from 'initializing' to 'processing' by waiting for some OP switch cycles.
• Few simplifications in framelist process, e.g: replacing fields 'empty' & 'tail' with 'size'.
• Minor updates: comments, shortened framelist field names, added some JB states for reporting/monitoring purpose.

File:

• pjproject/trunk/pjmedia/include/pjmedia/jbuf.h (modified) (1 diff)

pjproject/trunk/pjmedia/include/pjmedia/jbuf.h

@@ -67 +67 @@
 
 /**
- * This structure describes jitter buffer current status.
+ * This structure describes jitter buffer state.
  */
 struct pjmedia_jb_state
 {
+    /* Setting */
     unsigned    frame_size;         /**< Individual frame size, in bytes.   */
-    unsigned    prefetch;           /**< Current prefetch value, in frames  */
     unsigned    min_prefetch;       /**< Minimum allowed prefetch, in frms. */
     unsigned    max_prefetch;       /**< Maximum allowed prefetch, in frms. */
+
+    /* Status */
+    unsigned    prefetch;           /**< Current prefetch value, in frames  */
     unsigned    size;               /**< Current buffer size, in frames.    */
+
+    /* Statistic */
     unsigned    avg_delay;          /**< Average delay, in ms.              */
     unsigned    min_delay;          /**< Minimum delay, in ms.              */
     unsigned    max_delay;          /**< Maximum delay, in ms.              */
-    unsigned    dev_delay;          /**< Standard deviation of delay, in ms. */
+    unsigned    dev_delay;          /**< Standard deviation of delay, in ms.*/
+    unsigned    avg_burst;          /**< Average burst, in frames.          */
+    unsigned    lost;               /**< Number of lost frames.             */
+    unsigned    discard;            /**< Number of discarded frames.        */
+    unsigned    empty;              /**< Number of empty on GET events.     */
 };