summaryrefslogtreecommitdiffstats
path: root/doc/audio-api.txt
diff options
context:
space:
mode:
authorLuiz Augusto von Dentz <luiz.dentz@openbossa.org>2008-10-02 19:45:27 -0300
committerLuiz Augusto von Dentz <luiz.dentz@openbossa.org>2008-10-02 19:45:27 -0300
commitfc0c9d075db171849357a53a87de656c580c1876 (patch)
treefc1e4af9b32e8de21d2e2e724126e1882f16af5e /doc/audio-api.txt
parentacf2a8a0b31a273a49121c8380cc5ac65d8f4dfb (diff)
Update documentation.
Diffstat (limited to 'doc/audio-api.txt')
-rw-r--r--doc/audio-api.txt95
1 files changed, 78 insertions, 17 deletions
diff --git a/doc/audio-api.txt b/doc/audio-api.txt
index 88f5b8b4..a73ba20d 100644
--- a/doc/audio-api.txt
+++ b/doc/audio-api.txt
@@ -22,7 +22,7 @@ Methods void Connect()
Disconnect from the HSP/HFP service on the remote
device.
- boolean IsConnected()
+ boolean IsConnected() {deprecated}
Returns TRUE if there is a active connection to the
HSP/HFP connection on the remote device.
@@ -45,57 +45,96 @@ Methods void Connect()
Close the audio connection.
- boolean IsPlaying()
+ boolean IsPlaying() {deprecated}
Returns true if an audio connection to the headset
is active.
- uint16 GetSpeakerGain()
+ uint16 GetSpeakerGain() {deprecated}
Returns the current speaker gain if available,
otherwise returns the error NotAvailable.
- uint16 GetMicrophoneGain()
+ uint16 GetMicrophoneGain() {deprecated}
Returns the current microphone gain if available,
otherwise returns the error NotAvailable.
- void SetSpeakerGain(uint16 gain)
+ void SetSpeakerGain(uint16 gain) {deprecated}
Changes the current speaker gain if possible.
- void SetMicrophoneGain(uint16 gain)
+ void SetMicrophoneGain(uint16 gain) {deprecated}
Changes the current speaker gain if possible.
+ dict GetProperties()
+
+ Returns all properties for the interface. See the
+ properties section for available properties.
+
+ Possible Errors: org.bluez.Error.InvalidArguments
+
+ void SetProperty(string name, variant value)
+
+ Changes the value of the specified property. Only
+ properties that are listed a read-write are changeable.
+ On success this will emit a PropertyChanged signal.
+
+ Possible Errors: org.bluez.Error.DoesNotExist
+ org.bluez.Error.InvalidArguments
+
Signals void AnswerRequested()
Sent when the answer button is pressed on the headset
- void Connected()
+ void Connected() {deprecated}
Sent when the device has been connected to.
- void Disconnected()
+ void Disconnected() {deprecated}
Sent when the device has been disconnected from.
- void Stopped()
+ void Stopped() {deprecated}
Sent when the audio connection is closed
- void Playing()
+ void Playing() {deprecated}
Sent when the audio connection is opened
- void SpeakerGainChanged(uint16 gain)
+ void SpeakerGainChanged(uint16 gain) {deprecated}
The speaker gain changed.
- void MicrophoneGainChanged(uint16 gain)
+ void MicrophoneGainChanged(uint16 gain) {deprecated}
The microphone gain changed.
+ PropertyChanged(string name, variant value)
+
+ This signal indicates a changed value of the given
+ property.
+
+properties boolean Connected [readonly]
+
+ Indicates if there is a active connection to the
+ HSP/HFP connection on the remote device.
+
+ boolean Playing [readonly]
+
+ Indicates if an audio connection to the headset
+ is active.
+
+ uint16 SpeakerGain [readwrite]
+
+ The speaker gain when available.
+
+ uint16 MicrophoneGain [readwrite]
+
+ The speaker gain when available.
+
AudioSink hierarchy
===================
@@ -113,24 +152,46 @@ Methods void Connect()
Disconnect from the remote device.
- boolean IsConnected()
+ boolean IsConnected() {deprecated}
Returns TRUE if a stream is setup to a A2DP sink on
the remote device.
-Signals void Connected()
+ dict GetProperties()
+
+ Returns all properties for the interface. See the
+ properties section for available properties.
+
+ Possible Errors: org.bluez.Error.InvalidArguments
+
+Signals void Connected() {deprecated}
Sent when a successful connection has been made to the
remote A2DP Sink
- void Disconnected()
+ void Disconnected() {deprecated}
Sent when the device has been disconnected from.
- void Playing()
+ void Playing() {deprecated}
Sent when a stream with remote device is started.
- void Stopped()
+ void Stopped() {deprecated}
Sent when a stream with remote device is suspended.
+
+ PropertyChanged(string name, variant value)
+
+ This signal indicates a changed value of the given
+ property.
+
+properties boolean Connected [readonly]
+
+ Indicates if a stream is setup to a A2DP sink on
+ the remote device.
+
+ boolean Playing [readonly]
+
+ Indicates if a stream is active to a A2DP sink on
+ the remote device.