The Telephony provides call, modem, network, and SIM information.
Required Header
#include <telephony.h>
Overview
The Telephony provides call, modem, network, and SIM information.
Related Features
This API is related with the following feature:
It is recommended to design feature related codes in your application for reliability.
You can check if a device supports the related features for this API by using System Information, thereby controlling the procedure of your application.
To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.
More details on featuring your application can be found from Feature Element.
Typedef Documentation
The Telephony API handle.
- Since :
- 2.3
Called when the telephony state changes.
- Since :
- 2.3
Enumeration Type Documentation
Enumeration for Telephony error.
- Since :
- 2.3
- Enumerator:
TELEPHONY_ERROR_NONE |
Successful
|
TELEPHONY_ERROR_OUT_OF_MEMORY |
Out of memory
|
TELEPHONY_ERROR_INVALID_PARAMETER |
Invalid parameter
|
TELEPHONY_ERROR_PERMISSION_DENIED |
Permission denied
|
TELEPHONY_ERROR_NOT_SUPPORTED |
Not supported
|
TELEPHONY_ERROR_OPERATION_FAILED |
Operation failed
|
TELEPHONY_ERROR_SIM_NOT_AVAILABLE |
SIM is not available
|
Enumeration for Telephony notification.
- Since :
- 2.3
- Enumerator:
TELEPHONY_NOTI_SIM_STATUS |
Notification to be invoked when the SIM card state changes
|
TELEPHONY_NOTI_NETWORK_SERVICE_STATE |
Notification to be invoked when the network service state changes
|
TELEPHONY_NOTI_NETWORK_CELLID |
Notification to be invoked when the cell ID changes
|
TELEPHONY_NOTI_NETWORK_ROAMING_STATUS |
Notification to be invoked when the roaming status changes
|
TELEPHONY_NOTI_NETWORK_SIGNALSTRENGTH_LEVEL |
Notification to be invoked when the signal strength changes
|
TELEPHONY_NOTI_VOICE_CALL_STATE |
Notification to be invoked when the voice call state changes
|
TELEPHONY_NOTI_VIDEO_CALL_STATE |
Notification to be invoked when the video call state changes
|
Function Documentation
Deinitializes the telephony handle list.
- Since :
- 2.3
- Parameters:
-
[in] | list | The handle list to be deinitialized |
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
- See also:
- telephony_init()
Acquires the list of available handles to use the telephony API.
- Since :
- 2.3
- Parameters:
-
[out] | list | The list contains the number of available handles and array of handles |
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
- See also:
- telephony_deinit()
Sets a callback function to be invoked when the telephony state changes.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/telephony
- Parameters:
-
[in] | handle | The handle to use the telephony API |
[in] | noti_id | The notification ID to set the callback |
[in] | cb | The callback to be invoked when the telephony state changes |
[in] | user_data | The user data passed to the callback function |
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
- Postcondition:
- telephony_noti_cb() will be invoked.
- See also:
- telephony_unset_noti_cb()
Unsets a callback function.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/telephony
- Parameters:
-
[in] | handle | The handle to use the telephony API |
[in] | noti_id | The notification ID to unset a callback |
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
- See also:
- telephony_set_noti_cb()