summaryrefslogtreecommitdiff
path: root/introspection/org.freedesktop.ModemManager1.Call.xml
blob: 3aa6a643af4f3341745bc5a550b605c7ad8f2315 (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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
<?xml version="1.0" encoding="UTF-8" ?>

<!--
 ModemManager 1.0 Interface Specification

   Copyright (C) 2015 Marco Bascetta <marco.bascetta@sadel.it>
   Copyright (C) 2015 Riccardo Vangelisti <riccardo.vangelisti@sadel.it>
   Copyright (C) 2019 Purism SPC
-->

<node name="/" xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd">

  <!--
      org.freedesktop.ModemManager1.Call:
      @short_description: The ModemManager Call interface.

      The Call interface Defines operations and properties of a single Call.
  -->
  <interface name="org.freedesktop.ModemManager1.Call">

    <!--
        Start:

        If the outgoing call has not yet been started, start it.

        Applicable only if state is <link linkend="MM-CALL-STATE-UNKNOWN:CAPS"><constant>MM_CALL_STATE_UNKNOWN</constant></link> and direction is
        <link linkend="MM-CALL-DIRECTION-OUTGOING:CAPS"><constant>MM_CALL_DIRECTION_OUTGOING</constant></link>.

        Since: 1.6
    -->
    <method name="Start" />

    <!--
        Accept:

        Accept incoming call (answer).

        Applicable only if state is <link linkend="MM-CALL-STATE-RINGING-IN:CAPS"><constant>MM_CALL_STATE_RINGING_IN</constant></link> and direction is
        <link linkend="MM-CALL-DIRECTION-INCOMING:CAPS"><constant>MM_CALL_DIRECTION_INCOMING</constant></link>.

        Since: 1.6
    -->
    <method name="Accept" />

    <!--
        Deflect:
        @number: new number where the call will be deflected.

        Deflect an incoming or waiting call to a new number. This call will be
        considered terminated once the deflection is performed.

        Applicable only if state is <link linkend="MM-CALL-STATE-RINGING-IN:CAPS"><constant>MM_CALL_STATE_RINGING_IN</constant></link> or
        <link linkend="MM-CALL-STATE-WAITING:CAPS"><constant>MM_CALL_STATE_WAITING</constant></link> and direction is
        <link linkend="MM-CALL-DIRECTION-INCOMING:CAPS"><constant>MM_CALL_DIRECTION_INCOMING</constant></link>.

        Since: 1.12
    -->
    <method name="Deflect">
      <arg name="number" type="s" />
    </method>

    <!--
        JoinMultiparty:

        Join the currently held call into a single multiparty call with another
        already active call.

        The calls will be flagged with the
        '<link linkend="gdbus-property-org-freedesktop-ModemManager1-Call.Multiparty">Multiparty</link>'
        property while they are part of the multiparty call.

        Applicable only if state is <link linkend="MM-CALL-STATE-HELD:CAPS"><constant>MM_CALL_STATE_HELD</constant></link>.

        Since: 1.12
    -->
    <method name="JoinMultiparty" />

    <!--
        LeaveMultiparty:

        If this call is part of an ongoing multiparty call, detach it from the multiparty call,
        put the multiparty call on hold, and activate this one alone. This operation makes this
        call private again between both ends of the call.

        Applicable only if state is <link linkend="MM-CALL-STATE-ACTIVE:CAPS"><constant>MM_CALL_STATE_ACTIVE</constant></link> or
        <link linkend="MM-CALL-STATE-HELD:CAPS"><constant>MM_CALL_STATE_HELD</constant></link> and
        the call is a multiparty call.

        Since: 1.12
    -->
    <method name="LeaveMultiparty"/>

    <!--
        Hangup:

        Hangup the active call.

        Applicable only if state is <link linkend="MM-CALL-STATE-UNKNOWN:CAPS"><constant>MM_CALL_STATE_UNKNOWN</constant></link>.

        Since: 1.6
    -->
    <method name="Hangup"/>

    <!--
        SendDtmf:
        @dtmf: DTMF tone identifier [0-9A-D*#].

        Send a DTMF tone (Dual Tone Multi-Frequency) (only on supported modem).

        Applicable only if state is <link linkend="MM-CALL-STATE-ACTIVE:CAPS"><constant>MM_CALL_STATE_ACTIVE</constant></link>.

        Since: 1.6
    -->
    <method name="SendDtmf">
      <arg name="dtmf" type="s" direction="in"/>
    </method>

    <!--
        DtmfReceived:
        @dtmf: DTMF tone identifier [0-9A-D*#].

        Emitted when a DTMF tone is received (only on supported modem)

        Since: 1.6
    -->
    <signal name="DtmfReceived">
      <arg name="dtmf" type="s" />
    </signal>

    <!--
        StateChanged:
        @old: Old state MMCallState
        @new: New state MMCallState
        @reason: A <link linkend="MMCallStateReason">MMCallStateReason</link> value, specifying the reason for this state change.

        Emitted when call changes state

        Since: 1.6
    -->
    <signal name="StateChanged">
      <arg name="old" type="i" />
      <arg name="new" type="i" />
      <arg name="reason" type="u" />
    </signal>

    <!--
        State:

        A <link linkend="MMCallState">MMCallState</link> value,
        describing the state of the call.

        Since: 1.6
    -->
    <property name="State" type="i" access="read" />

    <!--
        StateReason:

        A <link linkend="MMCallStateReason">MMCallStateReason</link> value, describing why the state is changed.

        Since: 1.6
    -->
    <property name="StateReason" type="i" access="read" />

    <!--
        Direction:

        A <link linkend="MMCallDirection">MMCallDirection</link> value,
        describing the direction of the call.

        Since: 1.6
    -->
    <property name="Direction" type="i" access="read" />

    <!--
        Number:

        The remote phone number.

        Since: 1.6
    -->
    <property name="Number" type="s" access="read" />

    <!--
        Multiparty:

        Whether the call is currently part of a multiparty conference call.

        Since: 1.12
    -->
    <property name="Multiparty" type="b" access="read" />

    <!--
        AudioPort:

        If call audio is routed via the host, the name of the kernel device that
        provides the audio.  For example, with certain Huawei USB modems, this
        property might be "ttyUSB2" indicating audio is available via ttyUSB2 in
        the format described by the AudioFormat property.

        Since: 1.10
    -->
    <property name="AudioPort" type="s" access="read" />

    <!--
        AudioFormat:

        If call audio is routed via the host, a description of the audio format
        supported by the audio port.

        This property may include the following items:
        <variablelist>
          <varlistentry><term><literal>"encoding"</literal></term>
            <listitem>
              The audio encoding format.  For example, "pcm" for PCM audio.
            </listitem>
          </varlistentry>
          <varlistentry><term><literal>"resolution"</literal></term>
            <listitem>
              The sampling precision and its encoding format. For example,
              "s16le" for signed 16-bit little-endian samples.
            </listitem>
          </varlistentry>
          <varlistentry><term><literal>"rate"</literal></term>
            <listitem>
              The sampling rate as an unsigned integer.  For example, 8000 for
              8000hz.
            </listitem>
          </varlistentry>
        </variablelist>

        Since: 1.10
    -->
    <property name="AudioFormat" type="a{sv}" access="read" />
  </interface>
</node>