Description
This interface contains functionality which we intend to incorporate into the Handler interface in future. It should be considered to be conceptually part of the core Handler interface, but without API or ABI guarantees.
Properties
BypassObservers — b
If true, channels destined for this handler are not passed to observers for observing.
Rationale:
This is useful in use-cases where the handler doesn't want anyone observing the channel - for example, because channels it handles shouldn't be logged.
For service-activatable handlers, this property should be specified in the handler's .client file as follows:
[im.telepathy.v1.Client.Handler] BypassObservers=true
RelatedConferencesBypassApproval — b
If true, channels destined for this handler that have the Conference1 interface, with a channel that was previously handled by the same client process in their InitialChannels property, should bypass the approval stage. In effect, this is a weaker form of BypassApproval.
Rationale:
It would be reasonable for a user interface to accept invitations to continuations of an existing channel automatically, or not; this is a matter of UI policy.
It's somewhat complex for an Approver to keep track of which channels are being handled by a particular Handler, but the Channel Dispatcher already has to track this, so it's useful for the channel dispatcher to assist here.