Interface org.freedesktop.Telepathy.Connection.Interface.ServicePoint.DRAFT

Interface Index (Compact) | Summary | Description | Signals | Properties | Types

Signals

ServicePointsChanged (a((us)as): ServicePoints)

Properties

KnownServicePoints a((us)as) (Service_Point_Info_List) Read only

Types

Uniform_Resource_Name Simple Type s
Service_Point_Type Enum u
Service_Point_Info Struct ((us)as)
Service_Point Struct (us)
WARNING: This interface is experimental and is likely to cause havoc to your API/ABI if bindings are generated. Do not include this interface in libraries that care about compatibility.
Added in 0.19.6. (draft version, not API-stable)

Description

An interface for connections whose channels may be able to indicate specific they are connected to some form of service station. 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.

Signals

(Permalink)

ServicePointsChanged (a((us)as): ServicePoints)

Parameters

Indicate that the list of known service points (or their IDs) have changed, presenting the new list.

Properties

Accessed using the org.freedesktop.DBus.Properties interface.
(Permalink)

KnownServicePoints — a((us)as) (Service_Point_Info_List)

Read only
The list of all (known) service points.

Types

Simple Type (Permalink)

Uniform_Resource_Name — s

Uniform Resource Name as specified by RFC 5031.
Enum (Permalink)

Service_Point_Type — u

The various types of service points the channel might connect to.
  • None (0)
    • The service point is not used/available.
  • Emergency (1)
    • The service point is a generic emergency point.
  • Counseling (2)
    • The service point is some kind of counseling service (ie, mental health or child-services counseling).
Struct (Permalink)

Service_Point_Info — ((us)as)

Description of a service point and IDs which are mapped to id.

An example Service Point info for GSM emergency calls (callable through "911" and "112") could look like:

  ServicePointInfo = (
    ServicePoint: (
      ServicePointType: 1 (Emergency),
      ServicePoint: "urn:service:sos"
    ),
    ServiceIDs: [ "911", "112" ]
  )
  • ServicePoint — (us) (Service_Point)
    • The service point.
  • ServiceIDs — as
    • A list of IDs that are mapped to this service. This is provided as a convenience for the UIs, but the preferred method for requesting channel to a service is by setting InitialServicePoint property in channel request.
Struct (Permalink)

Service_Point — (us)

A service point.
  • ServicePointType — u (Service_Point_Type)
    • The service type.
  • Service — s
    • String representation of the service point. The representation is service specific; it may be Uniform_Resource_Name or may be in some other form. Empty, unused or unknown value is represented by "".