← Volver al índice de módulos

sca

The sca module implements Shared Call Appearances. It handles SUBSCRIBE messages for call-info and line-seize events, and sends call-info NOTIFYs to line subscribers to implement line bridging.
🛠️ Utilidades y Varios Kamailio 6.1 24 parámetros 4 funciones

Descripción general

The sca module implements Shared Call Appearances. It handles SUBSCRIBE messages for call-info and line-seize events, and sends call-info NOTIFYs to line subscribers to implement line bridging. The module implements SCA as defined in Broadworks SIP Access Side Extensions Interface Specifications, Release 13.0, version 1, sections 2, 3 and 4. SCA group members receive call state notifications when other group members participate in calls. An SCA caller can place a call on hold, and the call may be retrieved from hold by another member of the group. Subscribers to SCA call-info events SUBSCRIBE to their address-of-record (AoR), asking the application server to send call-info NOTIFYs with line state information as lines in the subscriber group are used. For example, when an SCA subscriber takes the phone off hook, it sends a line-seize SUBSCRIBE to the application server. The application server acknowledges the request, and sends to the subscriber a line-seize NOTIFY with the appearance index of the line claimed for the subscriber. The application also sends call-info NOTIFYs to the other SCA subscribers to the AoR, letting them know that an appearance within the group has gone off hook. Subscribers update their display appropriately. Subscribers to an SCA address-of-record will receive call-info NOTIFYs when a member of the group seizes a line (seized); receives a 180 ringing response from the remote party (ringing); receives a 183 progressing response from the remote party (pr

Documentación oficial: https://www.kamailio.org/docs/modules/stable/modules/sca.html
Código fuente: https://github.com/kamailio/kamailio/tree/master/src/modules/sca

Parámetros de configuración

ParámetroTipoDescripción
hash_table_size integer 3.2. call_info_max_expires (integer) 3.3. line_seize_max_expires (integer) 3.4. purge_expired_interval (integer) 3.5. db_url (str) 3.6. subs_table (str) 3.7. db_update_interval (integer) 3.8. onhold_b
call_info_max_expires integer 3.3. line_seize_max_expires (integer) 3.4. purge_expired_interval (integer) 3.5. db_url (str) 3.6. subs_table (str) 3.7. db_update_interval (integer) 3.8. onhold_bflag (integer) 3.9. server_address (s
line_seize_max_expires integer 3.4. purge_expired_interval (integer) 3.5. db_url (str) 3.6. subs_table (str) 3.7. db_update_interval (integer) 3.8. onhold_bflag (integer) 3.9. server_address (string) 3.10. contact_fallback (string)
purge_expired_interval integer 3.5. db_url (str) 3.6. subs_table (str) 3.7. db_update_interval (integer) 3.8. onhold_bflag (integer) 3.9. server_address (string) 3.10. contact_fallback (string) 3.11. from_uri_avp (string) 3.12. to_
db_url str 3.6. subs_table (str) 3.7. db_update_interval (integer) 3.8. onhold_bflag (integer) 3.9. server_address (string) 3.10. contact_fallback (string) 3.11. from_uri_avp (string) 3.12. to_uri_avp (string)
subs_table str 3.7. db_update_interval (integer) 3.8. onhold_bflag (integer) 3.9. server_address (string) 3.10. contact_fallback (string) 3.11. from_uri_avp (string) 3.12. to_uri_avp (string)
db_update_interval integer 3.8. onhold_bflag (integer) 3.9. server_address (string) 3.10. contact_fallback (string) 3.11. from_uri_avp (string) 3.12. to_uri_avp (string)
onhold_bflag integer 3.9. server_address (string) 3.10. contact_fallback (string) 3.11. from_uri_avp (string) 3.12. to_uri_avp (string)
server_address string 3.10. contact_fallback (string) 3.11. from_uri_avp (string) 3.12. to_uri_avp (string)
contact_fallback string 3.11. from_uri_avp (string) 3.12. to_uri_avp (string)
from_uri_avp string 3.12. to_uri_avp (string)
to_uri_avp string 3.1. hash_table_size (integer)
hash_table_size integer Size, as a power of two, of the shared memory hash table containing the call-info subscriptions and the appearance state. A larger power of two means better performance (fewer collisions, making for f
call_info_max_expires integer The maximum allowed call-info subscription time in seconds.
line_seize_max_expires integer The maximum allowed line-seize subscription time in seconds.
purge_expired_interval integer The period of time in seconds between purges of expired call-info and line-seize subscriptions.
db_url str URL of database to which subscribers will be written.
subs_table str Name of the database table where call-info subscriptions are written.
db_update_interval integer Period in seconds between writes of call-info subscriber information to the database.
onhold_bflag integer When bflag is set the media will be treated as on-hold and sdp parse will be skipped. If the bflag is not set the sdp will be parsed to detect on-hold.
server_address string The server address which will become the value of Contact header filed for reply messages.
contact_fallback string contact used if defined when no contact is found in processed message.
from_uri_avp string avp that will store the From URI used.
to_uri_avp string avp that will store the To URI used.

Funciones exportadas

sca_handle_subscribe([to_uri, [from_uri]])

4.2. sca_call_info_update([mask, to, from])

sca_call_info_update([mask, to, from])

4.1. sca_handle_subscribe([to_uri, [from_uri]])

sca_handle_subscribe([to_uri, [from_uri]])

The function handling call-info and line-seize SUBSCRIBE requests. It stores or updates the subscriptions in shared memory, and sends NOTIFYs to the subscriber and other members of the group as needed.

sca_call_info_update([mask, to, from])

* mask - integer (optional) controls what to check as shared line (BOTH, CALLER, CALLEE) + 0 - SCA_CALL_INFO_SHARED_NONE (default) check both + 1 - SCA_CALL_INFO_SHARED_CALLER + 2 - SCA_CALL_INFO_SHARED_CALLEE * to - string (optional) string to use a

Autores y contribuidores

Andrew MortensenUniversity of PennsylvaniaVictor SevaSipwise GmbH

Copyright © 2012 Andrew Mortensen, admorten@isc.upenn.edu
Copyright © 2024 Sipwise GmbH

Módulos relacionados

auth_web3 auth_xkeys avp avpops benchmark blst call_control call_obj