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.
this | |
uri |
the source URI for the file |