retrieve transferred callΒΆ

class UASCallChannel
retrieve_transferred_call()

Retrieve a channel that was transferred using the retrievable_transfer function. The audio path to the channel will be restored.

The channel should be in the TRANSFERRED state. If it is IDLE, this function will raise a Hangup exception.

This function will block until confirmation has been received that the transfer has been broken, or a timeout has expired.

If the call is successfully retrieved, its state will have returned to ANSWERED. If the state does not return to ANSWERED a cause can be retrieved by calling the transfer_cause() function.

This function will return the channel state.

Usage example:

if channel.retrieve_transferred_call() != channel.State.ANSWERED:
    cause = channel.transfer_cause()
    print("could not retrieve the channel, reason is {0}".format(cause))