[Bug 19589] Need a way for clients to know what kinds of channel can be handled.

[bugzilla-daemon at freedesktop.org]

https://bugs.freedesktop.org/show_bug.cgi?id=19589

--- Comment #3 from Simon McVittie <simon.mcvittie at collabora.co.uk> 2010-06-28 10:04:14 PDT ---
Bug #25288 has two similar proposals:

ChannelDispatcher.GetPossibleHandlers(a{sv}: Properties) -> as
    Check whether a requested channel whose immutable properties were
    Properties could be handled. If so, return the expected
    ChannelDispatchOperation.PossibleHandlers property for such a channel;
    if not, return an empty list.

    | This is appropriate for UIs to check whether a suitable client for
    | a request is installed; for instance, Empathy could use it.

    The channel dispatcher SHOULD assume that { Requested => TRUE } is
    in the Properties, even if it's not specifically given.

    | This matters if you have a client that only handles outgoing 
    | channels, like a Vino "share my desktop" request.

and

interface o.fd.T.ChannelDispatcher.Interface.PossibleHandlers

    method GetPossibleHandlers(a{sv}) -> as

        [... documented as before ...]

        Clients MAY cache the result of this method (or more practically,
        decisions based on the result of this method), and use HandlersChanged
        to detect when to update their caches.

        | For instance, the Empathy contact list has a "Share my desktop"
        | menu item, which is visible when a VNC tube handler such as Vino
        | is available.

    signal HandlersChanged()
        Emitted when the set of available handlers has changed. Clients
        that cache the results of GetPossibleHandlers SHOULD call that
        method again.

-- 
Configure bugmail: https://bugs.freedesktop.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
You are the assignee for the bug.