CAF: Working With Caf Call Legs - Revision history

Abrassard: Minor example code fix

2016-07-04T19:03:07Z

Minor example code fix

2016-02-24T11:26:18Z

Creating the CTBCAFCallFlow object, its legs and mixers

2014-03-05T14:27:25Z

Join/Unjoin API

2014-03-05T14:27:04Z

Doc for joining mixers

2014-03-05T14:12:20Z

Scenario: Audio forking

2014-03-05T14:09:19Z

Scenario: Changing from hald-duplex to full-duplex

2014-03-05T14:08:10Z

Scenario: Changing from hald-duplex to full-duplex

2014-03-05T14:07:41Z

Joining call legs

2014-03-05T14:05:15Z

Scenario: Changing from hald-duplex to full-duplex

2014-03-05T14:01:02Z

Scenario: Inverting direction of half-duplex join

@@ Line 156: / Line 156: @@
     CTBCMC_EVENT_ATTRIBUTE  Event;
     Event.AddToneString( "telcofax/eof" );
-    GetIncomingActiveLeg()->StartEventCollection( in_EventMask, NULL, TBX_FALSE /* Don't suppress tones */ );
+    GetIncomingActiveLeg()->StartEventCollection( Event, NULL, TBX_FALSE /* Don't suppress tones */ );
     // Call base class to forward event to next behavior

@@ Line 144: / Line 144: @@
   // Create an audio mixer
-  pCallFlow->MixerCreate( ptrMixerAttribute );
+  pCallFlow->AddMixer( ptrMixerAttribute );
   // Initialize the call (this actually creates the call legs)

@@ Line 413: / Line 413: @@
-=== Join/Unjoin API ===
+=== Mixer Join/Unjoin API ===
 Joining with mixers is made by using the mixer's functions ''MixerJoin()''
   TBX_RESULT CTBCMCMixer::MixerJoin

@@ Line 400: / Line 400: @@
 * pLegB->Join( pLegC );
 ** ==> Error!
 == Re-synchronizing with [[Toolpack_Application:toolpack_engine|toolpack_engine]] ==

@@ Line 379: / Line 379: @@
 * pLegA->Join( pLegB );
 ** ==> CallFlow::OnLegJoinDone( pLegA, pLegB, [fd] )
-* pLegA->Join( pLegC, NULL, TBX_FALSE, &HdJoin);
+* pLegA->Join( pLegC, NULL, TBX_FALSE, &HdJoin );
 ** ==> CallFlow::OnLegJoinDone( pLegA, pLegC, [hd] )
-* pLegA->Join( pLegD, NULL, TBX_FALSE, &HdJoin);
+* pLegA->Join( pLegD, NULL, TBX_FALSE, &HdJoin );
 ** ==> CallFlow::OnLegJoinDone( pLegA, pLegD, [hd] )
-* pLegB->Join( pLegE, NULL, TBX_FALSE, &HdJoin);
+* pLegB->Join( pLegE, NULL, TBX_FALSE, &HdJoin );
 ** ==> CallFlow::OnLegJoinDone( pLegB, pLegE, [hd] )
 * pLegA->TerminateCall()
@@ Line 390: / Line 390: @@
 ** ==> CallFlow::OnLegUnjoinDone( pLegA, pLegD, [hd] )
 ** ==> CallFlow::OnCallLegTerminated( pLegA )
 == Re-synchronizing with [[Toolpack_Application:toolpack_engine|toolpack_engine]] ==

@@ Line 360: / Line 360: @@
 ** ==> CallFlow::OnLegUnjoinDone( pLegB, pLegA, [hd] )
-=== Scenario: Changing from hald-duplex to full-duplex ===
+=== Scenario: Changing from half-duplex to full-duplex ===
 ''LegA ---> LegB''   ===>  ''LegA <---> LegB''<br/><br/>
 A ''Join'' operation on two legs already joined together will override the join attributes.

@@ Line 363: / Line 363: @@
 ''LegA ---> LegB''   ===>  ''LegA <---> LegB''<br/><br/>
 A ''Join'' operation on two legs already joined together will override the join attributes.
 * pLegA->Join( pLegB, NULL, TBX_FALSE, &HdJoin);
 ** ==> CallFlow::OnLegJoinDone( pLegA, pLegB, [hd] )

@@ Line 343: / Line 343: @@
 When joined half-duplex, each source leg sends audio to destination leg, but not the opposite.
-* CTBCMC_JOIN_ATTRIBUTE   JoinAttribute;
+* CTBCMC_JOIN_ATTRIBUTE   HdJoin;
-* JoinAttribute.IsFullDuplex() = TBX_FALSE;
+* HdJoin.IsFullDuplex() = TBX_FALSE;
-* pLegA->Join( pLegB, NULL, TBX_FALSE, &JoinAttribute );
+* pLegA->Join( pLegB, NULL, TBX_FALSE, &HdJoin );
 ** ==> CallFlow::OnLegJoinDone( pLegA, pLegB, [hd] )
 * pLegA->Unjoin( pLegB );
@@ Line 353: / Line 353: @@
 ''LegA ---> LegB''   ===>  ''LegB ---> LegA''<br/><br/>
 Joining A--->B then B--->A is not creating a full-duplex connection, it's actually inverting the direction of the connection.
-* CTBCMC_JOIN_ATTRIBUTE   JoinAttribute;
+* pLegA->Join( pLegB, NULL, TBX_FALSE, &HdJoin );
-* JoinAttribute.IsFullDuplex() = TBX_FALSE;
-* pLegA->Join( pLegB, NULL, TBX_FALSE, &JoinAttribute );
 ** ==> CallFlow::OnLegJoinDone( pLegA, pLegB, [hd] )
-* pLegB->Join( pLegA, NULL, TBX_FALSE, &JoinAttribute );
+* pLegB->Join( pLegA, NULL, TBX_FALSE, &HdJoin );
 ** ==> CallFlow::OnLegJoinDone( pLegB, pLegA, [hd] )   // This confirms that join direction has been inverted
 * pLegB->Unjoin( pLegA );