blob: f4d2882aabcd44ea4c82d1afb84b814b4006c6ae (
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
|
---
title: MozMobileConnection
slug: Web/API/MozMobileConnection
translation_of: Archive/B2G_OS/API/MozMobileConnection
---
<p>{{APIRef("Firefox OS")}} {{ non-standard_header() }}</p>
<p>{{ B2GOnlyHeader2('certified') }}</p>
<div class="summary">
<p><span class="seoSummary">This API is used to get information about the current mobile voice and data connection states of the device. It is accessible through {{domxref("window.navigator.mozMobileConnections","navigator.mozMobileConnections")}}, which returns an array of <code>MozMobileConnection</code> objects.</span></p>
</div>
<div class="note">
<p><strong>Note</strong>: The syntax used to be <code>window.navigator.mozMobileConnection</code>, returning a single <a href="https://developer.mozilla.org/en-US/docs/Web/API/MozMobileConnection" title="This API is used to get information about the current mobile voice and data connection states of the device. It is accessible through navigator.mozMobileConnection."><code>MozMobileConnection</code></a> object, but this was updated in Firefox 1.3 due to the introduction of Multi-SIM support (Dual-SIM-Dual-Standby or DSDS).</p>
</div>
<h2 id="Syntax" name="Syntax">Interface overview</h2>
<pre class="eval">callback EventHandler = any (Event event);
interface MozMobileConnection : EventTarget
{
const long ICC_SERVICE_CLASS_VOICE = (1 << 0);
const long ICC_SERVICE_CLASS_DATA = (1 << 1);
const long ICC_SERVICE_CLASS_FAX = (1 << 2);
const long ICC_SERVICE_CLASS_SMS = (1 << 3);
const long ICC_SERVICE_CLASS_DATA_SYNC = (1 << 4);
const long ICC_SERVICE_CLASS_DATA_ASYNC = (1 << 5);
const long ICC_SERVICE_CLASS_PACKET = (1 << 6);
const long ICC_SERVICE_CLASS_PAD = (1 << 7);
const long ICC_SERVICE_CLASS_MAX = (1 << 7);
readonly attribute MozMobileConnectionInfo voice;
readonly attribute MozMobileConnectionInfo data;
readonly attribute DOMString networkSelectionMode;
readonly attribute DOMString iccId;
DOMRequest getNetworks();
DOMRequest selectNetwork(MozMobileNetworkInfo network);
DOMRequest selectNetworkAutomatically();
DOMRequest sendMMI(DOMString mmi);
DOMRequest cancelMMI();
DOMRequest setCallForwardingOption(MozMobileCFInfo CFInfo);
DOMRequest getCallForwardingOption(unsigned short reason);
attribute EventHandler onvoicechange;
attribute EventHandler ondatachange;
attribute EventHandler onussdreceived;
attribute EventHandler ondataerror;
attribute EventHandler oncfstatechange;
};
</pre>
<h2 id="Properties">Properties</h2>
<dl>
<dt> </dt>
<dt>{{domxref("MozMobileConnection.voice")}} {{readonlyinline}}</dt>
<dd>A {{domxref("MozMobileConnectionInfo")}} object that gives access to information about the voice connection.</dd>
<dt>{{domxref("MozMobileConnection.data")}} {{readonlyinline}}</dt>
<dd>A {{domxref("MozMobileConnectionInfo")}} object that gives access to information about the data connection.</dd>
<dt>{{domxref("MozMobileConnection.iccId")}} {{readonlyinline}}</dt>
<dd>A string that indicates the Integrated Circuit Card Identifier of the SIM this mobile connection corresponds to.</dd>
<dt>{{domxref("MozMobileConnection.networkSelectionMode")}} {{readonlyinline}}</dt>
<dd>A string that indicates the selection mode of the voice and data networks.</dd>
<dt>{{domxref("MozMobileConnection.oncfstatechange")}}</dt>
<dd>A handler for the {{event("cfstatechange")}} event. This event is fired when the call forwarding state changes.</dd>
<dt>{{domxref("MozMobileConnection.ondatachange")}}</dt>
<dd>A handler for the {{event("datachange")}} event. This event is fired whenever the {{domxref("MozMobileConnection.data","data")}} connection object changes values.</dd>
<dt>{{domxref("MozMobileConnection.ondataerror")}}</dt>
<dd>A handler for the {{event("dataerror")}} event. This event is fired whenever the {{domxref("MozMobileConnection.data","data")}} connection object receive an error from the <abbr title="Radio Interface Layer">RIL</abbr>.</dd>
<dt>{{domxref("MozMobileConnection.onussdreceived")}}</dt>
<dd>A handler for the {{event("ussdreceived")}} event. This event is fired whenever a new <abbr title="Unstructured Supplementary Service Data">USSD</abbr> message is received.</dd>
<dt>{{domxref("MozMobileConnection.onvoicechange")}}</dt>
<dd>A handler for the {{event("voicechange")}} event. This event is fired whenever the {{domxref("MozMobileConnection.voice","voice")}} connection object changes.</dd>
</dl>
<h3 id="Constants">Constants</h3>
<ul>
<li><code>ICC_SERVICE_CLASS_VOICE</code></li>
<li><code>ICC_SERVICE_CLASS_DATA</code></li>
<li><code>ICC_SERVICE_CLASS_FAX</code></li>
<li><code>ICC_SERVICE_CLASS_SMS</code></li>
<li><code>ICC_SERVICE_CLASS_DATA_SYNC</code></li>
<li><code>ICC_SERVICE_CLASS_DATA_ASYNC</code></li>
<li><code>ICC_SERVICE_CLASS_PACKET</code></li>
<li><code>ICC_SERVICE_CLASS_PAD</code></li>
<li><code>ICC_SERVICE_CLASS_MAX</code></li>
</ul>
<h2 id="Methods">Methods</h2>
<div class="note">
<p><strong>Note:</strong> All original methods from the <code>MozMobileConnection</code> interface are fully asynchronous. They all return a {{domxref("DOMRequest")}} which has a <code>onsuccess</code> and <code>onerror</code> event handler to handle the success or failur of the method call.</p>
</div>
<dl>
<dt>{{domxref("MozMobileConnection.cancelMMI()")}}</dt>
<dd>Cancel the current <abbr title="Man Machine Interface">MMI</abbr> request if one exists.</dd>
<dt>{{domxref("MozMobileConnection.getCallForwardingOption()")}}</dt>
<dd>Queries current call forward options.</dd>
<dt>{{domxref("MozMobileConnection.getNetworks()")}}</dt>
<dd>Search for available networks.</dd>
<dt>{{domxref("MozMobileConnection.selectNetwork()")}}</dt>
<dd>Manually selects a network, overriding the radio's current selection.</dd>
<dt>{{domxref("MozMobileConnection.selectNetworkAutomatically()")}}</dt>
<dd>Tell the radio to automatically select a network.</dd>
<dt>{{domxref("MozMobileConnection.sendMMI()")}}</dt>
<dd>Send a <abbr title="Man Machine Interface">MMI</abbr> message.</dd>
<dt>{{domxref("MozMobileConnection.setCallForwardingOption()")}}</dt>
<dd>Configures call forward options.</dd>
</dl>
<p>The <code>MozMobileConnection</code> interface also inherit from the {{domxref("EventTarget")}} interface</p>
<p>{{page("/en-US/docs/DOM/EventTarget","Methods")}}</p>
<h2 id="Specification" name="Specification">Specification</h2>
<p>Not part of any specification</p>
<h2 id="See_also">See also</h2>
<ul>
<li>{{domxref("window.navigator.mozMobileConnection","navigator.mozMobileConnection")}}</li>
<li>{{domxref("MozMobileConnectionInfo")}}</li>
<li>{{domxref("MozIccManager")}}</li>
<li>{{domxref("MozMobileNetworkInfo")}}</li>
<li>{{domxref("MozMobileCFInfo")}}</li>
<li>{{domxref("MozMobileCellInfo")}}</li>
<li>{{domxref("EventTarget")}}</li>
</ul>
|
