WARNING:
This interface is a staging area for future Channel functionality 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.
Objects implementing this interface must also implement:
Description
This interface contains functionality which we intend to incorporate
into the ChannelRequest
interface in future. It should be considered to
be conceptually part of the core ChannelRequest interface, but without
API or ABI guarantees.
Signals
(Permalink)
SucceededWithChannel (o: Connection, o: Channel)
Added in 0.19.12.
(as draft)
Variant of the Succeeded signal
allowing to get the channel which has been created.
Properties
Accessed using the org.freedesktop.DBus.Properties interface.
(Permalink)
Hints — a{sv}
Read only
Added in 0.19.12.
(as draft)
A dictionary of metadata provided by the channel
requester, which the handler and other clients MAY choose to
interpret. Currently no standard keys are defined; clients MAY
choose to use platform-specific keys for their own purposes, but MUST
ignore unknown keys and MUST cope with expected keys being
missing.
Rationale:
This property might be used to pass a contact ID for a
telephone number shared between two contacts from the address book to
the call UI, so that if you try to call “Mum”, the call UI knows this
rather than having to guess or show “Calling Mum or Dad”. The format
of these contact IDs would be platform-specific, so we leave the
definition of the dictionary entry up to the platform in question.
But third-party channel requesters might not include the contact ID,
so the call UI has to be able to deal with it not being
there.
The channel dispatcher will not interpret these hints: they are
solely for communication between cooperating clients.
Rationale:
Any extra parameters that do affect the channel dispatcher should
be designed separately.
This property may be set when the channel request is created, and
can never change. Since it is immutable, it SHOULD be included in the
dictionary of properties passed to AddRequest
by the ChannelDispatcher.