CAF: Leg Creation Samples
From TBwiki
(Difference between revisions)
(→If you are using a nap of type NAP_MEDIA_VOIP:) |
Cboulanger (Talk | contribs) |
||
| Line 1: | Line 1: | ||
| − | == Creating a Standalone Outgoing Call == | + | == Creating a Standalone Outgoing Call Leg == |
PTRCTBCMC_CALL_LEG_ATTRIBUTE ptrOutgoingLegAttribute; | PTRCTBCMC_CALL_LEG_ATTRIBUTE ptrOutgoingLegAttribute; | ||
ptrOutgoingLegAttribute = tbnew CTBCMC_CALL_LEG_ATTRIBUTE(); | ptrOutgoingLegAttribute = tbnew CTBCMC_CALL_LEG_ATTRIBUTE(); | ||
| Line 10: | Line 10: | ||
pCallLeg->CreateCall(); | pCallLeg->CreateCall(); | ||
| − | == Bridging an Incoming Call (manual method)== | + | == Bridging an Incoming Call Leg (manual method)== |
TBX_VOID CTBCAFMediaGateway::OnCallLegPresent | TBX_VOID CTBCAFMediaGateway::OnCallLegPresent | ||
( | ( | ||
| Line 68: | Line 68: | ||
Incoming and outgoing call leg will be joined when we receive the notification OnCallLegAnswered() indicating that the outgoing call has been answered by the remote peer. | Incoming and outgoing call leg will be joined when we receive the notification OnCallLegAnswered() indicating that the outgoing call has been answered by the remote peer. | ||
| − | == Bridging an Incoming Call (using CTBCAFBridge )== | + | == Bridging an Incoming Call Leg (using CTBCAFBridge )== |
TBX_VOID CTBCAFMediaGateway::OnCallLegPresent | TBX_VOID CTBCAFMediaGateway::OnCallLegPresent | ||
Revision as of 09:23, 23 October 2009
Contents |
Creating a Standalone Outgoing Call Leg
PTRCTBCMC_CALL_LEG_ATTRIBUTE ptrOutgoingLegAttribute; ptrOutgoingLegAttribute = tbnew CTBCMC_CALL_LEG_ATTRIBUTE(); ptrOutgoingLegAttribute->GetCalledNumber() = "123-4567"; ptrOutgoingLegAttribute->GetCallingNumber() = "987-6543"; ptrOutgoingLegAttribute->GetNetworkAccessPoint() = "NAP_SS7_MONTREAL"; PCTBCMCLeg pCallLeg = tbnew CTBCMCLeg( ++mun32LegId, ptrOutgoingLegAttribute, this, 0, &mLegMutex ); pCallLeg->CreateCall();
Bridging an Incoming Call Leg (manual method)
TBX_VOID CTBCAFMediaGateway::OnCallLegPresent
(
IN TBCMC_LEG_ID in_LegId,
IN CTBCMC_CALL_LEG_ATTRIBUTE_COMMON & in_CallLegAttribute,
IN CTBCMC_PROTOCOL_ATTRIBUTE & in_ProtocolAttribute
)
{
TBCAF_MUTEX_GET_SCOPE_BEGIN( &mMutex )
PCTBCMC_CALL_LEG_ATTRIBUTE pCallLegAttribute;
PTRCTBCMC_CALL_LEG_ATTRIBUTE ptrIncomingCallLegAttribute;
PTRCTBCMC_CALL_LEG_ATTRIBUTE ptrOutgoingCallLegAttribute;
/*---------------------------------------------------------------------------------------------------------------------------
| Code section
*--------------------------------------------------------------------------------------------------------------------------*/
CAFCODE( CTBCAFMediaGateway::OnCallLegPresent )
{
pCallLegAttribute = in_CallLegAttribute.GetCallLegAttribute();
ptrIncomingCallLegAttribute = tbnew CTBCMC_CALL_LEG_ATTRIBUTE(*pCallLegAttribute);
ptrOutgoingCallLegAttribute = tbnew CTBCMC_CALL_LEG_ATTRIBUTE();
ptrOutgoingCallLegAttribute->GetCalledNumber() = ptrIncomingCallLegAttribute->GetCallingNumber();
ptrOutgoingCallLegAttribute->GetCallingNumber() = ptrIncomingCallLegAttribute->GetCalledNumber();
ptrOutgoingCallLegAttribute->GetNetworkAccessPoint() = ptrIncomingCallLegAttribute->GetNetworkAccessPoint();
PCTBCMCLeg pIncomingCallLeg = tbnew CTBCMCLeg( ++mun32LegId, ptrIncomingCallLegAttribute, this, 0, &mLegMutex );
pIncomingCallLeg->CreateCall();
PCTBCMCLeg pOutgoingCallLeg = tbnew CTBCMCLeg( ++mun32LegId, ptrOutgoingCallLegAttribute, this, 0, &mLegMutex );
pOutgoingCallLeg->CreateCall();
TBX_EXIT_SUCCESS( TBX_RESULT_OK );
}
/*---------------------------------------------------------------------------------------------------------------------------
| Exception handling section
*--------------------------------------------------------------------------------------------------------------------------*/
CAF_EXCEPTION_HANDLING
/*---------------------------------------------------------------------------------------------------------------------------
| Error handling section
*--------------------------------------------------------------------------------------------------------------------------*/
CAF_ERROR_HANDLING( CAF_VERBOSE )
{
}
/*---------------------------------------------------------------------------------------------------------------------------
| Cleanup section
*--------------------------------------------------------------------------------------------------------------------------*/
CAF_CLEANUP
{
}
RETURN_VOID;
TBCAF_MUTEX_GET_SCOPE_END( &mMutex )
}
Incoming and outgoing call leg will be joined when we receive the notification OnCallLegAnswered() indicating that the outgoing call has been answered by the remote peer.
Bridging an Incoming Call Leg (using CTBCAFBridge )
TBX_VOID CTBCAFMediaGateway::OnCallLegPresent
(
IN TBCMC_LEG_ID in_LegId,
IN CTBCMC_CALL_LEG_ATTRIBUTE_COMMON & in_CallLegAttribute,
IN CTBCMC_PROTOCOL_ATTRIBUTE & in_ProtocolAttribute
)
{
TBCAF_MUTEX_GET_SCOPE_BEGIN( &mMutex )
PCTBCMC_CALL_LEG_ATTRIBUTE pCallLegAttribute;
PTRCTBCMC_CALL_LEG_ATTRIBUTE ptrIncomingCallLegAttribute;
PTRCTBCMC_CALL_LEG_ATTRIBUTE ptrOutgoingCallLegAttribute;
PITBCAFCallFlow pCallFlow;
TBX_RESULT Result;
/*---------------------------------------------------------------------------------------------------------------------------
| Code section
*--------------------------------------------------------------------------------------------------------------------------*/
CAFCODE( CTBCAFMediaGateway::OnCallLegPresent )
{
pCallLegAttribute = in_CallLegAttribute.GetCallLegAttribute();
ptrIncomingCallLegAttribute = tbnew CTBCMC_CALL_LEG_ATTRIBUTE(*pCallLegAttribute);
ptrOutgoingCallLegAttribute = tbnew CTBCMC_CALL_LEG_ATTRIBUTE();
ptrOutgoingCallLegAttribute->GetCalledNumber() = ptrIncomingCallLegAttribute->GetCallingNumber();
ptrOutgoingCallLegAttribute->GetCallingNumber() = ptrIncomingCallLegAttribute->GetCalledNumber();
ptrOutgoingCallLegAttribute->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 );
TBX_EXIT_SUCCESS( TBX_RESULT_OK );
}
/*---------------------------------------------------------------------------------------------------------------------------
| Exception handling section
*--------------------------------------------------------------------------------------------------------------------------*/
CAF_EXCEPTION_HANDLING
/*---------------------------------------------------------------------------------------------------------------------------
| Error handling section
*--------------------------------------------------------------------------------------------------------------------------*/
CAF_ERROR_HANDLING( CAF_VERBOSE )
{
}
/*---------------------------------------------------------------------------------------------------------------------------
| Cleanup section
*--------------------------------------------------------------------------------------------------------------------------*/
CAF_CLEANUP
{
}
RETURN_VOID;
TBCAF_MUTEX_GET_SCOPE_END( &mMutex )
}
InitCall() will create each leg added from AddIncoming() and AddOutgoing() and incoming and outgoing call leg will be joined when we receive the notification OnCallLegAnswered() indicating that the outgoing call has been answered by the remote peer.
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_MEDIA_TDM";
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_MEDIA_VOIP";
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();
Note that you have two possibilities to build a TBX_SDP_INFO structure. The first one is like in the example (BuildSdpInfo()) where you can build manually your TBX_SDP_INFO structure and the second one is when you have an sdp info in text format. There is a function that will parse the text and build a TBX_SDP_INFO structure from it.
TBX_RESULT TBXMediaLibSdpParse2
(
IN PTBX_CHAR in_pszSdp,
OUT PTBX_SDP_INFO out_pSdpInfo,
IN TBX_MEDIA_SDP_PARSE_OPTIONS in_Options,
OUT PTBX_CHAR out_pszErrMsg,
IN TBX_UINT32 in_un32MaxErrMsgLen
);
To see how to build a TBX_SDP_INFO structure (implementation of BuildSdpInfo()), refer to Filling an SDP Structure.
