Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Get Started
Design and Develop
Publish
Reference
Support
Native
Skip to main content

Interface ICall

interface ICall
Extends com.amazon.apmf.IStandard Call interface

Methods

accept()

void accept()
Accept call without terminating or holding other calls on same device. After the call is successfully accepted, an IHandsfreeClientConnectionListener::onCallStateChanged() callback is triggered with the updated call state. For an incoming call, sends command to answer on phone. For waiting call with no active calls, sends command to answer on phone. In the case that there is one active call and one held call, a call to this API results in the two calls being merged. In all other existing call scenarios, this API will have no effect. Privilege: com.amazon.bluetooth.privilege.handsfree_client

acceptAndTerminateOthers()

void acceptAndTerminateOthers()
Accept call and terminate other calls on same device. After the call is successfully accepted, an IHandsfreeClientConnectionListener::onCallStateChanged() callback is triggered with the updated call states. For waiting call, sends a command to the phone to terminate active call and answer waiting call. For a held call, sends a command to the phone to terminate active call and answer the held call, otherwise does nothing. Privilege: com.amazon.bluetooth.privilege.handsfree_client

acceptAndHoldOthers()

void acceptAndHoldOthers()
Accept call and hold other calls on same device. After the call is successfully accepted, an IHandsfreeClientConnectionListener::onCallStateChanged() callback is triggered with the updated call states. For waiting call, sends a command to the phone to put active call on hold and answer waiting call. For a held call, sends a command to the phone to put active call on hold and answer held call, otherwise does nothing. Privilege: com.amazon.bluetooth.privilege.handsfree_client

hold()

void hold()
Hold an incoming or active call. After the call is successfully held, an IHandsfreeClientConnectionListener::onCallStateChanged() callback is triggered with the updated call state. The API first searches for an incoming call to place on hold. If there is no incoming call, it places the active call on hold. Privilege: com.amazon.bluetooth.privilege.handsfree_client

end()

void end()
End call. Ends specific call. After the call is successfully ended, an IHandsfreeClientConnectionListener::onCallStateChanged() callback is triggered with the updated call state. Privilege: com.amazon.bluetooth.privilege.handsfree_client

reject()

void reject()
Reject an incoming call. After the call is successfully rejected, an IHandsfreeClientConnectionListener::onCallStateChanged() callback is triggered with the updated call state. This API should only be used on WAITING or INCOMING calls. Any other usage results in an error being thrown. Privilege: com.amazon.bluetooth.privilege.handsfree_client

Throws

  • BluetoothError — if called when all is not in WAITING or INCOMING state.

isIncoming()

bool isIncoming()
Check if call is incoming.

Returns

bool Returns true if an incoming call, false otherwise.

getState()

CallState getState()
Get call state.

Returns

CallState Returns call state CallState.

getNumber()

string getNumber()
Get call number.

Returns

string Returns call number.

isMultiparty()

bool isMultiparty()
Check if call is multi-party.

Returns

bool Returns true if multi-party, false otherwise.
Last modified on October 29, 2026