1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
|
/*
* Copyright (c) 2011 Samsung Electronics Co., Ltd All Rights Reserved
*
* Licensed under the Apache License, Version 2.0 (the License);
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an AS IS BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#ifndef __TIZEN_NETWORK_BLUETOOTH_EXTENSION_H__
#define __TIZEN_NETWORK_BLUETOOTH_EXTENSION_H__
#include "bluetooth_type.h"
#include "bluetooth_type_extension.h"
#ifdef __cplusplus
extern "C"
{
#endif /* __cplusplus */
/**
* @file bluetooth_extension.h
*/
/**
* @ingroup CAPI_NETWORK_BLUETOOTH_AUDIO_AG_MODULE
* @brief Opens a SCO(Synchronous Connection Oriented link) to connected remote device, asynchronously.
* @since_tizen 2.3
* @privlevel platform
* @privilege %http://tizen.org/privilege/bluetooth.admin
* @return 0 on success, otherwise a negative error value.
* @retval #BT_ERROR_NONE Successful
* @retval #BT_ERROR_NOT_INITIALIZED Not initialized
* @retval #BT_ERROR_NOT_ENABLED Not enabled
* @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected
* @retval #BT_ERROR_ALREADY_DONE Operation is already done
* @retval #BT_ERROR_OPERATION_FAILED Operation failed
* @retval #BT_ERROR_PERMISSION_DENIED Permission denied
* @retval #BT_ERROR_NOT_SUPPORTED Not supported
*
* @pre The Bluetooth audio device must be connected with bt_audio_connect().
* @post bt_ag_sco_state_changed_cb() will be invoked.
* @see bt_ag_close_sco()
* @see bt_ag_sco_state_changed_cb()
* @see bt_audio_connect()
*/
int bt_ag_open_sco(void);
/**
* @ingroup CAPI_NETWORK_BLUETOOTH_AUDIO_AG_MODULE
* @brief Closes an opened SCO(Synchronous Connection Oriented link), asynchronously.
* @since_tizen 2.3
* @privlevel platform
* @privilege %http://tizen.org/privilege/bluetooth.admin
* @return 0 on success, otherwise a negative error value.
* @retval #BT_ERROR_NONE Successful
* @retval #BT_ERROR_NOT_INITIALIZED Not initialized
* @retval #BT_ERROR_NOT_ENABLED Not enabled
* @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected
* @retval #BT_ERROR_PERMISSION_DENIED Permission denied
* @retval #BT_ERROR_NOT_SUPPORTED Not supported
*
* @pre The SCO must be opened with bt_ag_open_sco().
* @post bt_ag_sco_state_changed_cb() will be invoked.
* @see bt_ag_open_sco()
* @see bt_ag_sco_state_changed_cb()
*/
int bt_ag_close_sco(void);
/**
* @internal
* @ingroup CAPI_NETWORK_BLUETOOTH_AUDIO_AG_MODULE
* @brief Checks whether an opened SCO(Synchronous Connection Oriented link) exists or not.
* @since_tizen 2.3
* @param[out] opened The SCO status: (@c true = opened, @c false = not opened)
* @return 0 on success, otherwise a negative error value.
* @retval #BT_ERROR_NONE Successful
* @retval #BT_ERROR_NOT_INITIALIZED Not initialized
* @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #BT_ERROR_NOT_ENABLED Not enabled
* @retval #BT_ERROR_NOT_SUPPORTED Not supported
*
* @pre The Bluetooth audio service must be initialized with bt_audio_initialize().
* @see bt_ag_open_sco()
* @see bt_ag_close_sco()
*/
int bt_ag_is_sco_opened(bool *opened);
/**
* @internal
* @ingroup CAPI_NETWORK_BLUETOOTH_AUDIO_AG_MODULE
* @brief Registers a callback function that will be invoked when the SCO(Synchronous Connection Oriented link) state is changed.
* @since_tizen 2.3
* @param[in] callback The callback function to register
* @param[in] user_data The user data to be passed to the callback function
* @return 0 on success, otherwise a negative error value.
* @retval #BT_ERROR_NONE Successful
* @retval #BT_ERROR_NOT_INITIALIZED Not initialized
* @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #BT_ERROR_NOT_SUPPORTED Not supported
*
* @pre The Bluetooth audio service must be initialized with bt_audio_initialize().
* @see bt_audio_initialize()
* @see bt_ag_sco_state_changed_cb()
* @see bt_ag_unset_sco_state_changed_cb()
*/
int bt_ag_set_sco_state_changed_cb(bt_ag_sco_state_changed_cb callback, void *user_data);
/**
* @internal
* @ingroup CAPI_NETWORK_BLUETOOTH_AUDIO_AG_MODULE
* @brief Unregisters a callback function that will be invoked when the SCO(Synchronous Connection Oriented link) state is changed.
* @since_tizen 2.3
* @return 0 on success, otherwise a negative error value.
* @retval #BT_ERROR_NONE Successful
* @retval #BT_ERROR_NOT_INITIALIZED Not initialized
* @retval #BT_ERROR_NOT_SUPPORTED Not supported
*
* @pre The Bluetooth audio service must be initialized with bt_audio_initialize().
* @see bt_audio_initialize()
* @see bt_ag_sco_state_changed_cb()
* @see bt_ag_set_sco_state_changed_cb()
*/
int bt_ag_unset_sco_state_changed_cb(void);
/**
* @internal
* @ingroup CAPI_NETWORK_BLUETOOTH_AUDIO_AG_MODULE
* @brief Notifies the state of voice recognition.
* @since_tizen 2.3
* @privlevel platform
* @privilege %http://tizen.org/privilege/bluetooth.admin
* @param[in] state The state of voice recognition: (@c true = enabled, @c false = disabled)
* @return 0 on success, otherwise a negative error value.
* @retval #BT_ERROR_NONE Successful
* @retval #BT_ERROR_NOT_INITIALIZED Not initialized
* @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #BT_ERROR_NOT_ENABLED Not enabled
* @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected
* @retval #BT_ERROR_OPERATION_FAILED Operation failed
* @retval #BT_ERROR_PERMISSION_DENIED Permission denied
* @retval #BT_ERROR_NOT_SUPPORTED Not supported
*
* @pre The Bluetooth audio device must be connected with bt_audio_connect().
* @see bt_audio_connect()
*/
int bt_ag_notify_voice_recognition_state(bool state);
/**
* @}
*/
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif // __TIZEN_NETWORK_BLUETOOTH_EXTENTION_H__
|
