set_file_transfer_uri
Description:
Configure this channel request to provide other local Telepathy components with the URI of the file being sent.
Unlike most properties on a file transfer channel, this information is not sent to the recipient of the file; instead, it is signalled on D-Bus for use by other Telepathy components.
The URI should usually be a file URI as defined by
RFC 1738 §3.10 (for instance, file:///path/to/file or file://localhost/path/to/file). If a remote resource is
being transferred to a contact, it may have a different scheme, such as http.
Even if this method is used, the connection manager will not read the file from disk: the handler for the channel is still responsible for streaming the file. However, providing the URI allows a local logger to log which file was transferred, for instance.
If this functionality is not supported by the connection manager, or if this method is used on a request that is not actually a file transfer, the channel request will fail. Use supports_file_transfer_uri to determine whether outgoing file transfers can have a URI.
This function can't be called once this has been used to request a channel.
Parameters:
| this | |
| uri |
the source URI for the file |