<commit_before>BlueZ D-Bus Audio API description
*********************************

Copyright (C) 2004-2008  <NAME> <<EMAIL>>
Copyright (C) 2005-2007  <NAME> <<EMAIL>>
Copyright (C) 2005-2006  <NAME> <<EMAIL>>


Headset hierarchy
=================

Service		org.bluez
Interface	org.bluez.Headset
Object path	/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX

Methods		void Connect()

			Connect to the HSP/HFP service on the remote device.

		void Disconnect()

			Disconnect from the HSP/HFP service on the remote
			device.

		boolean IsConnected()

			Returns TRUE if there is a active connection to the
			HSP/HFP connection on the remote device.

		void IndicateCall()

			Indicate an incoming call on the headset
			connected to the stream. Will continue to
			ring the headset about every 3 seconds.

		void CancelCall()

			Cancel the incoming call indication.

		void Play()

			Open the audio connection to the headset.

		void Stop()

			Close the audio connection.

		boolean IsPlaying()

			Returns true if an audio connection to the headset
			is active.

		uint16 GetSpeakerGain()

			Returns the current speaker gain if available,
			otherwise returns the error NotAvailable.

		uint16 GetMicrophoneGain()

			Returns the current microphone gain if available,
			otherwise returns the error NotAvailable.

		void SetSpeakerGain(uint16 gain)

			Changes the current speaker gain if possible.

		void SetMicrophoneGain(uint16 gain)

			Changes the current speaker gain if possible.

		void SetupCall(string value) [experimental]

			Sets up an call with the connected HFP. The value can
			be "incoming", "outgoing" or "remote" to indicate
			incoming call, outgoing call and remote party alerted
			respectively.

		void IdentifyCall(string phone_number, int32 type) [experimental]

			Enables a called subscriber to get the calling
			line identity (CLI) of the calling party when
			receiving a call. The value of type shud be
			the same as provided by the GSM stack.

Signals		void AnswerRequested()

			Sent when the answer button is pressed on the headset

		void Connected()

			Sent when the device has been connected to.

		void Disconnected()

			Sent when the device has been disconnected from.

		void Stopped()

			Sent when the audio connection is closed

		void Playing()

			Sent when the audio connection is opened

		void SpeakerGainChanged(uint16 gain)

			The speaker gain changed.

		void MicrophoneGainChanged(uint16 gain)

			The microphone gain changed.

		void CallTerminated()

			Sent when an ongoing call is terminated.


Headset hierarchy
=================

Service		org.bluez
Interface	org.bluez.Sink
Object path	/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX

Methods		void Connect()

			Connect and setup a stream to a A2DP sink on the<commit_msg>Fix typo<commit_after>BlueZ D-Bus Audio API description
*********************************

Copyright (C) 2004-2008  <NAME> <<EMAIL>>
Copyright (C) 2005-2007  <NAME> <<EMAIL>>
Copyright (C) 2005-2006  <NAME> <<EMAIL>>


Headset hierarchy
=================

Service		org.bluez
Interface	org.bluez.Headset
Object path	/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX

Methods		void Connect()

			Connect to the HSP/HFP service on the remote device.

		void Disconnect()

			Disconnect from the HSP/HFP service on the remote
			device.

		boolean IsConnected()

			Returns TRUE if there is a active connection to the
			HSP/HFP connection on the remote device.

		void IndicateCall()

			Indicate an incoming call on the headset
			connected to the stream. Will continue to
			ring the headset about every 3 seconds.

		void CancelCall()

			Cancel the incoming call indication.

		void Play()

			Open the audio connection to the headset.

		void Stop()

			Close the audio connection.

		boolean IsPlaying()

			Returns true if an audio connection to the headset
			is active.

		uint16 GetSpeakerGain()

			Returns the current speaker gain if available,
			otherwise returns the error NotAvailable.

		uint16 GetMicrophoneGain()

			Returns the current microphone gain if available,
			otherwise returns the error NotAvailable.

		void SetSpeakerGain(uint16 gain)

			Changes the current speaker gain if possible.

		void SetMicrophoneGain(uint16 gain)

			Changes the current speaker gain if possible.

		void SetupCall(string value) [experimental]

			Sets up an call with the connected HFP. The value can
			be "incoming", "outgoing" or "remote" to indicate
			incoming call, outgoing call and remote party alerted
			respectively.

		void IdentifyCall(string phone_number, int32 type) [experimental]

			Enables a called subscriber to get the calling
			line identity (CLI) of the calling party when
			receiving a call. The value of type shud be
			the same as provided by the GSM stack.

Signals		void AnswerRequested()

			Sent when the answer button is pressed on the headset

		void Connected()

			Sent when the device has been connected to.

		void Disconnected()

			Sent when the device has been disconnected from.

		void Stopped()

			Sent when the audio connection is closed

		void Playing()

			Sent when the audio connection is opened

		void SpeakerGainChanged(uint16 gain)

			The speaker gain changed.

		void MicrophoneGainChanged(uint16 gain)

			The microphone gain changed.

		void CallTerminated()

			Sent when an ongoing call is terminated.


Sink hierarchy
==============

Service		org.bluez
Interface	org.bluez.Sink
Object path	/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX

Methods		void Connect()

			Connect and setup a stream to a A2DP sink on the
{'fraction_non_alphanumeric': 0.07528434735511826, 'fraction_numerical': 0.0158873442859722, 'mean_word_length': 3.6166666666666667, 'pattern_counts': {'":': 0, '<': 21, '<?xml version=': 0, '>': 21, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1629960', 'n_tokens_mistral': 1888, 'n_tokens_neox': 1504, 'n_words': 686}