Telephony service allows respective clients access to the Handsfree Profile via the oFono package
| Name |
Description |
JSON Response |
| subscribe |
subscribe to telephony events |
Request: {"value": "callStateChanged"} |
| unsubscribe |
unsubscribe to telephony events |
Request: {"value": "callStateChanged"} |
| dial |
dial respective number |
Request: {"value": "15035551212"} |
| last_dial |
dial last dialed number |
|
| hangup_all |
hang up all active calls |
|
| send_tones |
send tone through the active call |
Request: {"value": "1"} |
| hangup |
hangup an active call or reject incoming call. this verb does not hang up all calls if exist more than one active call |
Request: {"id": "voicecall01"} |
| answer |
answer incoming call |
|
| hold_and_answer |
Puts the current call on hold and answers the currently waiting call |
|
| release_and_answer |
Releases currently active call and activates any currently held calls |
|
| hangup_multiparty |
Hangs up the multi-party call |
|
| create_multiparty |
Joins active and held calls together into a multi-party call |
|
| swap_calls |
Swaps Active and Held calls |
|
| get_calls |
get active call properties |
Response: {"active calls": [ {"Object Path": "/hfp/org/bluez/hci0/dev_xx_xx_xx_xx_xx_xx/voicecall01", "State": "dialing", "LineIdentification": "123456789", "Name": "", "Multiparty": false, "RemoteHeld": false, "RemoteMultiparty": false, "Emergency": false } ] } |
| get_battery_level |
getting battery level of connected phone device |
|
| get_network_registration |
getting network registration of connected phone device |
Response: {"Status": "registered","Mode": "auto-only","Name": "Irancell","Strength": 20} |
| Name |
Description |
JSON Event Data |
| callStateChanged |
Call status change event |
see callStateChanged event |
| dialingCall |
Outgoing call events |
{"colp": "3305551212"} |
| incomingCall |
Incoming call events |
{"clip": "3305551212"} |
| waitingCall |
waiting call events |
{"colp": "3305551212"} |
| terminatedCall |
Terminated call event |
empty JSON response |
| online |
Connected status of Handsfree Profile |
{"connected": true} |
| battery |
Connected status of Handsfree Profile |
{"battery level": 2} |
| signal |
Connected status of Handsfree Profile |
{"signal level": 20} |
This event has one field called parameter with one of the following states (see doc/voicecall-api.txt in oFono for further reference):
| Name |
Description |
| active |
Call is active |
| held |
Call is on hold |
| dialing |
Call is being dialed |
| alerting |
Remote party is being alerted |
| incoming |
Incoming call in progress |
| waiting |
Call is waiting |
| disconnected |
Call is disconnected |
