blob: 5fab4b835a4fc4a175bfa823fd1145622efea298 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
# Telephony Service
## Overview
Telephony service allows respective clients access to the Handsfree Profile via the oFono package
## Verbs
| 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_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} |
## Events
| 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} |
### callStateChanged Event
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 |
|
