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 List.

Functions
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.
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.

Enumeration Type Documentation

enum telephony_call_state_e

Enumeration for the call state.

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

Function Documentation

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.

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.

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.