2 // Open Service Platform
3 // Copyright (c) 2012-2013 Samsung Electronics Co., Ltd.
5 // Licensed under the Apache License, Version 2.0 (the License);
6 // you may not use this file except in compliance with the License.
7 // You may obtain a copy of the License at
9 // http://www.apache.org/licenses/LICENSE-2.0
11 // Unless required by applicable law or agreed to in writing, software
12 // distributed under the License is distributed on an "AS IS" BASIS,
13 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 // See the License for the specific language governing permissions and
15 // limitations under the License.
18 * @file FTelCallManager.h
19 * @brief This is the header file for the %CallManager class.
21 * This header file contains the declarations of the %CallManager class.
23 #ifndef _FTEL_CALL_MANAGER_H_
24 #define _FTEL_CALL_MANAGER_H_
28 #include <FTelTypes.h>
29 #include <FTelCallInfo.h>
30 #include <FTelITelephonyCallEventListener.h>
31 #include <FTelITelephonyCallForwardListener.h>
34 namespace Tizen { namespace Telephony
36 class _CallManagerImpl;
40 * @brief This class provides methods to obtain information about the current call.
44 * The %CallManager class provides methods to obtain information about the current call type and its status.
46 * The following example demonstrates how to use the %CallManager class to obtain information about a call.
51 * MyClass::GetCallInfo(void)
53 * CallType callType = TYPE_UNDEFINED_CALL;
54 * CallStatus callStatus = CALL_STATUS_UNDEFINED;
56 * CallManager* pCallManager = new CallManager();
58 * result r = pCallManager->Construct(*this);
61 * delete pCallManager;
65 * callStatus = pCallManager->GetCurrentCallStatus();
67 * if (callStatus == CALL_STATUS_COMMUNICATING)
69 * callType = pCallManager->GetCurrentCallType();
72 * delete pCallManager;
77 * MyClass::OnTelephonyCallStatusChangedN(CallStatus callStatus,CallInfo * pCallInfo)
82 * if (callStatus == CALL_STATUS_RINGING)
84 * callType = pCallInfo->GetCallType();
85 * number = pCallInfo->GetNumber();
94 class _OSP_EXPORT_ CallManager
95 : public Tizen::Base::Object
99 * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
106 * This destructor overrides Tizen::Base::Object::~Object().
110 virtual ~CallManager(void);
113 * Initializes a new instance of this class. @n
114 * This is the two phase construction.
117 * @feature %http://tizen.org/feature/network.telephony
118 * @return An error code
119 * @exception E_SUCCESS The method is successful.
120 * @exception E_SYSTEM A system error has occurred.
121 * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
122 * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
123 * @remarks Before calling this method, check whether the feature is supported by %Tizen::System::SystemInfo::GetValue() methods.
125 result Construct(void);
128 * Initializes a new instance of this class. @n
129 * This is the two phase construction.
132 * @feature %http://tizen.org/feature/network.telephony
133 * @return An error code
134 * @param[in] listener The listener for change in status of a call
135 * @exception E_SUCCESS The method is successful.
136 * @exception E_SYSTEM A system error has occurred.
137 * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
138 * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
139 * @remarks Before calling this method, check whether the feature is supported by %Tizen::System::SystemInfo::GetValue() methods.
141 result Construct(ITelephonyCallEventListener& listener);
144 * Sets the listener that listens to the call forwarding request.
148 * @privlevel platform
149 * @privilege %http://tizen.org/privilege/callforward
151 * @return An error code
152 * @param[in] pListener An ITelephonyCallForwardListener instance @n
153 * The parameter can be set to @c null to remove listener.
154 * @exception E_SUCCESS The method is successful.
155 * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
156 * @exception E_SYSTEM A system error has occurred.
158 result SetCallForwardListener(ITelephonyCallForwardListener* pListener);
161 * Requests call forwarding with the specified number. @n
162 * The %RequestCallForward() method sends the request to the network, and receives the response asynchronously.
166 * @privlevel platform
167 * @privilege %http://tizen.org/privilege/callforward
169 * @return An error code
170 * @param[in] phoneNumber The phone number for call forwarding
171 * @exception E_SUCCESS The method is successful.
172 * @exception E_INVALID_STATE This instance is in an invalid state.
173 * @exception E_INVALID_FORMAT The specified phone number is in an invalid format.
174 * @exception E_IN_PROGRESS The previous request is in progress.
175 * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
176 * @exception E_NETWORK_UNAVAILABLE The operation has failed because the device is in the offline mode.
177 * @exception E_SERVICE_UNAVAILABLE The operation has failed because the device is out of the coverage area or in the emergency mode.
178 * @exception E_SYSTEM A system error has occurred.
179 * @remarks The call will be forwarded unconditionally. Voice call only. @n
180 * The phone number can start with plus(+) and the remaining part must be number.
181 * @see ITelephonyCallForwardListener::OnTelephonyCallForwardResponseReceived()
183 result RequestCallForward(const Tizen::Base::String& phoneNumber);
186 * Stops call forwarding.
190 * @privlevel platform
191 * @privilege %http://tizen.org/privilege/callforward
193 * @return An error code
194 * @exception E_SUCCESS The method is successful.
195 * @exception E_INVALID_STATE This instance is in an invalid state.
196 * @exception E_IN_PROGRESS The previous request is in progress.
197 * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
198 * @exception E_NETWORK_UNAVAILABLE The operation has failed because the device is in the offline mode.
199 * @exception E_SERVICE_UNAVAILABLE The operation has failed because the device is out of the coverage area or in the emergency mode.
200 * @exception E_SYSTEM A system error has occurred.
201 * @see ITelephonyCallForwardListener::OnTelephonyCallForwardStopped()
203 result StopCallForward(void);
206 * Gets the phone number to which the call must be forwarded.
210 * @privlevel platform
211 * @privilege %http://tizen.org/privilege/callforward
213 * @return An error code
214 * @exception E_SUCCESS The method is successful.
215 * @exception E_IN_PROGRESS The previous request is in progress.
216 * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
217 * @exception E_NETWORK_UNAVAILABLE The operation has failed because the device is in the offline mode.
218 * @exception E_SERVICE_UNAVAILABLE The operation has failed because the device is out of the coverage area or in the emergency mode.
219 * @exception E_SYSTEM A system error has occurred.
220 * @see ITelephonyCallForwardListener::OnTelephonyCallForwardNumberReceived
222 result GetCallForwardNumber(void) const;
225 * Gets the call type of the current call.
229 * @return The current call type, @n
230 * else @c TYPE_UNDEFINED_CALL if the method fails
232 CallType GetCurrentCallType(void) const;
235 * Gets the call status of the current call.
239 * @return The current call status, @n
240 * else @c CALL_STATUS_UNDEFINED if the method fails
242 CallStatus GetCurrentCallStatus(void) const;
246 * The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
248 * @param[in] rhs An instance of %CallManager
250 CallManager(const CallManager& rhs);
253 * The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects.
255 * @param[in] rhs An instance of %CallManager
257 CallManager& operator =(const CallManager& rhs);
260 _CallManagerImpl* __pCallManagerImpl;
262 friend class _CallManagerImpl;
265 } } // Tizen::Telephony
266 #endif // _FTEL_CALL_MANAGER_H_