WARNING:
This interface is not yet API-stable 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.17.1.
Objects implementing this interface must also implement:
Description
Interface for streamed media channels that can be merged and split in the same sort of way as in GSM or PBX telephony.
Methods
(Permalink)
Merge (o: Other) → nothing
Parameters
- Other — o
The other channel to merge into this one
Request that the given channel be merged into this one. This means
that the other channel is closed, and all its participants are added
to the channel on which this method was called.
Possible Errors
- Disconnected
- Permission Denied
- Network Error
- Invalid Argument
- Not Available
The connection is not currently connected and cannot be used.
This error may also be raised when operations are performed on a
Connection for which
StatusChanged
has signalled status Disconnected for reason None.
The second usage corresponds to None in the
Connection_Status_Reason enum; if a better reason
is available, the corresponding error should be used instead.
The user is not permitted to perform the requested operation.
Raised when there is an error reading from or writing to the network.
Raised when one of the provided arguments is invalid.
Raised when the requested functionality is temporarily unavailable.
(Permalink)
Split (u: Contact) → o: Channel
Parameters
- Contact — u (Contact_Handle)
The handle of the contact to split off a conversation with, who
must be a member in the channel's Group interface
Returns
- Channel — o
The new channel
Request that the given contact is removed from this channel, and
a new channel is created to communicate with them privately instead.
This is the inverse of Merge.
Possible Errors
- Disconnected
- Permission Denied
- Network Error
- Invalid Handle
- Not Available
The connection is not currently connected and cannot be used.
This error may also be raised when operations are performed on a
Connection for which
StatusChanged
has signalled status Disconnected for reason None.
The second usage corresponds to None in the
Connection_Status_Reason enum; if a better reason
is available, the corresponding error should be used instead.
The user is not permitted to perform the requested operation.
Raised when there is an error reading from or writing to the network.
The handle specified is unknown on this channel or connection.
Raised when the requested functionality is temporarily unavailable.