Signals
ServicePointChanged | ((us): Service_Point) |
Properties
InitialServicePoint | (us) ( Service_Point) | Read only | ||
CurrentServicePoint | (us) ( Service_Point) | Read only |
Description
An interface for channels that can indicate when/if they are connected to some form of service point. For example, when dialing 9-1-1 in the US, a GSM modem/network will recognize that as an emergency call, and inform higher levels of the stack that the call is being handled by an emergency service. In this example, the call is handled by a Public Safety Answering Point (PSAP) which is labeled as "urn:service:sos". Other networks and protocols may handle this differently while still using this interface.
Note that while the majority of examples given in this documentation are for GSM calls, they could just as easily be SIP calls, GSM SMS's, etc.
Signals
ServicePointChanged ((us): Service_Point)
Parameters
- Service_Point — (us) (Service_Point)
Emitted when a channel changes the service point that it's connected to. This might be a new call being connected to a service, a call connected to a service being routed to a different service (ie, an emergency call being routed from a generic emergency PSAP to a poison control PSAP), or any number of other things.
Note that this should be emitted as soon as the CM has been notified of the switch, and has updated its internal state. The CM MAY still be in the process of connecting to the new service point.
Properties
InitialServicePoint — (us) (Service_Point)
This property is used to indicate that the channel target is a well-known service point. Please note that the CM (or lower layers of the stack or network) may forward the connection to other other service points, which the CM SHOULD indicate via ServicePointChanged signal.
This property SHOULD be set for channel requests that are specifically targeting service points.