The Call API provides functions to check the state of voice and video calls.

Required Header

#include <telephony.h>

Overview

The Telephony Call API allows you to get the voice and videos call states. You can use this information about call related actions.

Related Features

This API is related with the following feature:

http://tizen.org/feature/network.telephony

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.

Functions
int	telephony_call_get_voice_call_state (telephony_h handle, telephony_call_state_e *call_state) TIZEN_DEPRECATED_API
	Gets the voice call state of the telephony service.
int	telephony_call_get_video_call_state (telephony_h handle, telephony_call_state_e *call_state) TIZEN_DEPRECATED_API
	Gets the video call state of the telephony service.
int	telephony_call_get_preferred_voice_subscription (telephony_h handle, telephony_call_preferred_voice_subs_e *call_sub)
	Gets the current value for the preferred voice call subscription.
int	telephony_call_get_call_list (telephony_h handle, unsigned int count, telephony_call_h *call_list)
	Gets the list of the current call.
int	telephony_call_release_call_list (unsigned int count, telephony_call_h **call_list)
	Releases the list allocated from telephony_call_get_call_list().
int	telephony_call_get_handle_id (telephony_call_h call_handle, unsigned int *handle_id)
	Gets the call handle ID.
int	telephony_call_get_number (telephony_call_h call_handle, char **number)
	Gets the call number.
int	telephony_call_get_type (telephony_call_h call_handle, telephony_call_type_e *type)
	Gets the call type.
int	telephony_call_get_status (telephony_call_h call_handle, telephony_call_status_e *status)
	Gets the call status.
int	telephony_call_get_direction (telephony_call_h call_handle, telephony_call_direction_e *direction)
	Gets whether the call is MO(Mobile Originated) call or MT(Mobile Terminated).
int	telephony_call_get_conference_status (telephony_call_h call_handle, bool *conference_status)
	Gets whether the call is conference call or not.
Typedefs
typedef struct telephony_call_info_s *	telephony_call_h
	The call handle.

Typedef Documentation

typedef struct telephony_call_info_s* telephony_call_h

The call handle.

Since :: 3.0

Enumeration Type Documentation

enum telephony_call_direction_e

Enumeration for the call direction.

Since :: 3.0

Enumerator:

TELEPHONY_CALL_DIRECTION_MO	MO(Mobile Originated) call
TELEPHONY_CALL_DIRECTION_MT	MT(Mobile Terminated) call

enum telephony_call_preferred_voice_subs_e

Enumeration for the preferred voice call subscription.

Since :: 3.0

Enumerator:

TELEPHONY_CALL_PREFERRED_VOICE_SUBS_UNKNOWN	Unknown status
TELEPHONY_CALL_PREFERRED_VOICE_SUBS_CURRENT_NETWORK	Current network
TELEPHONY_CALL_PREFERRED_VOICE_SUBS_ASK_ALWAYS	ASK Always
TELEPHONY_CALL_PREFERRED_VOICE_SUBS_SIM1	SIM 1
TELEPHONY_CALL_PREFERRED_VOICE_SUBS_SIM2	SIM 2

enum telephony_call_state_e

Enumeration for the call state.

Deprecated:: Deprecated Since 3.0. Use telephony_call_status_e instead.

Since :: 2.3.1

Enumerator:

TELEPHONY_CALL_STATE_IDLE	There exists no calls.
TELEPHONY_CALL_STATE_CONNECTING	There exists at least one call that is dialing, alerting or incoming
TELEPHONY_CALL_STATE_CONNECTED	There exist active or held calls, and no calls are dialing, alerting or incoming

enum telephony_call_status_e

Enumeration for the call status.

Since :: 3.0

Enumerator:

TELEPHONY_CALL_STATUS_IDLE	Idle status
TELEPHONY_CALL_STATUS_ACTIVE	Active status
TELEPHONY_CALL_STATUS_HELD	Held status
TELEPHONY_CALL_STATUS_DIALING	Dialing status
TELEPHONY_CALL_STATUS_ALERTING	Alerting status
TELEPHONY_CALL_STATUS_INCOMING	Incoming status

enum telephony_call_type_e

Enumeration for the call type.

Since :: 3.0

Enumerator:

TELEPHONY_CALL_TYPE_VOICE	Voice call
TELEPHONY_CALL_TYPE_VIDEO	Video call
TELEPHONY_CALL_TYPE_E911	Emergency call

Function Documentation

int telephony_call_get_call_list	(	telephony_h	handle,
		unsigned int *	count,
		telephony_call_h **	call_list
	)

Gets the list of the current call.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Remarks:: You must release call_list using telephony_call_release_call_list().

Parameters:

[in]	handle	The handle from telephony_init()
[out]	count	Count of the existing calls
[out]	call_list	List of call information for existing calls

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

int telephony_call_get_conference_status	(	telephony_call_h	call_handle,
		bool *	conference_status
	)

Gets whether the call is conference call or not.

Since :: 3.0

Parameters:

[in]	call_handle	The handle from telephony_call_get_call_list()
[out]	conference_status	The value whether the call is conference call or not (true: Conference call, false: Single call)

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported

Precondition:: The call handle should be obtained from telephony_call_get_call_list().

Postcondition:: The call list should be released by using telephony_call_release_call_list().

int telephony_call_get_direction	(	telephony_call_h	call_handle,
		telephony_call_direction_e *	direction
	)

Gets whether the call is MO(Mobile Originated) call or MT(Mobile Terminated).

Since :: 3.0

Parameters:

[in]	call_handle	The handle from telephony_call_get_call_list()
[out]	direction	The direction of the call (telephony_call_direction_e)

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported

Precondition:: The call handle should be obtained from telephony_call_get_call_list().

Postcondition:: The call list should be released by using telephony_call_release_call_list().

int telephony_call_get_handle_id	(	telephony_call_h	call_handle,
		unsigned int *	handle_id
	)

Gets the call handle ID.

Since :: 3.0

Parameters:

[in]	call_handle	The handle from telephony_call_get_call_list()
[out]	handle_id	The ID of the call handle

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported

Precondition:: The call handle should be obtained from telephony_call_get_call_list().

Postcondition:: The call list should be released by using telephony_call_release_call_list().

int telephony_call_get_number	(	telephony_call_h	call_handle,
		char **	number
	)

Gets the call number.

Since :: 3.0

Remarks:: You must release number using free() on success case.

Parameters:

[in]	call_handle	The handle from telephony_call_get_call_list()
[out]	number	The number of the call

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported

Precondition:: The call handle should be obtained from telephony_call_get_call_list().

Postcondition:: The call list should be released by using telephony_call_release_call_list().

int telephony_call_get_preferred_voice_subscription	(	telephony_h	handle,
		telephony_call_preferred_voice_subs_e *	call_sub
	)

Gets the current value for the preferred voice call subscription.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Parameters:

[in]	handle	The handle from telephony_init()
[out]	call_sub	The currently set preferred call subscription value. (telephony_call_preferred_voice_subs_e)

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

int telephony_call_get_status	(	telephony_call_h	call_handle,
		telephony_call_status_e *	status
	)

Gets the call status.

Since :: 3.0

Parameters:

[in]	call_handle	The handle from telephony_call_get_call_list()
[out]	status	The status of the call (telephony_call_status_e)

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported

Precondition:: The call handle should be obtained from telephony_call_get_call_list().

Postcondition:: The call list should be released by using telephony_call_release_call_list().

int telephony_call_get_type	(	telephony_call_h	call_handle,
		telephony_call_type_e *	type
	)

Gets the call type.

Since :: 3.0

Parameters:

[in]	call_handle	The handle from telephony_call_get_call_list()
[out]	type	The type of the call (telephony_call_type_e)

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported

Precondition:: The call handle should be obtained from telephony_call_get_call_list().

Postcondition:: The call list should be released by using telephony_call_release_call_list().

int telephony_call_get_video_call_state	(	telephony_h	handle,
		telephony_call_state_e *	call_state
	)

Gets the video call state of the telephony service.

Deprecated:: Deprecated Since 3.0. Use telephony_call_get_status instead.

Determines if the video call is connecting, connected, or idle.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Remarks:: When you are dialing a number or a new video call is ringing, the state of the video call is TELEPHONY_CALL_STATE_CONNECTING. If a video call is connected, then the state of any other call cannot be TELEPHONY_CALL_STATE_CONNECTING and TELEPHONY_CALL_STATE_CONNECTED.

Parameters:

[in]	handle	The handle from telephony_init()
[out]	call_state	The current state of the video call

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

int telephony_call_get_voice_call_state	(	telephony_h	handle,
		telephony_call_state_e *	call_state
	)

Gets the voice call state of the telephony service.

Deprecated:: Deprecated Since 3.0. Use telephony_call_get_status instead.

Determines if the voice call is connecting, connected, or idle.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Remarks:: When you are dialing a number or a new voice call is ringing, the state of the voice call is TELEPHONY_CALL_STATE_CONNECTING. When a new voice call is connecting while another voice call is already connected, the state of the voice call is TELEPHONY_CALL_STATE_CONNECTING as well.

Parameters:

[in]	handle	The handle from telephony_init()
[out]	call_state	The current state of the voice call

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

int telephony_call_release_call_list	(	unsigned int	count,
		telephony_call_h **	call_list
	)

Releases the list allocated from telephony_call_get_call_list().

Since :: 3.0

Parameters:

[in]	count	The count of the calls from telephony_call_get_call_list()
[in]	call_list	The handle from telephony_call_get_call_list()

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported

Precondition:: The call list should be validated from telephony_call_get_call_list().

Required Header

Overview

Related Features

Functions

Typedefs

Typedef Documentation

Enumeration Type Documentation

Function Documentation