CAF: Leg Creation Samples

Revision as of 13:53, 22 October 2009

Creating a Standalone Outgoing Call

   PTRCTBCMC_CALL_LEG_ATTRIBUTE ptrOutgoingLegAttribute;
   ptrOutgoingLegAttribute = tbnew CTBCMC_CALL_LEG_ATTRIBUTE();
 
   ptrOutgoingLegAttribute->GetCalledNumber()         = "123-4567";
   ptrOutgoingLegAttribute->GetCallingNumber()        = "987-6543";
   ptrOutgoingLegAttribute->GetNetworkAccessPoint()   = "NAP_SS7_MONTREAL";
 
   PTRCTBCAFCallLeg ptrOutgoingCallLeg = CreateOutgoingCallLeg(ptrOutgoingLegAttribute);

Bridging an Incoming Call (manual method)

   PTRCTBCMC_CALL_LEG_ATTRIBUTE ptrFirstLegAttribute;
   PTRCTBCMC_CALL_LEG_ATTRIBUTE ptrSecondLegAttribute;
   ptrFirstLegAttribute  = tbnew CTBCMC_CALL_LEG_ATTRIBUTE();
   ptrSecondLegAttribute = tbnew CTBCMC_CALL_LEG_ATTRIBUTE();
 
   ptrFirstLegAttribute->GetCalledNumber()         = "123-4567";
   ptrFirstLegAttribute->GetCallingNumber()        = "987-6543";
   ptrFirstLegAttribute->GetNetworkAccessPoint()   = "NAP_SS7_MONTREAL";
 
   PCTBCMCLeg pFirstCallLeg = tbnew CTBCMCLeg( ++mun32LegId, ptrFirstLegAttribute, this, 0, &mLegMutex );
   pFirstCallLeg->CreateCall();
 
   ptrSecondLegAttribute->GetCalledNumber()         = "123-4567";
   ptrSecondLegAttribute->GetCallingNumber()        = "987-6543";
   ptrSecondLegAttribute->GetNetworkAccessPoint()   = "NAP_SS7_MONTREAL";
 
   PCTBCMCLeg pSecondCallLeg = tbnew CTBCMCLeg( ++mun32LegId, ptrSecondLegAttribute, this, 0, &mLegMutex );
   pSecondCallLeg->CreateCall();
 
   pFirstCallLeg->Join(pSecondCallLeg);

Bridging an Incoming Call (using CTBCAFBridge )

 PTRCTBCMC_CALL_LEG_ATTRIBUTE ptrIncomingCallLegAttribute;
 PTRCTBCMC_CALL_LEG_ATTRIBUTE ptrOutgoingCallLegAttribute;
 PITBCAFCallFlow	      pCallFlow;
 
 ptrOutgoingCallLegAttribute = tbnew CTBCMC_CALL_LEG_ATTRIBUTE();
 ptrIncomingCallLegAttribute = tbnew CTBCMC_CALL_LEG_ATTRIBUTE(*pCallLegAttribute);
 
 ptrOutgoingLegAttribute->GetCalledNumber()         = ptrIncomingCallLegAttribute->GetCallingNumber();
 ptrOutgoingLegAttribute->GetCallingNumber()        = ptrIncomingCallLegAttribute->GetCalledNumber();
 ptrOutgoingLegAttribute->GetNetworkAccessPoint()   = ptrIncomingCallLegAttribute->GetNetworkAccessPoint();
 
 pCallFlow = tbnew CTBCAFBridge( mun32AccountId, this );
 TBCAF_EXIT_ON_NULL( pCallFlow, TBX_RESULT_FAIL, "Failed to allocate call." );
 			
 Result = pCallFlow->AddIncoming( mun32LegId, ptrIncomingCallLegAttribute );
 TBCAF_EXIT_ON_ERROR(Result, "AddIncoming Failed." );
 
 Result = pCallFlow->AddOutgoing( ptrOutgoingCallLegAttribute );
 TBCAF_EXIT_ON_ERROR(Result, "AddOutgoing Failed." );
   
 // Start the call
 Result = pCallFlow->InitCall( &pCallFlow );

Creating a Media-only Leg

If you are using a nap of type NAP_MEDIA_TDM:

   PTRCTBCMC_MEDIA_ONLY_LEG_ATTRIBUTE ptrLegAttribute;
   PTBCMC_MEDIA_DESCRIPTION           pMediaDesc;
 
   ptrLegAttribute = tbnew CTBCMC_MEDIA_ONLY_LEG_ATTRIBUTE();
   pMediaDesc	    = &ptrLegAttribute->GetProfile()->MediaDescription; 

   ptrLegAttribute->GetNetworkAccessPoint()      = "NAP_SS7_MONTREAL";
   pMediaDesc->Type                              = TBCMC_MEDIA_TYPE_AUDIO;
   pMediaDesc->Transport                         = TBCMC_MEDIA_TRANSPORT_TDM;
   pMediaDesc->Settings.TdmAudio.Type            = TBCMC_MEDIA_SETTINGS_TYPE_TDM_AUDIO;
   pMediaDesc->Settings.TdmAudio.un8Timeslot     = 5;
   Strncpy
   (
       pMediaDesc->Settings.TdmAudio.szTrunkName, 
       "TRUNK_TORONTO_1", 
       sizeof(pMediaDesc->Settings.TdmAudio.szTrunkName)
   );
 
   PCTBCMCLeg pCallLeg = tbnew CTBCMCLeg( ++mun32LegId, ptrLegAttribute, this, 0, &mLegMutex );
   pCallLeg->CreateCall();

If you are using a nap of type NAP_MEDIA_VOIP:

   TBX_RESULT                         Result;
   TBX_SDP_INFO                       SdpInfo;
   PTRCTBCMC_MEDIA_ONLY_LEG_ATTRIBUTE ptrLegAttribute;
   PTBCMC_MEDIA_DESCRIPTION           pMediaDesc;
 
   ptrLegAttribute = tbnew CTBCMC_MEDIA_ONLY_LEG_ATTRIBUTE();
   pMediaDesc	    = &ptrLegAttribute->GetProfile()->MediaDescription;
 
   ptrLegAttribute->GetNetworkAccessPoint()      = "NAP_SS7_MONTREAL";
   pMediaDesc->Type                              = TBCMC_MEDIA_TYPE_AUDIO;
   pMediaDesc->Transport                         = TBCMC_MEDIA_TRANSPORT_IP;
   pMediaDesc->Settings.PacketAudio.Type         = TBCMC_MEDIA_SETTINGS_TYPE_PACKET_AUDIO;
  
   // Set Local SDP
   Result = BuildSdpInfo("", 0, SdpInfo);                 // No IP specified, Toolpack will choose one
   TBCAF_EXIT_ON_ERROR( Result, "BuildSdpInfo failed." );
   ptrLegAttribute->SetLocalSDP(&SdpInfo);
   
   // Set Peer SDP
   Result = BuildSdpInfo("10.0.0.15", 5000, SdpInfo);     // Using peer IP address and port
   TBCAF_EXIT_ON_ERROR( Result, "BuildSdpInfo failed." );
   ptrLegAttribute->SetPeerSDP(&SdpInfo);
 
   PCTBCMCLeg pCallLeg = tbnew CTBCMCLeg( ++mun32LegId, ptrLegAttribute, this, 0, &mLegMutex );
   pCallLeg->CreateCall();

To see how to fill a TBX_SDP_INFO structure (implementation of BuildSdpInfo()), refer to Filling an SDP Structure.