ユーザーズマニュアル目次Contents3Figures11Tables13Revision History15About This Publication251. IP Overview291.1 Introduction to VoIP291.2 H.323 Overview291.2.1 H.323 Entities301.2.2 H.323 Protocol Stack311.2.3 Codecs321.2.4 Basic H.323 Call Scenario321.2.5 Registration with a Gatekeeper351.2.6 H.323 Call Scenario via a Gateway361.3 SIP Overview391.3.1 Advantages of Using SIP391.3.2 SIP User Agents and Servers391.3.3 Basic SIP Operation401.3.4 Basic SIP Call Scenario401.3.5 SIP Messages402. Dialogic® Global Call API Architecture for IP432.1 Dialogic® Global Call API over IP Architecture with a Host-Based Stack432.2 Architecture Components442.2.1 Host Application452.2.2 Dialogic® Global Call API452.2.3 IP Signaling Call Control Library (IPT CCLib)452.2.4 IP Media Call Control Library (IPM CCLib)462.2.5 IP Media Resource462.3 Device Types and Usage462.3.1 Device Types Used with IP462.3.2 IPT Board Devices472.3.3 IPT Network Devices482.3.4 IPT Start Parameters494. IP-Specific Operations514.1 Call Control Library Initialization524.1.1 Setting a SIP Outbound Proxy534.1.2 Configuring SIP Transport Protocol544.1.3 Enabling and Disabling H.245 Tunneling (H.323)584.2 Fast and Slow Call Setup Modes594.2.1 Setting the Call Setup Mode594.2.2 H.323 Fast Start and Slow Start604.2.3 H.323 Fast Start with Optional H.245 Channel614.2.4 SIP Call Setup Modes624.2.5 Retrieving Coder Information from Call Offers634.3 Setting Call-Related Information654.3.1 Overview of Setting Call-Related Information664.3.2 Setting Coder Information694.3.3 Specifying Nonstandard Data Information (H.323)724.3.4 Specifying Nonstandard Control Information (H.323)744.4 Connection Phase Messages754.4.1 Setting and Retrieving Disconnect Cause or Reason Values764.4.2 Setting Busy Reason Codes764.4.3 SIP Provisional (1xx) Responses784.4.4 SIP Redirection (3xx) Response Messages804.4.5 SIP Rejection Responses844.4.6 Configuring Proceeding Message Generation (H.323)854.5 Retrieving Current Call-Related Information854.5.1 Retrieving Nonstandard Data From Protocol Messages (H.323)894.5.2 Examples of Retrieving Call-Related Information894.6 Receiving Notification Events984.6.1 Enabling and Disabling Unsolicited Notification Events984.6.2 Getting Media Streaming Status and Connection Information994.6.3 Getting Notification of Underlying Protocol State Changes1014.7 Modifying an Existing SIP Call via re-INVITE1014.7.1 Overview of the SIP re-INVITE Method1024.7.2 Enabling Application Access to re-INVITE Requests1034.7.3 Receiving SIP re-INVITE Requests1034.7.4 Responding to SIP re-INVITE Requests1064.7.5 Sending a SIP re-INVITE Request1074.7.6 Canceling a Pending re-INVITE Request1094.7.7 Updating Dialog Properties via re-INVITE1104.7.8 Implementing Hold and Retrieve via SIP re-INVITE1114.8 Setting and Retrieving Q.931 Message IEs1134.8.1 Enabling Access to Q.931 Message IEs1134.8.2 Supported Q.931 Message IEs1144.8.3 Setting Q.931 Message IEs1144.8.4 Retrieving Q.931 Message IEs1144.8.5 Common Usage Scenarios Involving Q.931 Message IEs1154.9 Setting and Retrieving SIP Message Header Fields1164.9.1 SIP Header Access Overview1164.9.2 Enabling Access to SIP Header Information1234.9.3 Enabling Long Header Values1234.9.4 Registering SIP Header Fields to be Retrieved1244.9.5 Setting SIP Header Fields for Outbound Messages1274.9.6 Retrieving SIP Message Header Fields1294.10 Using MIME Bodies in SIP Messages (SIP-T)1324.10.1 SIP MIME Overview1324.10.2 Enabling and Configuring the SIP MIME Feature1354.10.3 Getting MIME Information1354.10.4 Sending MIME Information1414.10.5 MIME Error Conditions1444.11 Specifying Transport for SIP Messages1454.12 Handling SIP Transport Failures1464.13 Sending and Receiving SIP INFO Messages1494.13.1 Sending an INFO Message1494.13.2 Receiving a Response to an INFO Message1504.13.3 Receiving an INFO Message1524.13.4 Responding to an INFO Message1534.14 Sending and Receiving SIP OPTIONS Messages1544.14.1 Default OPTIONS Behavior1544.14.2 Enabling Application Access to OPTIONS Messages1554.14.3 Sending OPTIONS Requests1564.14.4 Receiving Responses to OPTIONS Requests1594.14.5 Receiving OPTIONS Requests1614.14.6 Responding to OPTIONS Requests1624.15 Using SIP SUBSCRIBE and NOTIFY Messages1664.15.1 Sending SUBSCRIBE Requests1674.15.2 Receiving Responses to SUBSCRIBE Requests1694.15.3 Receiving SUBSCRIBE Requests1724.15.4 Responding to SUBSCRIBE Requests1734.15.5 Sending NOTIFY Requests1754.15.6 Receiving Responses to NOTIFY Requests1784.15.7 Receiving NOTIFY Requests1794.15.8 Responding to NOTIFY Requests1794.16 Handling DTMF1814.16.1 Specifying DTMF Support1824.16.2 Getting Notification of DTMF Detection1844.16.3 Generating DTMF1854.16.4 Generating or Detecting DTMF Tones Using a Voice Resource1854.17 Sending Nonstandard Protocol Messages (H.323)1864.17.1 Nonstandard UII Message (H.245)1874.17.2 Nonstandard Facility Message (Q.931)1884.17.3 Nonstandard Registration Message1894.17.4 Sending Facility, UII, or Registration Message Scenario1904.18 Using H.323 Annex M Tunneled Signaling Messages1914.18.1 Tunneled Signaling Message Overview1914.18.2 Enabling Tunneled Signaling Messages1934.18.3 Composing Tunneled Signaling Messages1944.18.4 Sending Tunneled Signaling Messages1964.18.5 Receiving Tunneled Signaling Messages1984.19 Retrieving User-to-User Information Elements from H.323 Messages2024.19.1 Enabling Reception of User-to-User Information2034.19.2 Retrieving UU-IEs2044.20 Specifying RTP Stream Establishment2064.21 Managing Quality of Service Alarms2074.21.1 Alarm Source Object Name2084.21.2 Retrieving the Media Device Handle2084.21.3 Setting QoS Threshold Values2084.21.4 Retrieving QoS Threshold Values2094.21.5 Handling QoS Alarms2104.22 Registration2124.22.1 Registration Overview2124.22.2 Registration Operations2154.22.3 Sending and Receiving Nonstandard Registration Messages (H.323)2224.22.4 Registration Code Examples2234.22.5 Gatekeeper Registration Failure (H.323)2284.23 SIP Digest Authentication2294.24 Using SIP Transport Layer Security (TLS)2324.24.1 Overview of TLS2334.24.2 Configuring and Enabling TLS2404.24.3 Making Calls Using TLS2474.24.4 TLS Transport Failures2544.25 Call Transfer2544.25.1 Enabling Call Transfer2554.25.2 Dialogic® Global Call API Line Devices for Call Transfer2554.25.3 Incoming Transferred Call2564.25.4 Call Transfer Glare Condition2574.25.5 Call Transfer When Using SIP2594.26 T.38 Fax Server2644.26.1 T.38 Fax Server Support Overview2644.26.2 Specifying Manual Operating Mode2664.26.3 Initiating a Switch from Audio to T.38 Fax2664.26.4 Associating a T.38 Fax Device with a Media Device When a Fax Request is Received2674.26.5 Accepting/Rejecting a Request to Switch Between Audio and T.38 Fax2694.26.6 Sending a T.38 Fax in a Session Without Audio Established2694.26.7 Receiving a T.38 Fax in a Session Without Audio Established2704.26.8 Sending a Request to Switch from T.38 Fax to Audio2724.26.9 Receiving a Request to Switch from T.38 Fax to Audio2734.26.10 Terminating a Call After a T.38 Fax Session2744.27 Sending and Receiving V.17 Faxes2744.27.1 Sending G.711 Fax in an Established Audio Session2744.27.2 Receiving G.711 Fax in an Established Audio Session2754.28 Using Object Identifiers2764.29 LAN Disconnection Alarms2774.30 Setting Dialogic® IP Media Library Parameters2793. IP Call Scenarios2813.1 Basic Call Control Scenarios When Using IP Technology2813.1.1 Basic Call Setup When Using H.323 or SIP2823.1.2 Basic Call Teardown When Using H.323 or SIP2833.1.3 Call Setup Scenarios for Early Media2833.2 Call Transfer Scenarios When Using H.3232873.2.1 General Conditions for H.450.2 Call Transfers2873.2.2 Endpoint Behavior in H.450.2 Blind Call Transfers2873.2.3 Successful H.450.2 Blind Call Transfer Scenario2893.2.4 Unsuccessful H.450.2 Blind Call Transfer Scenarios2913.2.5 Endpoint Behavior in H.450.2 Supervised Call Transfer2963.2.6 Successful H.450.2 Supervised Call Transfer Scenario2973.2.7 Unsuccessful H.450.2 Supervised Transfer Scenarios2993.3 Call Transfer Scenarios When Using SIP3043.3.1 General Conditions for SIP Call Transfers3043.3.2 Endpoint Behavior in Unattended SIP Call Transfers3053.3.3 Successful Unattended SIP Call Transfer Scenarios3083.3.4 Endpoint Behavior in Attended SIP Transfers3143.3.5 Successful SIP Attended Call Transfer Scenarios3163.3.6 Unsuccessful Call Transfer Scenarios3203.4 T.38 Fax Server Call Scenarios3273.4.1 Sending T.38 Fax in an Established Audio Session3283.4.2 Receiving T.38 Fax in an Established Audio Session3293.4.3 Sending T.38 Fax Without an Established Audio Session3313.4.4 Receiving T.38 Fax Without an Established Audio Session3323.4.5 Sending a Request to Switch From T.38 Fax to Audio3333.4.6 Receiving a Request to Switch From T.38 Fax to Audio3343.4.7 Terminating a Call After a T.38 Fax Session3353.4.8 Recovering from a Session Switching Failure3355. Third Party Call Control (3PCC) Operations and Multimedia Support3375.1 Overview3375.1.1 Third Party Call Control3375.1.2 Global Call Library and IP Media Library for Third Party Call Control3415.1.3 Session Description Protocol3425.2 Global Call in Third Party Call Control Mode3435.2.1 Initializing the Library in Third Party Call Control Mode3435.2.2 Interface Changes3445.2.3 Device Types and Usage3525.2.4 Using Fast Start and Slow Start Setup in Third Party Call Control Mode3525.2.5 Call Transfer Scenarios3525.2.6 DTMF Transport3535.2.7 T.38 Fax and Tone Detection3535.3 Session Description Protocol Parser/Generator Example3535.4 Message Sequence Diagrams3535.4.1 First Party Call Establishment in Third Party Call Control Mode3545.4.2 Basic Third Party Call Control Establishment3555.4.3 Alternate Third Party Call Control Establishment3585.4.4 Modifying the Coder3625.4.5 Cancelling a re-INVITE Request3665.4.6 Receiving an Invalid Answer SDP3675.4.7 OPTIONS Request on an Active Dialog3685.5 Processing Intraframe Requests for Video Streams3715.5.1 Overview3715.5.2 Requesting an I-Frame in SIP3725.5.3 Global Call Example Code3726. Building Dialogic® Global Call API IP Applications3756.1 Header Files3756.2 Required Libraries3756.3 Required System Software3767. Debugging Dialogic® Global Call API IP Applications3777.1 Debugging Overview3777.2 Configuring the Logging Facility3787.2.1 Configuration File Overview3787.2.2 Configuring the gc_h3r Logging Module3797.2.3 Configuring SIP Stack Logging3827.2.4 Configuring H.323 Stack Logging3838. IP-Specific Function Information3878.1 Dialogic® Global Call API Functions Supported by IP3878.2 IP-Specific Dialogic® Global Call API Functions394gc_AcceptModifyCall( )396gc_RejectModifyCall( )406gc_ReqModifyCall( )414gc_SetAuthenticationInfo( )421gc_SipAck( )424gc_util_copy_parm_blk( )428gc_util_find_parm_ex( )430gc_util_insert_parm_ref_ex( )433gc_util_next_parm_ex( )436INIT_GC_PARM_DATA_EXT( )439INIT_IP_VIRTBOARD( )441INIT_IPCCLIB_START_DATA( )4438.3 Dialogic® Global Call API Function Variances for IP4448.3.1 gc_AcceptCall( ) Variances for IP4448.3.2 gc_AcceptInitXfer( ) Variances for IP4458.3.3 gc_AcceptXfer( ) Variances for IP4468.3.4 gc_AnswerCall( ) Variances for IP4478.3.5 gc_CallAck( ) Variances for IP4488.3.6 gc_Close( ) Variances for IP4488.3.7 gc_DropCall( ) Variances for IP4488.3.8 gc_Extension( ) Variances for IP4498.3.9 gc_GetAlarmParm( ) Variances for IP4518.3.10 gc_GetCallInfo( ) Variances for IP4528.3.11 gc_GetCTInfo( ) Variances for IP4558.3.12 gc_GetResourceH( ) Variances for IP4558.3.13 gc_GetXmitSlot( ) Variances for IP4558.3.14 gc_InitXfer( ) Variances for IP4558.3.15 gc_InvokeXfer( ) Variances for IP4568.3.16 gc_Listen( ) Variances for IP4608.3.17 gc_MakeCall( ) Variances for IP4608.3.18 gc_OpenEx( ) Variances for IP4768.3.19 gc_RejectInitXfer( ) Variances for IP4778.3.20 gc_RejectXfer( ) Variances for IP4788.3.21 gc_ReleaseCallEx( ) Variances for IP4788.3.22 gc_ReqService( ) Variances for IP4798.3.23 gc_RespService( ) Variances for IP4828.3.24 gc_SetAlarmParm( ) Variances for IP4838.3.25 gc_SetConfigData( ) Variances for IP4848.3.26 gc_SetUserInfo( ) Variances for IP4878.3.27 gc_Start( ) Variances for IP4918.3.28 gc_Stop( ) Variances for IP4948.3.29 gc_UnListen( ) Variances for IP4958.4 Dialogic® Global Call API States Supported by IP4958.5 Dialogic® Global Call API Events Supported by IP4959. IP-Specific Parameters4999.1 Overview of Parameter Usage4999.2 Parameter Set Reference5109.2.1 GCSET_CALL_CONFIG5119.2.2 IPSET_CALLINFO5129.2.3 IPSET_CONFERENCE5149.2.4 IPSET_CONFIG5159.2.5 IPSET_DTMF5179.2.6 IPSET_EXTENSIONEVT_MSK5189.2.7 IPSET_FOIP5189.2.8 IPSET_H323_RESPONSE_CODE5199.2.9 IPSET_IPPROTOCOL_STATE5199.2.10 IPSET_LOCAL_ALIAS5209.2.11 IPSET_MEDIA_STATE5219.2.12 IPSET_MIME and IPSET_MIME_200OK_TO_BYE5229.2.13 IPSET_MSG_H2455239.2.14 IPSET_MSG_Q9315239.2.15 IPSET_MSG_REGISTRATION5239.2.16 IPSET_MSG_SIP5249.2.17 IPSET_NONSTANDARDCONTROL5259.2.18 IPSET_NONSTANDARDDATA5269.2.19 IPSET_PROTOCOL5269.2.20 IPSET_REG_INFO5279.2.21 IPSET_RTP_ADDRESS5289.2.22 IPSET_SDP5289.2.23 IPSET_SIP_MSGINFO5299.2.24 IPSET_SIP_REQUEST_ERROR5319.2.25 IPSET_SIP_RESPONSE_CODE5329.2.26 IPSET_SUPPORTED_PREFIXES5339.2.27 IPSET_SWITCH_CODEC5339.2.28 IPSET_TRANSACTION5349.2.29 IPSET_TUNNELEDSIGNALMSG5359.2.30 IPSET_VENDORINFO53610. IP-Specific Data Structures537GC_PARM_DATA_EXT538IP_ADDR540IP_AUDIO_CAPABILITY541IP_AUTHENTICATION542IP_CAPABILITY543IP_CAPABILITY_UNION545IP_CONNECT546IP_DTMF_DIGITS547IP_DATA_CAPABILITY548IP_H221NONSTANDARD549IP_REGISTER_ADDRESS550IP_TUNNELPROTOCOL_ALTID551IP_TUNNELPROTOCOL_OBJECTID552IP_VIRTBOARD553IPCCLIB_START_DATA558REQUEST_ERROR560RTP_ADDR561SIP_TLS_ENGINE56211. IP-Specific Event Cause Codes56511.1 IP-Specific Error Codes56511.2 Error Codes When Using H.32356911.3 Internal Disconnect Reasons57411.4 Event Cause Codes and Failure Reasons When Using H.32357611.5 Failure Response Codes When Using SIP58412. Supplementary Reference Information59112.1 References to More Information59112.2 SIP Transaction Timer Values59212.3 DNS Configuration for SIP59312.4 Called and Calling Party Address List Format When Using H.323594Glossary597Index599サイズ： 4.19MBページ数： 604Language: Englishマニュアルを開く
