Methods
SetPolicy | (s: Channel_Type, (uv): Policy) | → | nothing |
Signals
PolicyChanged | (a{s(uv)}: Changed_Policies) |
Properties
SupportedPolicies | a(asau) (Supported_Policy_List) | Read only | ||
ActivePolicies | a{s(uv)} (Active_Policies_Map) | Read only |
Types
Active_Policies_Map | Mapping | a{s(uv)} | |
Supported_Policy | Struct | (asau) |
Description
This interface supports controlling which contacts are allowed to initiate text chats, incoming calls, and other forms of communication as supported by the underlying protocol. The policies supported for different communication methods on this connection are listed in the SupportedPolicies property. The current configuration is held in ActivePolicies; it can be modified using SetPolicy, and changes are signalled by PolicyChanged.
Methods
SetPolicy (s: Channel_Type, (uv): Policy) → nothing
Parameters
- Channel_Type — s (DBus_Interface)
- Policy — (uv) (Access_Control)
Signals
PolicyChanged (a{s(uv)}: Changed_Policies)
Parameters
- Changed_Policies — a{s(uv)} (Active_Policies_Map)
Properties
SupportedPolicies — a(asau) (Supported_Policy_List)
ActivePolicies — a{s(uv)} (Active_Policies_Map)
The active communication policies on this connection. Communication methods that are not in this mapping are considered open.
For example, to allow incoming calls only from contacts buddy list, and to allow text messages from anyone, the policy would look like this:
{ 'im.telepathy.v1.Channel.Type.Text' : Access_Control_Type_Open, 'im.telepathy.v1.Channel.Type.Call' : Access_Control_Type_Publish_List }
Changes to this property are signalled by PolicyChanged.
Types
Active_Policies_Map — a{s(uv)}
- Channel_Type — s (DBus_Interface)
- Active_Policy — (uv) (Access_Control)
Supported_Policy — (asau)
The communication methods (channel types), and the policies that can be applied to them. This is server and protocol dependant.
Grouped channel types will always have the same policy applied to them.
Rationale:
- Channel_Types — as (DBus_Interface_List)
- Supported_Policies — au (Access_Control_Type_List)