diff options
author | Luiz Augusto von Dentz <luiz.von.dentz@intel.com> | 2017-05-04 11:22:35 +0300 |
---|---|---|
committer | Denis Kenzior <denkenz@gmail.com> | 2017-05-04 12:34:31 -0500 |
commit | a192f22d3ea0f52cc942657beb5cf47450f7cb1b (patch) | |
tree | 3ea6e401ee59f7a481c587e5ca8a28a5f542385e /doc | |
parent | 94839129d9b6f4ccf13c4bb39d39f4019f96a3f6 (diff) | |
download | ofono-a192f22d3ea0f52cc942657beb5cf47450f7cb1b.tar.gz |
doc/handsfree-audio-api: Add Acquire method
This adds Acquire method which can be used by agents that require
pulling the fd directly instead of waiting a NewConnection.
Note: sounds servers like PulseAudio do auto suspend streams when idle
for a certain amount of time and once anything happens it will resume
the stream, though this all happens in the so called IO thread in a
blocking fashion making it impossible to receive the fd via NewConnetion
causing the stream to fail to resume. There are other forms to work
around but this seems to be most convenient as we do want the auto
suspend feature to work properly but letting the stream to fail to
resume may create unexpected artifacts while the NewConnection is
handled in main thread.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/handsfree-audio-api.txt | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/doc/handsfree-audio-api.txt b/doc/handsfree-audio-api.txt index d82035c2..87d51cf5 100644 --- a/doc/handsfree-audio-api.txt +++ b/doc/handsfree-audio-api.txt @@ -76,6 +76,22 @@ Methods dict GetProperties() [service].Error.NotImplemented [service].Error.NotAllowed + fd, byte Acquire() + + Attempts to establish the SCO audio connection + returning the filedescriptor of the connection and the + codec in use. + + Note: Contrary to Connect this does not call + NewConnection so it can be called in a blocking + manner. + + Possible Errors: [service].Error.InProgress + [service].Error.Failed + [service].Error.NotAvailable + [service].Error.NotImplemented + [service].Error.NotAllowed + Signals PropertyChanged(string name, variant value) This signal indicates a changed value of the given |