00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020
00021
00022
00023
00024
00025
00026
00027
00028
00029
00030
00031
00032
00033
00034
00035
00036
00037
00038
00039
00040
00041
00042
00043
00044
00045
00046
00047
00048
00049
00050
00051
00052
00053
00054
00055
00056
00057
00058
00059
00060
00061
00062
00063
00064
00065
00066
00067
00068
00069
00070
00071
00072
00073
00074
00075
00076
00077
00078
00079
00080
00081
00082
00083
00084
00085
00086
00087
00088
00089
00090
00091
00092
00093
00094
00095
00096
00097
00098
00099
00100
00101
00102
00103
00104
00105
00106
00107
00108
00109 #ifndef IAX_CONNECTION_H
00110 #define IAX_CONNECTION_H
00111
00112 #ifndef _PTLIB_H
00113 #include <ptlib.h>
00114 #endif
00115
00116 #include <opal/connection.h>
00117
00118 #include <iax2/frame.h>
00119 #include <iax2/iax2jitter.h>
00120 #include <iax2/iedata.h>
00121 #include <iax2/processor.h>
00122 #include <iax2/callprocessor.h>
00123 #include <iax2/safestrings.h>
00124 #include <iax2/sound.h>
00125
00126 class IAX2EndPoint;
00127
00128
00130
00136 class IAX2Connection : public OpalConnection
00137 {
00138 PCLASSINFO(IAX2Connection, OpalConnection);
00139
00140 public:
00143
00146 IAX2Connection(
00147 OpalCall & call,
00148 IAX2EndPoint & endpoint,
00149 const PString & token,
00150 void *userData,
00151 const PString & remoteParty,
00152 const PString & remotePartyName = PString::Empty()
00153 );
00154
00158 ~IAX2Connection();
00160
00163
00167 void IncomingEthernetFrame (IAX2Frame *frame);
00168
00171
00172
00174 IAX2EndPoint & GetEndPoint() { return endpoint; }
00175
00178 void ReportStatistics();
00179
00194 void Release( CallEndReason reason = EndedByLocalUser
00195 );
00196
00198 void EndCallNow(
00199 CallEndReason reason = EndedByLocalUser
00200 );
00201
00202 OpalConnection::SendUserInputModes GetRealSendUserInputMode() const;
00203
00205 void SendDtmf(const PString & dtmf);
00206
00208 virtual PBoolean SendUserInputString(const PString & value );
00209
00211 virtual PBoolean SendUserInputTone(char tone, unsigned duration );
00212
00213
00216 void AcceptIncomingCall();
00217
00218
00225 virtual void AnsweringCall(AnswerCallResponse response);
00226
00227
00229 PBoolean IsCallTerminating() { return iax2Processor.IsCallTerminating(); }
00230
00241 PBoolean SetAlerting( const PString & calleeName,
00242 PBoolean withMedia
00243 );
00244
00250 PBoolean SetConnected();
00251
00262 OpalMediaFormatList GetMediaFormats() const { return remoteMediaFormats; }
00263
00264
00272 OpalMediaStream * CreateMediaStream(
00273 const OpalMediaFormat & mediaFormat,
00274 unsigned sessionID,
00275 PBoolean isSource
00276 );
00277
00288 void SetCallToken(PString newToken);
00289
00291 PString GetCallToken() { return iax2Processor.GetCallToken(); }
00292
00295 void TransmitFrameToRemoteEndpoint(IAX2Frame *src);
00296
00300 void PutSoundPacketToNetwork(PBYTEArray *sund);
00301
00304 void ReceivedSoundPacketFromNetwork(IAX2Frame *soundFrame);
00305
00310 PBoolean ReadSoundPacket(RTP_DataFrame & packet);
00311
00313 IAX2Remote & GetRemoteInfo() { return iax2Processor.GetRemoteInfo(); }
00314
00316 IAX2SequenceNumbers & GetSequenceInfo() { return iax2Processor.GetSequenceInfo(); }
00317
00319 const PTimeInterval & GetCallStartTick() { return iax2Processor.GetCallStartTick(); }
00320
00325 virtual void OnSetUp();
00326
00327
00328
00329 virtual PBoolean OnIncomingCall(
00330 unsigned int options,
00331 OpalConnection::StringOptions * stringOptions
00332 );
00333
00348 virtual void OnEstablished();
00349
00350
00351
00370 void OnReleased();
00371
00372
00373
00381 PBoolean SetUpConnection();
00382
00383
00387 PINDEX GetSupportedCodecs();
00388
00392 PINDEX GetPreferredCodec();
00393
00396 void BuildRemoteCapabilityTable(unsigned int remoteCapability, unsigned int format);
00397
00398
00406 unsigned int ChooseCodec();
00407
00409 virtual PBoolean IsConnectionOnHold();
00410
00412 virtual void RetrieveConnection();
00413
00415 virtual void HoldConnection();
00416
00418 void RemoteHoldConnection();
00419
00421 void RemoteRetrieveConnection();
00422
00429 void SetUserName(PString & inUserName) { userName = inUserName; };
00430
00432 PString GetUserName() const { return userName; };
00433
00440 void SetPassword(PString & inPassword) { password = inPassword; };
00441
00443 PString GetPassword() const { return password; };
00444
00448 virtual void TransferConnection(
00449 const PString & remoteParty,
00450 const PString & callIdentity = PString::Empty()
00451 );
00452
00462 virtual PBoolean ForwardCall(
00463 const PString & forwardParty
00464 );
00465
00466 protected:
00467
00469 PString userName;
00470
00472 PString password;
00473
00477
00479 IAX2EndPoint &endpoint;
00480
00483 OpalMediaFormatList remoteMediaFormats;
00484
00487 OpalMediaFormatList localMediaFormats;
00488
00490 IAX2CallProcessor & iax2Processor;
00491
00493 PBoolean local_hold;
00494
00496 PBoolean remote_hold;
00497
00499
00502 IAX2JitterBuffer jitterBuffer;
00503
00511 RTP_DataFrame::PayloadTypes opalPayloadType;
00512 };
00513
00514
00516
00517
00518
00519 #endif // IAX_CONNECTION_H
00520
00521
00522
00523
00524
00525
00526
00527
00528
00529
00530
00531
00532