Add State property to the AudioSink interface

This patch adds a new string State property to the AudioSink interface. It
makes use of the recently added AVDTP connection state tracking support to
create a "connecting" state.

1 files changed, 27 insertions, 1 deletions

diff --git a/doc/audio-api.txt b/doc/audio-api.txt
index 64e13740..59c8e647 100644
--- a/doc/audio-api.txt
+++ b/doc/audio-api.txt
@@ -211,7 +211,33 @@ Signals		void Connected() {deprecated}
 			This signal indicates a changed value of the given
 			property.
 
-properties	boolean Connected [readonly]
+properties	string State [readonly]
+
+			Possible values: "disconnected", "connecting",
+			"connected", "playing"
+
+			"disconnected" -> "connecting"
+				Either an incoming or outgoing connection
+				attempt ongoing.
+
+			"connecting" -> "disconnected"
+				Connection attempt failed
+
+			"connecting" -> "connected"
+				Successfully connected
+
+			"connected" -> "playing"
+				Audio stream active
+
+			"playing" -> "connected"
+				Audio stream suspended
+
+			"connected" -> "disconnected"
+			"playing" -> "disconnected"
+				Disconnected from the remote device
+
+
+		boolean Connected [readonly]
 
 			Indicates if a stream is setup to a A2DP sink on
 			the remote device.