Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
提交 fab6c976 编写于 作者: C clevercong
浏览文件
操作

add telephony js api doc. 

Signed-off-by: Nclevercong <lichunlin2@huawei.com>
上级 fc906e11
隐藏空白更改
内联 并排
Showing with 3918 addition and 0 deletion
zh-cn/application-dev/js-reference/SIM卡管理.md 0 → 100755
浏览文件 @ fab6c976
# SIM卡管理<a name="ZH-CN_TOPIC_0000001149458512"></a>
- [导入模块](#s56d19203690d4782bfc74069abb6bd71)
- [sim.getSimIccId](#section18529027065)
- [sim.getSimIccId](#section9200164911401)
- [sim.getDefaultVoiceSlotId7+](#section3313193864611)
- [sim.getDefaultVoiceSlotId7+](#section19013665018)
- [sim.getISOCountryCodeForSim](#section1429719645712)
- [sim.getISOCountryCodeForSim](#section1087375135713)
- [sim.getSimOperatorNumeric](#section1245831911019)
- [sim.getSimOperatorNumeric](#section450711512119)
- [sim.getSimSpn](#section18826326532)
- [sim.getSimSpn](#section1862714201148)
- [sim.getSimState](#section19837481195)
- [sim.getSimState](#section1763675061914)
- [sim.getSimGid1](#section18536193963119)
- [sim.getSimGid1](#section14446155983211)
- [SimState](#section17389192625218)
>**说明：**
>
>标记7+的表示从API Version 7开始支持，未标记的表示从API Version 6开始支持。
## 导入模块<a name="s56d19203690d4782bfc74069abb6bd71"></a>
```
import sim from '@ohos.telephony.sim';
```
## sim.getSimIccId<a name="section18529027065"></a>
getSimIccId\(slotId: number, callback: AsyncCallback<string\>\): void
获取指定卡槽SIM卡的ICCID（Integrate Circuit Card Identity），使用callback方式作为异步方法。
需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。
- 参数
<a name="table799351710213"></a>
<table><thead align="left"><tr id="row1799411175217"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p899411179212"><a name="p899411179212"></a><a name="p899411179212"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p9994017112117"><a name="p9994017112117"></a><a name="p9994017112117"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p169941617192115"><a name="p169941617192115"></a><a name="p169941617192115"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p499491722118"><a name="p499491722118"></a><a name="p499491722118"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row107581022174417"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p1231917335444"><a name="p1231917335444"></a><a name="p1231917335444"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p275912223446"><a name="p275912223446"></a><a name="p275912223446"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p27599224442"><a name="p27599224442"></a><a name="p27599224442"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p111750457258"><a name="p111750457258"></a><a name="p111750457258"></a>卡槽ID。</p>
<p id="p39541754174217"><a name="p39541754174217"></a><a name="p39541754174217"></a>0：卡槽1</p>
<p id="p1016919004317"><a name="p1016919004317"></a><a name="p1016919004317"></a>1：卡槽2</p>
</td>
</tr>
<tr id="row79942177215"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p1299481713210"><a name="p1299481713210"></a><a name="p1299481713210"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p112321515195213"><a name="p112321515195213"></a><a name="p112321515195213"></a>AsyncCallback&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p1599411782114"><a name="p1599411782114"></a><a name="p1599411782114"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p10994181720215"><a name="p10994181720215"></a><a name="p10994181720215"></a>回调函数。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
sim.getSimIccId(0, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## sim.getSimIccId<a name="section9200164911401"></a>
getSimIccId\(slotId: number\): Promise<string\>
获取指定卡槽SIM卡的ICCID（Integrate Circuit Card Identity），使用Promise方式作为异步方法。
需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。
- 参数
<a name="table12755202114013"></a>
<table><thead align="left"><tr id="row167561021508"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p475616211004"><a name="p475616211004"></a><a name="p475616211004"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p157569215016"><a name="p157569215016"></a><a name="p157569215016"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p675682117012"><a name="p675682117012"></a><a name="p675682117012"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p167569211502"><a name="p167569211502"></a><a name="p167569211502"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row375616211805"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p77564211303"><a name="p77564211303"></a><a name="p77564211303"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p88212171916"><a name="p88212171916"></a><a name="p88212171916"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p175711211908"><a name="p175711211908"></a><a name="p175711211908"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p11168161813252"><a name="p11168161813252"></a><a name="p11168161813252"></a>卡槽ID。</p>
<p id="p13165516277"><a name="p13165516277"></a><a name="p13165516277"></a>0：卡槽1</p>
<p id="p31763112279"><a name="p31763112279"></a><a name="p31763112279"></a>1：卡槽2</p>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table11130132420365"></a>
<table><thead align="left"><tr id="row1213092453617"><th class="cellrowborder" valign="top" width="27.700000000000003%" id="mcps1.1.3.1.1"><p id="p191308246365"><a name="p191308246365"></a><a name="p191308246365"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="72.3%" id="mcps1.1.3.1.2"><p id="p513092453618"><a name="p513092453618"></a><a name="p513092453618"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row01311524183615"><td class="cellrowborder" valign="top" width="27.700000000000003%" headers="mcps1.1.3.1.1 "><p id="p28631116886"><a name="p28631116886"></a><a name="p28631116886"></a>Promise&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="72.3%" headers="mcps1.1.3.1.2 "><p id="p11311424123610"><a name="p11311424123610"></a><a name="p11311424123610"></a>以Promise形式返回指定卡槽的ICCID。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let promise = sim.getSimIccId(0);
promise.then(data => {
console.log(`getSimIccId success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.log(`getSimIccId fail, promise: err->${JSON.stringify(err)}`);
});
```
## sim.getDefaultVoiceSlotId<sup>7+</sup><a name="section3313193864611"></a>
getDefaultVoiceSlotId\(callback: AsyncCallback<number\>\): void<sup>7+</sup>
获取默认语音业务的卡槽ID，使用callback方式作为异步方法。
- 参数
<a name="table833910237269"></a>
<table><thead align="left"><tr id="row20339112312269"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p1533932312268"><a name="p1533932312268"></a><a name="p1533932312268"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="38.36%" id="mcps1.1.5.1.2"><p id="p1733922332612"><a name="p1733922332612"></a><a name="p1733922332612"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.209999999999999%" id="mcps1.1.5.1.3"><p id="p3339823192619"><a name="p3339823192619"></a><a name="p3339823192619"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="40.38%" id="mcps1.1.5.1.4"><p id="p3339423102617"><a name="p3339423102617"></a><a name="p3339423102617"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row43400238269"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p18340102382611"><a name="p18340102382611"></a><a name="p18340102382611"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="38.36%" headers="mcps1.1.5.1.2 "><p id="p1125151014279"><a name="p1125151014279"></a><a name="p1125151014279"></a>AsyncCallback&lt;number&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="10.209999999999999%" headers="mcps1.1.5.1.3 "><p id="p6340142310267"><a name="p6340142310267"></a><a name="p6340142310267"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="40.38%" headers="mcps1.1.5.1.4 "><p id="p19176162817"><a name="p19176162817"></a><a name="p19176162817"></a>回调函数。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
sim.getDefaultVoiceSlotId((err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## sim.getDefaultVoiceSlotId<sup>7+</sup><a name="section19013665018"></a>
getDefaultVoiceSlotId\(\): Promise<number\><sup>7+</sup>
获取默认语音业务的卡槽ID，使用Promise方式作为异步方法。
- 返回值
<a name="table5831925122216"></a>
<table><thead align="left"><tr id="row8849255224"><th class="cellrowborder" valign="top" width="27.700000000000003%" id="mcps1.1.3.1.1"><p id="p178452514225"><a name="p178452514225"></a><a name="p178452514225"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="72.3%" id="mcps1.1.3.1.2"><p id="p3841925152214"><a name="p3841925152214"></a><a name="p3841925152214"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row208482592212"><td class="cellrowborder" valign="top" width="27.700000000000003%" headers="mcps1.1.3.1.1 "><p id="p98415253228"><a name="p98415253228"></a><a name="p98415253228"></a>Promise&lt;number&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="72.3%" headers="mcps1.1.3.1.2 "><p id="p18841525112217"><a name="p18841525112217"></a><a name="p18841525112217"></a>以Promise形式返回默认语音业务的卡槽ID。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let promise = sim.getDefaultVoiceSlotId();
promise.then(data => {
console.log(`getDefaultVoiceSlotId success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.log(`getDefaultVoiceSlotId fail, promise: err->${JSON.stringify(err)}`);
});
```
## sim.getISOCountryCodeForSim<a name="section1429719645712"></a>
getISOCountryCodeForSim\(slotId: number, callback: AsyncCallback<string\>\): void
获取指定卡槽SIM卡的ISO国家码，使用callback方式作为异步方法。
- 参数
<a name="table1338013136526"></a>
<table><thead align="left"><tr id="row1638121318523"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p6381813195216"><a name="p6381813195216"></a><a name="p6381813195216"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p238121335213"><a name="p238121335213"></a><a name="p238121335213"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p17381191312526"><a name="p17381191312526"></a><a name="p17381191312526"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p6381141365218"><a name="p6381141365218"></a><a name="p6381141365218"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row163815133526"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p183811313155210"><a name="p183811313155210"></a><a name="p183811313155210"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p8381121335218"><a name="p8381121335218"></a><a name="p8381121335218"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p938110135522"><a name="p938110135522"></a><a name="p938110135522"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p109301512133912"><a name="p109301512133912"></a><a name="p109301512133912"></a>卡槽ID。</p>
<p id="p3106151812284"><a name="p3106151812284"></a><a name="p3106151812284"></a>0：卡槽1</p>
<p id="p39219204289"><a name="p39219204289"></a><a name="p39219204289"></a>1：卡槽2</p>
</td>
</tr>
<tr id="row53821913115213"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p13382201312525"><a name="p13382201312525"></a><a name="p13382201312525"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p123821313175215"><a name="p123821313175215"></a><a name="p123821313175215"></a>AsyncCallback&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p83821613165212"><a name="p83821613165212"></a><a name="p83821613165212"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p103822139529"><a name="p103822139529"></a><a name="p103822139529"></a>回调函数。返回国家码，例如：CN（中国）。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
sim.getISOCountryCodeForSim(0, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## sim.getISOCountryCodeForSim<a name="section1087375135713"></a>
getISOCountryCodeForSim\(slotId: number\): Promise<string\>
获取指定卡槽SIM卡的ISO国家码，使用Promise方式作为异步方法。
- 参数
<a name="table53861613185210"></a>
<table><thead align="left"><tr id="row1138611138529"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p10387813145211"><a name="p10387813145211"></a><a name="p10387813145211"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p16387161365211"><a name="p16387161365211"></a><a name="p16387161365211"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p14387171375217"><a name="p14387171375217"></a><a name="p14387171375217"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p83871813195220"><a name="p83871813195220"></a><a name="p83871813195220"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row038710134529"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p338712139523"><a name="p338712139523"></a><a name="p338712139523"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p193871213125217"><a name="p193871213125217"></a><a name="p193871213125217"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p9387101311525"><a name="p9387101311525"></a><a name="p9387101311525"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p8855241394"><a name="p8855241394"></a><a name="p8855241394"></a>卡槽ID。</p>
<p id="p18408326162810"><a name="p18408326162810"></a><a name="p18408326162810"></a>0：卡槽1</p>
<p id="p14944152992813"><a name="p14944152992813"></a><a name="p14944152992813"></a>1：卡槽2</p>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table101095213292"></a>
<table><thead align="left"><tr id="row1910911213290"><th class="cellrowborder" valign="top" width="27.74%" id="mcps1.1.3.1.1"><p id="p6110112122911"><a name="p6110112122911"></a><a name="p6110112122911"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="72.26%" id="mcps1.1.3.1.2"><p id="p1511072112913"><a name="p1511072112913"></a><a name="p1511072112913"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row31101126298"><td class="cellrowborder" valign="top" width="27.74%" headers="mcps1.1.3.1.1 "><p id="p14110152132916"><a name="p14110152132916"></a><a name="p14110152132916"></a>Promise&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="72.26%" headers="mcps1.1.3.1.2 "><p id="p711013292911"><a name="p711013292911"></a><a name="p711013292911"></a>以Promise形式返回获取指定卡槽SIM卡的ISO国家码，例如：CN（中国）。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let promise = sim.getISOCountryCodeForSim(0);
promise.then(data => {
console.log(`getISOCountryCodeForSim success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.log(`getISOCountryCodeForSim fail, promise: err->${JSON.stringify(err)}`);
});
```
## sim.getSimOperatorNumeric<a name="section1245831911019"></a>
getSimOperatorNumeric\(slotId: number, callback: AsyncCallback<string\>\): void
获取指定卡槽SIM卡的归属PLMN（Public Land Mobile Network）号，使用callback方式作为异步方法。
- 参数
<a name="table36924245527"></a>
<table><thead align="left"><tr id="row1469302475210"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p15693102435213"><a name="p15693102435213"></a><a name="p15693102435213"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p1769382417529"><a name="p1769382417529"></a><a name="p1769382417529"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p1769392415218"><a name="p1769392415218"></a><a name="p1769392415218"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p66931245526"><a name="p66931245526"></a><a name="p66931245526"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row146938245526"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p2693324125216"><a name="p2693324125216"></a><a name="p2693324125216"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p16693124155211"><a name="p16693124155211"></a><a name="p16693124155211"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p6693122412528"><a name="p6693122412528"></a><a name="p6693122412528"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p16957193416397"><a name="p16957193416397"></a><a name="p16957193416397"></a>卡槽ID。</p>
<p id="p82725356289"><a name="p82725356289"></a><a name="p82725356289"></a>0：卡槽1</p>
<p id="p372173862816"><a name="p372173862816"></a><a name="p372173862816"></a>1：卡槽2</p>
</td>
</tr>
<tr id="row1369332417528"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p96931324115213"><a name="p96931324115213"></a><a name="p96931324115213"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p12694162410529"><a name="p12694162410529"></a><a name="p12694162410529"></a>AsyncCallback&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p166946245524"><a name="p166946245524"></a><a name="p166946245524"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p4694142485210"><a name="p4694142485210"></a><a name="p4694142485210"></a>回调函数。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
sim.getSimOperatorNumeric(0, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## sim.getSimOperatorNumeric<a name="section450711512119"></a>
getSimOperatorNumeric\(slotId: number\): Promise<string\>
获取指定卡槽SIM卡的归属PLMN（Public Land Mobile Network）号，使用Promise方式作为异步方法。
- 参数
<a name="table66971424195211"></a>
<table><thead align="left"><tr id="row56971624155210"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p1697142418521"><a name="p1697142418521"></a><a name="p1697142418521"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p11697182485211"><a name="p11697182485211"></a><a name="p11697182485211"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p18697124195218"><a name="p18697124195218"></a><a name="p18697124195218"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p6697102415218"><a name="p6697102415218"></a><a name="p6697102415218"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1269722415213"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p269715247521"><a name="p269715247521"></a><a name="p269715247521"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p1769722435211"><a name="p1769722435211"></a><a name="p1769722435211"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p2698182415211"><a name="p2698182415211"></a><a name="p2698182415211"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p1024894853914"><a name="p1024894853914"></a><a name="p1024894853914"></a>卡槽ID。</p>
<p id="p12400194317285"><a name="p12400194317285"></a><a name="p12400194317285"></a>0：卡槽1</p>
<p id="p548124592817"><a name="p548124592817"></a><a name="p548124592817"></a>1：卡槽2</p>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table107971952142916"></a>
<table><thead align="left"><tr id="row11797752112911"><th class="cellrowborder" valign="top" width="27.74%" id="mcps1.1.3.1.1"><p id="p479735216290"><a name="p479735216290"></a><a name="p479735216290"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="72.26%" id="mcps1.1.3.1.2"><p id="p17798105212910"><a name="p17798105212910"></a><a name="p17798105212910"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1798185216299"><td class="cellrowborder" valign="top" width="27.74%" headers="mcps1.1.3.1.1 "><p id="p12798452132920"><a name="p12798452132920"></a><a name="p12798452132920"></a>Promise&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="72.26%" headers="mcps1.1.3.1.2 "><p id="p11798252142918"><a name="p11798252142918"></a><a name="p11798252142918"></a>以Promise形式返回获取指定卡槽SIM卡的归属PLMN号。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let promise = sim.getSimOperatorNumeric(0);
promise.then(data => {
console.log(`getSimOperatorNumeric success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.log(`getSimOperatorNumeric fail, promise: err->${JSON.stringify(err)}`);
});
```
## sim.getSimSpn<a name="section18826326532"></a>
getSimSpn\(slotId: number, callback: AsyncCallback<string\>\): void
获取指定卡槽SIM卡的服务提供商名称（Service Provider Name，SPN），使用callback方式作为异步方法。
- 参数
<a name="table15424192985216"></a>
<table><thead align="left"><tr id="row10424729155218"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p16424182913523"><a name="p16424182913523"></a><a name="p16424182913523"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p342482955215"><a name="p342482955215"></a><a name="p342482955215"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p5425142935212"><a name="p5425142935212"></a><a name="p5425142935212"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p54252029185215"><a name="p54252029185215"></a><a name="p54252029185215"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row16425129205213"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p4425329135210"><a name="p4425329135210"></a><a name="p4425329135210"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p16425132955212"><a name="p16425132955212"></a><a name="p16425132955212"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p1442502935219"><a name="p1442502935219"></a><a name="p1442502935219"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p149631058153912"><a name="p149631058153912"></a><a name="p149631058153912"></a>卡槽ID。</p>
<p id="p1310535019282"><a name="p1310535019282"></a><a name="p1310535019282"></a>0：卡槽1</p>
<p id="p1680115312819"><a name="p1680115312819"></a><a name="p1680115312819"></a>1：卡槽2</p>
</td>
</tr>
<tr id="row18425102919524"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p164254292525"><a name="p164254292525"></a><a name="p164254292525"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p6425192935210"><a name="p6425192935210"></a><a name="p6425192935210"></a>AsyncCallback&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p24251529135211"><a name="p24251529135211"></a><a name="p24251529135211"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p1542552915219"><a name="p1542552915219"></a><a name="p1542552915219"></a>回调函数。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
sim.getSimSpn(0, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## sim.getSimSpn<a name="section1862714201148"></a>
getSimSpn\(slotId: number\): Promise<string\>
获取指定卡槽SIM卡的服务提供商名称（Service Provider Name，SPN），使用Promise方式作为异步方法。
- 参数
<a name="table17428182905213"></a>
<table><thead align="left"><tr id="row1342912296525"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p8429202935220"><a name="p8429202935220"></a><a name="p8429202935220"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p04292295521"><a name="p04292295521"></a><a name="p04292295521"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p17429132955219"><a name="p17429132955219"></a><a name="p17429132955219"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p9429529185210"><a name="p9429529185210"></a><a name="p9429529185210"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row8429122965213"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p34291329165216"><a name="p34291329165216"></a><a name="p34291329165216"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p114291929145211"><a name="p114291929145211"></a><a name="p114291929145211"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p842912975212"><a name="p842912975212"></a><a name="p842912975212"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p1662589405"><a name="p1662589405"></a><a name="p1662589405"></a>卡槽ID。</p>
<p id="p224575932817"><a name="p224575932817"></a><a name="p224575932817"></a>0：卡槽1</p>
<p id="p1268210222917"><a name="p1268210222917"></a><a name="p1268210222917"></a>1：卡槽2</p>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table7107236143015"></a>
<table><thead align="left"><tr id="row101081836103012"><th class="cellrowborder" valign="top" width="27.74%" id="mcps1.1.3.1.1"><p id="p41081536153012"><a name="p41081536153012"></a><a name="p41081536153012"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="72.26%" id="mcps1.1.3.1.2"><p id="p121081936153019"><a name="p121081936153019"></a><a name="p121081936153019"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row151083369306"><td class="cellrowborder" valign="top" width="27.74%" headers="mcps1.1.3.1.1 "><p id="p81082036153019"><a name="p81082036153019"></a><a name="p81082036153019"></a>Promise&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="72.26%" headers="mcps1.1.3.1.2 "><p id="p11082036113014"><a name="p11082036113014"></a><a name="p11082036113014"></a>以Promise形式返回获取指定卡槽SIM卡的SPN。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let promise = sim.getSimSpn(0);
promise.then(data => {
console.log(`getSimSpn success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.log(`getSimSpn fail, promise: err->${JSON.stringify(err)}`);
});
```
## sim.getSimState<a name="section19837481195"></a>
getSimState\(slotId: number, callback: AsyncCallback<SimState\>\): void
获取指定卡槽的SIM卡状态，使用callback方式作为异步方法。
- 参数
<a name="table3741034155218"></a>
<table><thead align="left"><tr id="row5741153475215"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p1074143412527"><a name="p1074143412527"></a><a name="p1074143412527"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p374116349525"><a name="p374116349525"></a><a name="p374116349525"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p187417346522"><a name="p187417346522"></a><a name="p187417346522"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p07411434195213"><a name="p07411434195213"></a><a name="p07411434195213"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row187411634145216"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p16741173411524"><a name="p16741173411524"></a><a name="p16741173411524"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p374214340522"><a name="p374214340522"></a><a name="p374214340522"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p19742183495212"><a name="p19742183495212"></a><a name="p19742183495212"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p167256163406"><a name="p167256163406"></a><a name="p167256163406"></a>卡槽ID。</p>
<p id="p74971912299"><a name="p74971912299"></a><a name="p74971912299"></a>0：卡槽1</p>
<p id="p15870412122918"><a name="p15870412122918"></a><a name="p15870412122918"></a>1：卡槽2</p>
</td>
</tr>
<tr id="row37420349521"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p1274214346524"><a name="p1274214346524"></a><a name="p1274214346524"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p1274253465216"><a name="p1274253465216"></a><a name="p1274253465216"></a>AsyncCallback&lt;<a href="#section17389192625218">SimState</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p374210348528"><a name="p374210348528"></a><a name="p374210348528"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p167426348528"><a name="p167426348528"></a><a name="p167426348528"></a>回调函数。参考<a href="#section17389192625218">SimState</a>。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
sim.getSimState(0, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## sim.getSimState<a name="section1763675061914"></a>
getSimState\(slotId: number\): Promise<SimState\>
获取指定卡槽的SIM卡状态，使用Promise方式作为异步方法。
- 参数
<a name="table12745113465219"></a>
<table><thead align="left"><tr id="row57451334165214"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p4745183412527"><a name="p4745183412527"></a><a name="p4745183412527"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p974543414525"><a name="p974543414525"></a><a name="p974543414525"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p14745123425212"><a name="p14745123425212"></a><a name="p14745123425212"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p174543417526"><a name="p174543417526"></a><a name="p174543417526"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row11745103425211"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p147451334125212"><a name="p147451334125212"></a><a name="p147451334125212"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p1874553416527"><a name="p1874553416527"></a><a name="p1874553416527"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p15746834175211"><a name="p15746834175211"></a><a name="p15746834175211"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p37423382401"><a name="p37423382401"></a><a name="p37423382401"></a>卡槽ID。</p>
<p id="p2792112682919"><a name="p2792112682919"></a><a name="p2792112682919"></a>0：卡槽1</p>
<p id="p124241530202914"><a name="p124241530202914"></a><a name="p124241530202914"></a>1：卡槽2</p>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table152481329173113"></a>
<table><thead align="left"><tr id="row17249162917318"><th class="cellrowborder" valign="top" width="27.74%" id="mcps1.1.3.1.1"><p id="p162492291310"><a name="p162492291310"></a><a name="p162492291310"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="72.26%" id="mcps1.1.3.1.2"><p id="p8249202919312"><a name="p8249202919312"></a><a name="p8249202919312"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row8249152912315"><td class="cellrowborder" valign="top" width="27.74%" headers="mcps1.1.3.1.1 "><p id="p324972915312"><a name="p324972915312"></a><a name="p324972915312"></a>Promise&lt;<a href="#section17389192625218">SimState</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="72.26%" headers="mcps1.1.3.1.2 "><p id="p7249162973117"><a name="p7249162973117"></a><a name="p7249162973117"></a>以Promise形式<span>返回获取指定卡槽的SIM卡状态</span>。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let promise = sim.getSimState(0);
promise.then(data => {
console.log(`getSimState success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.log(`getSimState fail, promise: err->${JSON.stringify(err)}`);
});
```
## sim.getSimGid1<a name="section18536193963119"></a>
getSimGid1\(slotId: number, callback: AsyncCallback<string\>\): void
获取指定卡槽SIM卡的GID1\(Group Identifier Level 1\)，使用callback方式作为异步方法。
需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。
- 参数
<a name="table52601722175313"></a>
<table><thead align="left"><tr id="row19260152225317"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p626062211535"><a name="p626062211535"></a><a name="p626062211535"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p112601422185317"><a name="p112601422185317"></a><a name="p112601422185317"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p52611225533"><a name="p52611225533"></a><a name="p52611225533"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p1826172275316"><a name="p1826172275316"></a><a name="p1826172275316"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row726115222538"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p152617229536"><a name="p152617229536"></a><a name="p152617229536"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p2261622205312"><a name="p2261622205312"></a><a name="p2261622205312"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p726162265319"><a name="p726162265319"></a><a name="p726162265319"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p411418572423"><a name="p411418572423"></a><a name="p411418572423"></a>卡槽ID。</p>
<p id="p86321728103111"><a name="p86321728103111"></a><a name="p86321728103111"></a>0：卡槽1</p>
<p id="p147921430123118"><a name="p147921430123118"></a><a name="p147921430123118"></a>1：卡槽2</p>
</td>
</tr>
<tr id="row1626142285315"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p5261102213538"><a name="p5261102213538"></a><a name="p5261102213538"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p6261422145315"><a name="p6261422145315"></a><a name="p6261422145315"></a>AsyncCallback&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p32618225531"><a name="p32618225531"></a><a name="p32618225531"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p726142210538"><a name="p726142210538"></a><a name="p726142210538"></a>回调函数。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
sim.getSimGid1(0, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## sim.getSimGid1<a name="section14446155983211"></a>
getSimGid1\(slotId: number\): Promise<string\>
获取指定卡槽SIM卡的GID1\(Group Identifier Level 1\)，使用Promise方式作为异步方法。
需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。
- 参数
<a name="table326442215314"></a>
<table><thead align="left"><tr id="row1126572235313"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p20265152275313"><a name="p20265152275313"></a><a name="p20265152275313"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p12265222155316"><a name="p12265222155316"></a><a name="p12265222155316"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p02651122185318"><a name="p02651122185318"></a><a name="p02651122185318"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p102657221535"><a name="p102657221535"></a><a name="p102657221535"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1126515227534"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p1326532215316"><a name="p1326532215316"></a><a name="p1326532215316"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p82658227535"><a name="p82658227535"></a><a name="p82658227535"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p42651722155320"><a name="p42651722155320"></a><a name="p42651722155320"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p96421581435"><a name="p96421581435"></a><a name="p96421581435"></a>卡槽ID。</p>
<p id="p157051139103117"><a name="p157051139103117"></a><a name="p157051139103117"></a>0：卡槽1</p>
<p id="p92821426319"><a name="p92821426319"></a><a name="p92821426319"></a>1：卡槽2</p>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table293710220374"></a>
<table><thead align="left"><tr id="row15938629377"><th class="cellrowborder" valign="top" width="27.74%" id="mcps1.1.3.1.1"><p id="p169381727373"><a name="p169381727373"></a><a name="p169381727373"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="72.26%" id="mcps1.1.3.1.2"><p id="p493813211374"><a name="p493813211374"></a><a name="p493813211374"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1993811216371"><td class="cellrowborder" valign="top" width="27.74%" headers="mcps1.1.3.1.1 "><p id="p13939172173714"><a name="p13939172173714"></a><a name="p13939172173714"></a>Promise&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="72.26%" headers="mcps1.1.3.1.2 "><p id="p29391023371"><a name="p29391023371"></a><a name="p29391023371"></a>以Promise形式<span>返回</span><span>获取指定卡槽SIM卡的GID1(Group Identifier Level 1)</span>。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let promise = sim.getSimGid1(0);
promise.then(data => {
console.log(`getSimGid1 success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.log(`getSimGid1 fail, promise: err->${JSON.stringify(err)}`);
});
```
## SimState<a name="section17389192625218"></a>
SIM卡状态。
<a name="table5304315818"></a>
<table><thead align="left"><tr id="row1034431582"><th class="cellrowborder" valign="top" width="27.37%" id="mcps1.1.3.1.1"><p id="p741843988"><a name="p741843988"></a><a name="p741843988"></a>变量</p>
</th>
<th class="cellrowborder" valign="top" width="72.63%" id="mcps1.1.3.1.2"><p id="p94134310819"><a name="p94134310819"></a><a name="p94134310819"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1641643886"><td class="cellrowborder" valign="top" width="27.37%" headers="mcps1.1.3.1.1 "><p id="p341243889"><a name="p341243889"></a><a name="p341243889"></a>SIM_STATE_UNKNOWN</p>
</td>
<td class="cellrowborder" valign="top" width="72.63%" headers="mcps1.1.3.1.2 "><p id="p548431482"><a name="p548431482"></a><a name="p548431482"></a>SIM卡状态未知，即无法获取准确的状态。</p>
</td>
</tr>
<tr id="row041431811"><td class="cellrowborder" valign="top" width="27.37%" headers="mcps1.1.3.1.1 "><p id="p849431084"><a name="p849431084"></a><a name="p849431084"></a>SIM_STATE_NOT_PRESENT</p>
</td>
<td class="cellrowborder" valign="top" width="72.63%" headers="mcps1.1.3.1.2 "><p id="p19424317818"><a name="p19424317818"></a><a name="p19424317818"></a>表示SIM卡处于not present状态，即卡槽中没有插入SIM卡。</p>
</td>
</tr>
<tr id="row14413431480"><td class="cellrowborder" valign="top" width="27.37%" headers="mcps1.1.3.1.1 "><p id="p84643089"><a name="p84643089"></a><a name="p84643089"></a>SIM_STATE_LOCKED</p>
</td>
<td class="cellrowborder" valign="top" width="72.63%" headers="mcps1.1.3.1.2 "><p id="p194343083"><a name="p194343083"></a><a name="p194343083"></a>表示SIM卡处于locked状态，即SIM卡被PIN、PUK或网络锁锁定。</p>
</td>
</tr>
<tr id="row9474320819"><td class="cellrowborder" valign="top" width="27.37%" headers="mcps1.1.3.1.1 "><p id="p1641143489"><a name="p1641143489"></a><a name="p1641143489"></a>SIM_STATE_NOT_READY</p>
</td>
<td class="cellrowborder" valign="top" width="72.63%" headers="mcps1.1.3.1.2 "><p id="p155443783"><a name="p155443783"></a><a name="p155443783"></a>表示SIM卡处于not ready状态，即SIM卡在位但无法正常工作。</p>
</td>
</tr>
<tr id="row7517431188"><td class="cellrowborder" valign="top" width="27.37%" headers="mcps1.1.3.1.1 "><p id="p3512433818"><a name="p3512433818"></a><a name="p3512433818"></a>SIM_STATE_READY</p>
</td>
<td class="cellrowborder" valign="top" width="72.63%" headers="mcps1.1.3.1.2 "><p id="p165943185"><a name="p165943185"></a><a name="p165943185"></a>表示SIM卡处于ready状态，即SIM卡在位且工作正常。</p>
</td>
</tr>
<tr id="row17518431181"><td class="cellrowborder" valign="top" width="27.37%" headers="mcps1.1.3.1.1 "><p id="p3514319812"><a name="p3514319812"></a><a name="p3514319812"></a>SIM_STATE_LOADED</p>
</td>
<td class="cellrowborder" valign="top" width="72.63%" headers="mcps1.1.3.1.2 "><p id="p5512436812"><a name="p5512436812"></a><a name="p5512436812"></a>表示SIM卡处于loaded状态，即SIM卡在位且所有卡文件加载完毕。</p>
</td>
</tr>
</tbody>
</table>
\ No newline at end of file
zh-cn/application-dev/js-reference/拨打电话.md 0 → 100755
浏览文件 @ fab6c976
# 拨打电话<a name="ZH-CN_TOPIC_0000001148697292"></a>
- [导入模块](#section111401036143)
- [call.dial](#section1961259194312)
- [call.dial](#section387281814438)
- [call.dial](#section37173354913)
- [call.hasCall](#section19558123217015)
- [call.hasCall](#section12874319303)
- [call.getCallState](#section5882223124910)
- [call.getCallState](#section198597561794)
- [call.isEmergencyPhoneNumber7+](#section8560112174319)
- [call.isEmergencyPhoneNumber7+](#section9565131204319)
- [call.isEmergencyPhoneNumber7+](#section5569131234312)
- [call.formatPhoneNumber7+](#section1532018310579)
- [call.formatPhoneNumber7+](#section1832553165720)
- [call.formatPhoneNumber7+](#section1933033195716)
- [call.formatPhoneNumberToE1647+](#section10285180112418)
- [call.formatPhoneNumberToE1647+](#section142931509247)
- [DialOptions](#section12262183471518)
- [CallState](#section345181318300)
- [EmergencyNumberOptions7+](#section03689893518)
- [NumberFormatOptions7+](#section23348305716)
>**说明：**
>
>标记7+的表示从API Version 7开始支持，未标记的表示从API Version 6开始支持。
## 导入模块<a name="section111401036143"></a>
```
import call from '@ohos.telephony.call';
```
## call.dial<a name="section1961259194312"></a>
dial\(phoneNumber: string, callback: AsyncCallback<boolean\>\): void
拨打电话，使用callback方式作为异步方法。
需要权限：ohos.permission.PLACE\_CALL权限，该权限为系统权限。
- 参数
<a name="table37717572535"></a>
<table><thead align="left"><tr id="row97755715537"><th class="cellrowborder" valign="top" width="19.009999999999998%" id="mcps1.1.5.1.1"><p id="p37714572534"><a name="p37714572534"></a><a name="p37714572534"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="28.939999999999998%" id="mcps1.1.5.1.2"><p id="p277105735313"><a name="p277105735313"></a><a name="p277105735313"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.459999999999999%" id="mcps1.1.5.1.3"><p id="p377195716532"><a name="p377195716532"></a><a name="p377195716532"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="41.589999999999996%" id="mcps1.1.5.1.4"><p id="p878957125311"><a name="p878957125311"></a><a name="p878957125311"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row117810571533"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.1.5.1.1 "><p id="p1778145716538"><a name="p1778145716538"></a><a name="p1778145716538"></a>phoneNumber</p>
</td>
<td class="cellrowborder" valign="top" width="28.939999999999998%" headers="mcps1.1.5.1.2 "><p id="p1978165711532"><a name="p1978165711532"></a><a name="p1978165711532"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="10.459999999999999%" headers="mcps1.1.5.1.3 "><p id="p207815717533"><a name="p207815717533"></a><a name="p207815717533"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="41.589999999999996%" headers="mcps1.1.5.1.4 "><p id="p11781757155320"><a name="p11781757155320"></a><a name="p11781757155320"></a>电话号码。</p>
</td>
</tr>
<tr id="row185881325515"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.1.5.1.1 "><p id="p35931313554"><a name="p35931313554"></a><a name="p35931313554"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="28.939999999999998%" headers="mcps1.1.5.1.2 "><p id="p75971305516"><a name="p75971305516"></a><a name="p75971305516"></a>AsyncCallback&lt;boolean&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="10.459999999999999%" headers="mcps1.1.5.1.3 "><p id="p125951305519"><a name="p125951305519"></a><a name="p125951305519"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="41.589999999999996%" headers="mcps1.1.5.1.4 "><p id="p1276320184611"><a name="p1276320184611"></a><a name="p1276320184611"></a>回调函数：</p>
<a name="ul1468142292116"></a><a name="ul1468142292116"></a><ul id="ul1468142292116"><li>true：成功。</li><li>false：失败。</li></ul>
</td>
</tr>
</tbody>
</table>
- 示例
```
call.dial("138xxxxxxxx", (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## call.dial<a name="section387281814438"></a>
dial\(phoneNumber: string, options: DialOptions, callback: AsyncCallback<boolean\>\): void
拨打电话，可设置通话参数，使用callback方式作为异步方法。
需要权限：ohos.permission.PLACE\_CALL权限，该权限为系统权限。
- 参数
<a name="table11872418104316"></a>
<table><thead align="left"><tr id="row13873518134320"><th class="cellrowborder" valign="top" width="17.66%" id="mcps1.1.5.1.1"><p id="p1873111820437"><a name="p1873111820437"></a><a name="p1873111820437"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="28.18%" id="mcps1.1.5.1.2"><p id="p687301844313"><a name="p687301844313"></a><a name="p687301844313"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="8.06%" id="mcps1.1.5.1.3"><p id="p19873318114314"><a name="p19873318114314"></a><a name="p19873318114314"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="46.1%" id="mcps1.1.5.1.4"><p id="p1087316184438"><a name="p1087316184438"></a><a name="p1087316184438"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1587321816434"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p13873218194315"><a name="p13873218194315"></a><a name="p13873218194315"></a>phoneNumber</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p11873818114315"><a name="p11873818114315"></a><a name="p11873818114315"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p14873018194316"><a name="p14873018194316"></a><a name="p14873018194316"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p19874418104310"><a name="p19874418104310"></a><a name="p19874418104310"></a>电话号码。</p>
</td>
</tr>
<tr id="row1268000144419"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p46801407448"><a name="p46801407448"></a><a name="p46801407448"></a>options</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p206811503445"><a name="p206811503445"></a><a name="p206811503445"></a>DialOptions</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p1468111016441"><a name="p1468111016441"></a><a name="p1468111016441"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p8681200174415"><a name="p8681200174415"></a><a name="p8681200174415"></a>通话参数，参考<a href="#section12262183471518">DialOptions</a>。</p>
</td>
</tr>
<tr id="row0874181814310"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p88742018194313"><a name="p88742018194313"></a><a name="p88742018194313"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p15874718174310"><a name="p15874718174310"></a><a name="p15874718174310"></a>AsyncCallback&lt;boolean&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p11874151814438"><a name="p11874151814438"></a><a name="p11874151814438"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p2051315401127"><a name="p2051315401127"></a><a name="p2051315401127"></a>回调函数：</p>
<a name="ul7523151914208"></a><a name="ul7523151914208"></a><ul id="ul7523151914208"><li>true：成功。</li><li>false：失败。</li></ul>
</td>
</tr>
</tbody>
</table>
- 示例
```
call.dial("138xxxxxxxx", {
extras: false
}, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## call.dial<a name="section37173354913"></a>
dial\(phoneNumber: string, options?: DialOptions\): Promise<boolean\>
拨打电话，可设置通话参数，使用promise方式作为异步方法。
需要权限：ohos.permission.PLACE\_CALL权限，该权限为系统权限。
- 参数
<a name="table1170025144917"></a>
<table><thead align="left"><tr id="row14171425124919"><th class="cellrowborder" valign="top" width="19.259999999999998%" id="mcps1.1.5.1.1"><p id="p1617102513494"><a name="p1617102513494"></a><a name="p1617102513494"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="20.599999999999998%" id="mcps1.1.5.1.2"><p id="p181711025174911"><a name="p181711025174911"></a><a name="p181711025174911"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="12.35%" id="mcps1.1.5.1.3"><p id="p61711625174917"><a name="p61711625174917"></a><a name="p61711625174917"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="47.79%" id="mcps1.1.5.1.4"><p id="p181715257498"><a name="p181715257498"></a><a name="p181715257498"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row18171162511494"><td class="cellrowborder" valign="top" width="19.259999999999998%" headers="mcps1.1.5.1.1 "><p id="p617113255493"><a name="p617113255493"></a><a name="p617113255493"></a>phoneNumber</p>
</td>
<td class="cellrowborder" valign="top" width="20.599999999999998%" headers="mcps1.1.5.1.2 "><p id="p1817102504916"><a name="p1817102504916"></a><a name="p1817102504916"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="12.35%" headers="mcps1.1.5.1.3 "><p id="p3171162554917"><a name="p3171162554917"></a><a name="p3171162554917"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="47.79%" headers="mcps1.1.5.1.4 "><p id="p13171132514919"><a name="p13171132514919"></a><a name="p13171132514919"></a>电话号码。</p>
</td>
</tr>
<tr id="row1717292510494"><td class="cellrowborder" valign="top" width="19.259999999999998%" headers="mcps1.1.5.1.1 "><p id="p7172925154911"><a name="p7172925154911"></a><a name="p7172925154911"></a>options</p>
</td>
<td class="cellrowborder" valign="top" width="20.599999999999998%" headers="mcps1.1.5.1.2 "><p id="p5552285116"><a name="p5552285116"></a><a name="p5552285116"></a>DialOptions</p>
</td>
<td class="cellrowborder" valign="top" width="12.35%" headers="mcps1.1.5.1.3 "><p id="p131725254492"><a name="p131725254492"></a><a name="p131725254492"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="47.79%" headers="mcps1.1.5.1.4 "><p id="p15172625154920"><a name="p15172625154920"></a><a name="p15172625154920"></a>通话参数，参考<a href="#section12262183471518">DialOptions</a>。</p>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table1918382310112"></a>
<table><thead align="left"><tr id="row7183202315119"><th class="cellrowborder" valign="top" width="26.06%" id="mcps1.1.3.1.1"><p id="p1918414230115"><a name="p1918414230115"></a><a name="p1918414230115"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="73.94%" id="mcps1.1.3.1.2"><p id="p1918412232014"><a name="p1918412232014"></a><a name="p1918412232014"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row2184132316110"><td class="cellrowborder" valign="top" width="26.06%" headers="mcps1.1.3.1.1 "><p id="p1218415231011"><a name="p1218415231011"></a><a name="p1218415231011"></a>Promise&lt;boolean&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="73.94%" headers="mcps1.1.3.1.2 "><p id="p1218411231411"><a name="p1218411231411"></a><a name="p1218411231411"></a>以Promise形式返回拨打电话的结果。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let promise = call.dial("138xxxxxxxx", {
extras: false
});
promise.then(data => {
console.log(`dial success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.error(`dial fail, promise: err->${JSON.stringify(err)}`);
});
```
## call.hasCall<a name="section19558123217015"></a>
hasCall\(callback: AsyncCallback<boolean\>\): void
判断是否存在通话，使用callback方式作为异步方法。
- 参数
<a name="table82297481245"></a>
<table><thead align="left"><tr id="row1023013489414"><th class="cellrowborder" valign="top" width="17.66%" id="mcps1.1.5.1.1"><p id="p122303481944"><a name="p122303481944"></a><a name="p122303481944"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="28.18%" id="mcps1.1.5.1.2"><p id="p823018480414"><a name="p823018480414"></a><a name="p823018480414"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="8.06%" id="mcps1.1.5.1.3"><p id="p723013484415"><a name="p723013484415"></a><a name="p723013484415"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="46.1%" id="mcps1.1.5.1.4"><p id="p92305481844"><a name="p92305481844"></a><a name="p92305481844"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row72317481449"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p723154815414"><a name="p723154815414"></a><a name="p723154815414"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p02317481547"><a name="p02317481547"></a><a name="p02317481547"></a>AsyncCallback&lt;boolean&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p82311648043"><a name="p82311648043"></a><a name="p82311648043"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p16933172513276"><a name="p16933172513276"></a><a name="p16933172513276"></a>回调函数：</p>
<a name="ul8778181216283"></a><a name="ul8778181216283"></a><ul id="ul8778181216283"><li>true：当前存在通话。</li><li>false：当前不存在通话。</li></ul>
</td>
</tr>
</tbody>
</table>
- 示例
```
call.hasCall((err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## call.hasCall<a name="section12874319303"></a>
hasCall\(\): Promise<boolean\>
判断是否存在通话，使用Promise方式作为异步方法。
- 返回值
<a name="table1123111015394"></a>
<table><thead align="left"><tr id="row0231309398"><th class="cellrowborder" valign="top" width="26.06%" id="mcps1.1.3.1.1"><p id="p162311609398"><a name="p162311609398"></a><a name="p162311609398"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="73.94%" id="mcps1.1.3.1.2"><p id="p923118010397"><a name="p923118010397"></a><a name="p923118010397"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row82319033919"><td class="cellrowborder" valign="top" width="26.06%" headers="mcps1.1.3.1.1 "><p id="p223130143914"><a name="p223130143914"></a><a name="p223130143914"></a>Promise&lt;boolean&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="73.94%" headers="mcps1.1.3.1.2 "><p id="p15231809396"><a name="p15231809396"></a><a name="p15231809396"></a>以Promise形式异步返回判断是否存在通话。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let promise = call.hasCall();
promise.then(data => {
console.log(`hasCall success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.error(`hasCall fail, promise: err->${JSON.stringify(err)}`);
});
```
## call.getCallState<a name="section5882223124910"></a>
getCallState\(callback: AsyncCallback<CallState\>\): void
获取通话状态，使用callback方式作为异步方法。
- 参数
<a name="table640016365210"></a>
<table><thead align="left"><tr id="row11401163612219"><th class="cellrowborder" valign="top" width="17.66%" id="mcps1.1.5.1.1"><p id="p1340115368214"><a name="p1340115368214"></a><a name="p1340115368214"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="28.18%" id="mcps1.1.5.1.2"><p id="p840110366210"><a name="p840110366210"></a><a name="p840110366210"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="8.06%" id="mcps1.1.5.1.3"><p id="p240115363216"><a name="p240115363216"></a><a name="p240115363216"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="46.1%" id="mcps1.1.5.1.4"><p id="p1940116361021"><a name="p1940116361021"></a><a name="p1940116361021"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1140120361522"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p9401103618216"><a name="p9401103618216"></a><a name="p9401103618216"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p2401103617217"><a name="p2401103617217"></a><a name="p2401103617217"></a>AsyncCallback&lt;<a href="#section345181318300">CallState</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p4401036423"><a name="p4401036423"></a><a name="p4401036423"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p440103618212"><a name="p440103618212"></a><a name="p440103618212"></a>回调函数，异步返回获取到的通话状态。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
call.getCallState((err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## call.getCallState<a name="section198597561794"></a>
getCallState\(\): Promise<CallState\>
获取通话状态，使用Promise方式作为异步方法。
- 返回值
<a name="table58590561095"></a>
<table><thead align="left"><tr id="row118591561193"><th class="cellrowborder" valign="top" width="26.06%" id="mcps1.1.3.1.1"><p id="p7859056599"><a name="p7859056599"></a><a name="p7859056599"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="73.94%" id="mcps1.1.3.1.2"><p id="p085913569919"><a name="p085913569919"></a><a name="p085913569919"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row28591856299"><td class="cellrowborder" valign="top" width="26.06%" headers="mcps1.1.3.1.1 "><p id="p28631116886"><a name="p28631116886"></a><a name="p28631116886"></a>Promise&lt;<a href="#section345181318300">CallState</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="73.94%" headers="mcps1.1.3.1.2 "><p id="p1785920561591"><a name="p1785920561591"></a><a name="p1785920561591"></a>以Promise形式异步返回获取通话状态的结果。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let promise = call.getCallState();
promise.then(data => {
console.log(`getCallState success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.error(`getCallState fail, promise: err->${JSON.stringify(err)}`);
});
```
## call.isEmergencyPhoneNumber<sup>7+</sup><a name="section8560112174319"></a>
isEmergencyPhoneNumber\(phoneNumber: string, callback: AsyncCallback<boolean\>\): void
判断是否是紧急电话号码，使用callback方式作为异步方法。
- 参数
<a name="table3561612104315"></a>
<table><thead align="left"><tr id="row1856113129437"><th class="cellrowborder" valign="top" width="18.399148277197057%" id="mcps1.1.5.1.1"><p id="p756191234312"><a name="p756191234312"></a><a name="p756191234312"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="28.010065814943864%" id="mcps1.1.5.1.2"><p id="p105611512184318"><a name="p105611512184318"></a><a name="p105611512184318"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="6.775067750677508%" id="mcps1.1.5.1.3"><p id="p556131217439"><a name="p556131217439"></a><a name="p556131217439"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="46.81571815718158%" id="mcps1.1.5.1.4"><p id="p14561111294319"><a name="p14561111294319"></a><a name="p14561111294319"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row205611412144315"><td class="cellrowborder" valign="top" width="18.399148277197057%" headers="mcps1.1.5.1.1 "><p id="p18562912194314"><a name="p18562912194314"></a><a name="p18562912194314"></a>phoneNumber</p>
</td>
<td class="cellrowborder" valign="top" width="28.010065814943864%" headers="mcps1.1.5.1.2 "><p id="p16562131284317"><a name="p16562131284317"></a><a name="p16562131284317"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="6.775067750677508%" headers="mcps1.1.5.1.3 "><p id="p125621123439"><a name="p125621123439"></a><a name="p125621123439"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.81571815718158%" headers="mcps1.1.5.1.4 "><p id="p1956231274315"><a name="p1956231274315"></a><a name="p1956231274315"></a>电话号码。</p>
</td>
</tr>
<tr id="row75623121435"><td class="cellrowborder" valign="top" width="18.399148277197057%" headers="mcps1.1.5.1.1 "><p id="p185621812124310"><a name="p185621812124310"></a><a name="p185621812124310"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="28.010065814943864%" headers="mcps1.1.5.1.2 "><p id="p2056281215434"><a name="p2056281215434"></a><a name="p2056281215434"></a>AsyncCallback&lt;boolean&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="6.775067750677508%" headers="mcps1.1.5.1.3 "><p id="p7562112144311"><a name="p7562112144311"></a><a name="p7562112144311"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.81571815718158%" headers="mcps1.1.5.1.4 "><p id="p14704625153512"><a name="p14704625153512"></a><a name="p14704625153512"></a>回调函数，返回判断是否是紧急电话号码的结果：</p>
<a name="ul148351751154917"></a><a name="ul148351751154917"></a><ul id="ul148351751154917"><li>true：是紧急电话号码。</li><li>false：不是紧急电话号码。</li></ul>
</td>
</tr>
</tbody>
</table>
- 示例
```
call.isEmergencyPhoneNumber("138xxxxxxxx", (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## call.isEmergencyPhoneNumber<sup>7+</sup><a name="section9565131204319"></a>
isEmergencyPhoneNumber\(phoneNumber: string, options: EmergencyNumberOptions, callback: AsyncCallback<boolean\>\): void
判断是否是紧急电话号码，使用callback方式作为异步方法。
- 参数
<a name="table356561244318"></a>
<table><thead align="left"><tr id="row6565101294319"><th class="cellrowborder" valign="top" width="17.65%" id="mcps1.1.5.1.1"><p id="p1956541212432"><a name="p1956541212432"></a><a name="p1956541212432"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="28.189999999999998%" id="mcps1.1.5.1.2"><p id="p25651124437"><a name="p25651124437"></a><a name="p25651124437"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="8.06%" id="mcps1.1.5.1.3"><p id="p1956531210439"><a name="p1956531210439"></a><a name="p1956531210439"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="46.1%" id="mcps1.1.5.1.4"><p id="p1456531218431"><a name="p1456531218431"></a><a name="p1456531218431"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1656581284313"><td class="cellrowborder" valign="top" width="17.65%" headers="mcps1.1.5.1.1 "><p id="p8565141264311"><a name="p8565141264311"></a><a name="p8565141264311"></a>phoneNumber</p>
</td>
<td class="cellrowborder" valign="top" width="28.189999999999998%" headers="mcps1.1.5.1.2 "><p id="p856521210433"><a name="p856521210433"></a><a name="p856521210433"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p05661012194319"><a name="p05661012194319"></a><a name="p05661012194319"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p756631218431"><a name="p756631218431"></a><a name="p756631218431"></a>电话号码。</p>
</td>
</tr>
<tr id="row185660125434"><td class="cellrowborder" valign="top" width="17.65%" headers="mcps1.1.5.1.1 "><p id="p1756620123431"><a name="p1756620123431"></a><a name="p1756620123431"></a>options</p>
</td>
<td class="cellrowborder" valign="top" width="28.189999999999998%" headers="mcps1.1.5.1.2 "><p id="p185661712164316"><a name="p185661712164316"></a><a name="p185661712164316"></a>EmergencyNumberOptions</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p95660122437"><a name="p95660122437"></a><a name="p95660122437"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p15566131219439"><a name="p15566131219439"></a><a name="p15566131219439"></a>手机参数，参考<a href="#section03689893518">EmergencyNumberOptions</a>。</p>
</td>
</tr>
<tr id="row1556601211432"><td class="cellrowborder" valign="top" width="17.65%" headers="mcps1.1.5.1.1 "><p id="p35663128439"><a name="p35663128439"></a><a name="p35663128439"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="28.189999999999998%" headers="mcps1.1.5.1.2 "><p id="p16566151212434"><a name="p16566151212434"></a><a name="p16566151212434"></a>AsyncCallback&lt;boolean&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p1856618121435"><a name="p1856618121435"></a><a name="p1856618121435"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p66331949173811"><a name="p66331949173811"></a><a name="p66331949173811"></a>回调函数，返回判断是否是紧急电话号码的结果：</p>
<a name="ul131711033508"></a><a name="ul131711033508"></a><ul id="ul131711033508"><li>true：是紧急电话号码。</li><li>false：不是紧急电话号码。</li></ul>
</td>
</tr>
</tbody>
</table>
- 示例
```
call.isEmergencyPhoneNumber("112", {slotId: 1}, (err, value) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## call.isEmergencyPhoneNumber<sup>7+</sup><a name="section5569131234312"></a>
isEmergencyPhoneNumber\(phoneNumber: string, options?: EmergencyNumberOptions\): Promise<boolean\>
判断是否是紧急电话号码，使用promise方式作为异步方法。
- 参数
<a name="table456911211435"></a>
<table><thead align="left"><tr id="row10569171214431"><th class="cellrowborder" valign="top" width="19.259999999999998%" id="mcps1.1.5.1.1"><p id="p7569112164319"><a name="p7569112164319"></a><a name="p7569112164319"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="20.599999999999998%" id="mcps1.1.5.1.2"><p id="p257010121433"><a name="p257010121433"></a><a name="p257010121433"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="12.35%" id="mcps1.1.5.1.3"><p id="p557061274313"><a name="p557061274313"></a><a name="p557061274313"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="47.79%" id="mcps1.1.5.1.4"><p id="p10570181254320"><a name="p10570181254320"></a><a name="p10570181254320"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1656581284313"><td class="cellrowborder" valign="top" width="17.65%" headers="mcps1.1.5.1.1 "><p id="p8565141264311"><a name="p8565141264311"></a><a name="p8565141264311"></a>phoneNumber</p>
</td>
<td class="cellrowborder" valign="top" width="28.189999999999998%" headers="mcps1.1.5.1.2 "><p id="p856521210433"><a name="p856521210433"></a><a name="p856521210433"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p05661012194319"><a name="p05661012194319"></a><a name="p05661012194319"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p756631218431"><a name="p756631218431"></a><a name="p756631218431"></a>电话号码。</p>
</td>
</tr>
<tr id="row1571151274314"><td class="cellrowborder" valign="top" width="19.259999999999998%" headers="mcps1.1.5.1.1 "><p id="p15571512134310"><a name="p15571512134310"></a><a name="p15571512134310"></a>options</p>
</td>
<td class="cellrowborder" valign="top" width="20.599999999999998%" headers="mcps1.1.5.1.2 "><p id="p165712012204313"><a name="p165712012204313"></a><a name="p165712012204313"></a>EmergencyNumberOptions</p>
</td>
<td class="cellrowborder" valign="top" width="12.35%" headers="mcps1.1.5.1.3 "><p id="p1457151211438"><a name="p1457151211438"></a><a name="p1457151211438"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="47.79%" headers="mcps1.1.5.1.4 "><p id="p6571111219434"><a name="p6571111219434"></a><a name="p6571111219434"></a>手机参数，参考<a href="#section03689893518">EmergencyNumberOptions</a>。</p>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table1757101214316"></a>
<table><thead align="left"><tr id="row95711912194319"><th class="cellrowborder" valign="top" width="26.06%" id="mcps1.1.3.1.1"><p id="p9571612184311"><a name="p9571612184311"></a><a name="p9571612184311"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="73.94%" id="mcps1.1.3.1.2"><p id="p15716124437"><a name="p15716124437"></a><a name="p15716124437"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row14571171294316"><td class="cellrowborder" valign="top" width="26.06%" headers="mcps1.1.3.1.1 "><p id="p175711412184317"><a name="p175711412184317"></a><a name="p175711412184317"></a>Promise&lt;boolean&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="73.94%" headers="mcps1.1.3.1.2 "><p id="p17572181218439"><a name="p17572181218439"></a><a name="p17572181218439"></a>以Promise形式异步返回判断是否是紧急电话号码的结果。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let promise = call.isEmergencyPhoneNumber("138xxxxxxxx", {slotId: 1});
promise.then(data => {
console.log(`isEmergencyPhoneNumber success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.error(`isEmergencyPhoneNumber fail, promise: err->${JSON.stringify(err)}`);
});
```
## call.formatPhoneNumber<sup>7+</sup><a name="section1532018310579"></a>
formatPhoneNumber\(phoneNumber: string, callback: AsyncCallback<string\>\): void
格式化电话号码，使用callback方式作为异步方法。
- 参数
<a name="table17320153175717"></a>
<table><thead align="left"><tr id="row193205315577"><th class="cellrowborder" valign="top" width="19.009999999999998%" id="mcps1.1.5.1.1"><p id="p113201315710"><a name="p113201315710"></a><a name="p113201315710"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="28.939999999999998%" id="mcps1.1.5.1.2"><p id="p63211137575"><a name="p63211137575"></a><a name="p63211137575"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.459999999999999%" id="mcps1.1.5.1.3"><p id="p173211133571"><a name="p173211133571"></a><a name="p173211133571"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="41.589999999999996%" id="mcps1.1.5.1.4"><p id="p2032113335712"><a name="p2032113335712"></a><a name="p2032113335712"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row03216319579"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.1.5.1.1 "><p id="p193214385720"><a name="p193214385720"></a><a name="p193214385720"></a>phoneNumber</p>
</td>
<td class="cellrowborder" valign="top" width="28.939999999999998%" headers="mcps1.1.5.1.2 "><p id="p632113175715"><a name="p632113175715"></a><a name="p632113175715"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="10.459999999999999%" headers="mcps1.1.5.1.3 "><p id="p732113175714"><a name="p732113175714"></a><a name="p732113175714"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="41.589999999999996%" headers="mcps1.1.5.1.4 "><p id="p5321103115716"><a name="p5321103115716"></a><a name="p5321103115716"></a>电话号码。</p>
</td>
</tr>
<tr id="row4321193135718"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.1.5.1.1 "><p id="p133228375712"><a name="p133228375712"></a><a name="p133228375712"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="28.939999999999998%" headers="mcps1.1.5.1.2 "><p id="p132212319575"><a name="p132212319575"></a><a name="p132212319575"></a>AsyncCallback&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="10.459999999999999%" headers="mcps1.1.5.1.3 "><p id="p163226335710"><a name="p163226335710"></a><a name="p163226335710"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="41.589999999999996%" headers="mcps1.1.5.1.4 "><p id="p1732216385712"><a name="p1732216385712"></a><a name="p1732216385712"></a>回调函数，返回格式化电话号码的结果。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
call.formatPhoneNumber("138xxxxxxxx", (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## call.formatPhoneNumber<sup>7+</sup><a name="section1832553165720"></a>
formatPhoneNumber\(phoneNumber: string, options: NumberFormatOptions, callback: AsyncCallback<string\>\): void
格式化电话号码，可设置格式化参数，使用callback方式作为异步方法。
- 参数
<a name="table193251239574"></a>
<table><thead align="left"><tr id="row1032553195719"><th class="cellrowborder" valign="top" width="17.66%" id="mcps1.1.5.1.1"><p id="p53251333571"><a name="p53251333571"></a><a name="p53251333571"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="28.18%" id="mcps1.1.5.1.2"><p id="p19326193135718"><a name="p19326193135718"></a><a name="p19326193135718"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="8.06%" id="mcps1.1.5.1.3"><p id="p10326193145710"><a name="p10326193145710"></a><a name="p10326193145710"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="46.1%" id="mcps1.1.5.1.4"><p id="p123267314571"><a name="p123267314571"></a><a name="p123267314571"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row73261035576"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p3326132579"><a name="p3326132579"></a><a name="p3326132579"></a>phoneNumber</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p2326123145710"><a name="p2326123145710"></a><a name="p2326123145710"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p1932613318575"><a name="p1932613318575"></a><a name="p1932613318575"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p1232693125716"><a name="p1232693125716"></a><a name="p1232693125716"></a>电话号码。</p>
</td>
</tr>
<tr id="row13263315573"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p43261395713"><a name="p43261395713"></a><a name="p43261395713"></a>options</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p73271355710"><a name="p73271355710"></a><a name="p73271355710"></a>NumberFormatOptions</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p1832723125714"><a name="p1832723125714"></a><a name="p1832723125714"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p17327831577"><a name="p17327831577"></a><a name="p17327831577"></a>格式化参数，参考<a href="#section23348305716">NumberFormatOptions</a>。</p>
</td>
</tr>
<tr id="row16327035571"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p1132711325712"><a name="p1132711325712"></a><a name="p1132711325712"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p1432715365718"><a name="p1432715365718"></a><a name="p1432715365718"></a>AsyncCallback&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p43271432575"><a name="p43271432575"></a><a name="p43271432575"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p143271737573"><a name="p143271737573"></a><a name="p143271737573"></a>回调函数，返回格式化电话号码的结果。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
call.formatPhoneNumber("138xxxxxxxx",{
countryCode: "CN"
}, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## call.formatPhoneNumber<sup>7+</sup><a name="section1933033195716"></a>
formatPhoneNumber\(phoneNumber: string, options?: NumberFormatOptions\): Promise<string\>
格式化电话号码，可设置格式化参数，使用promise方式作为异步方法。
- 参数
<a name="table183300310578"></a>
<table><thead align="left"><tr id="row183316315578"><th class="cellrowborder" valign="top" width="19.259999999999998%" id="mcps1.1.5.1.1"><p id="p33319314570"><a name="p33319314570"></a><a name="p33319314570"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="20.599999999999998%" id="mcps1.1.5.1.2"><p id="p433193155713"><a name="p433193155713"></a><a name="p433193155713"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="12.36%" id="mcps1.1.5.1.3"><p id="p123316311576"><a name="p123316311576"></a><a name="p123316311576"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="47.78%" id="mcps1.1.5.1.4"><p id="p10331193155710"><a name="p10331193155710"></a><a name="p10331193155710"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row933113325719"><td class="cellrowborder" valign="top" width="19.259999999999998%" headers="mcps1.1.5.1.1 "><p id="p163311038579"><a name="p163311038579"></a><a name="p163311038579"></a>phoneNumber</p>
</td>
<td class="cellrowborder" valign="top" width="20.599999999999998%" headers="mcps1.1.5.1.2 "><p id="p163323312579"><a name="p163323312579"></a><a name="p163323312579"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="12.36%" headers="mcps1.1.5.1.3 "><p id="p033213305715"><a name="p033213305715"></a><a name="p033213305715"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="47.78%" headers="mcps1.1.5.1.4 "><p id="p7332531578"><a name="p7332531578"></a><a name="p7332531578"></a>电话号码。</p>
</td>
</tr>
<tr id="row633243175715"><td class="cellrowborder" valign="top" width="19.259999999999998%" headers="mcps1.1.5.1.1 "><p id="p16332133125717"><a name="p16332133125717"></a><a name="p16332133125717"></a>options</p>
</td>
<td class="cellrowborder" valign="top" width="20.599999999999998%" headers="mcps1.1.5.1.2 "><p id="p1233212315572"><a name="p1233212315572"></a><a name="p1233212315572"></a>NumberFormatOptions</p>
</td>
<td class="cellrowborder" valign="top" width="12.36%" headers="mcps1.1.5.1.3 "><p id="p153331032575"><a name="p153331032575"></a><a name="p153331032575"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="47.78%" headers="mcps1.1.5.1.4 "><p id="p133316365712"><a name="p133316365712"></a><a name="p133316365712"></a>格式化参数，参考<a href="#section23348305716">NumberFormatOptions</a>。</p>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table43332033571"></a>
<table><thead align="left"><tr id="row9333183165715"><th class="cellrowborder" valign="top" width="26.06%" id="mcps1.1.3.1.1"><p id="p23331439577"><a name="p23331439577"></a><a name="p23331439577"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="73.94%" id="mcps1.1.3.1.2"><p id="p633320345719"><a name="p633320345719"></a><a name="p633320345719"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row2033343125720"><td class="cellrowborder" valign="top" width="26.06%" headers="mcps1.1.3.1.1 "><p id="p733317335716"><a name="p733317335716"></a><a name="p733317335716"></a>Promise&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="73.94%" headers="mcps1.1.3.1.2 "><p id="p1133443125713"><a name="p1133443125713"></a><a name="p1133443125713"></a>以Promise形式异步返回格式化电话号码的结果。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let promise = call.formatPhoneNumber("138xxxxxxxx", {
countryCode: "CN"
});
promise.then(data => {
console.log(`formatPhoneNumber success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.error(`formatPhoneNumber fail, promise: err->${JSON.stringify(err)}`);
});
```
## call.formatPhoneNumberToE164<sup>7+</sup><a name="section10285180112418"></a>
formatPhoneNumberToE164\(phoneNumber: string, countryCode: string, callback: AsyncCallback<string\>\): void
将电话号码格式化为E.164表示形式，使用callback方式作为异步方法。
需要格式化的电话号码需要与传入国家码相匹配，如中国手机号需要传入国家码CN，否则格式化后的手机号为null。
支持所有国家码。
- 参数
<a name="table192869052411"></a>
<table><thead align="left"><tr id="row928613082414"><th class="cellrowborder" valign="top" width="17.66%" id="mcps1.1.5.1.1"><p id="p1328716012245"><a name="p1328716012245"></a><a name="p1328716012245"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="28.18%" id="mcps1.1.5.1.2"><p id="p6287160182414"><a name="p6287160182414"></a><a name="p6287160182414"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="8.06%" id="mcps1.1.5.1.3"><p id="p172872013241"><a name="p172872013241"></a><a name="p172872013241"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="46.1%" id="mcps1.1.5.1.4"><p id="p82877020245"><a name="p82877020245"></a><a name="p82877020245"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row112871803241"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p528717014242"><a name="p528717014242"></a><a name="p528717014242"></a>phoneNumber</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p428717082415"><a name="p428717082415"></a><a name="p428717082415"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p142872015249"><a name="p142872015249"></a><a name="p142872015249"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p528860162412"><a name="p528860162412"></a><a name="p528860162412"></a>电话号码。</p>
</td>
</tr>
<tr id="row828800102417"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p1328812042412"><a name="p1328812042412"></a><a name="p1328812042412"></a>countryCode</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p2125659164714"><a name="p2125659164714"></a><a name="p2125659164714"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p9288140112413"><a name="p9288140112413"></a><a name="p9288140112413"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p1754915382910"><a name="p1754915382910"></a><a name="p1754915382910"></a>国家码，支持所有国家码，如：中国（CN）。</p>
</td>
</tr>
<tr id="row1228890122414"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p1528813082412"><a name="p1528813082412"></a><a name="p1528813082412"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p028810102420"><a name="p028810102420"></a><a name="p028810102420"></a>AsyncCallback&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p2289505245"><a name="p2289505245"></a><a name="p2289505245"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p192897082415"><a name="p192897082415"></a><a name="p192897082415"></a>回调函数，返回将电话号码格式化为E.164表示形式的结果。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
call.formatPhoneNumberToE164("138xxxxxxxx",{
countryCode: "CN"
}, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## call.formatPhoneNumberToE164<sup>7+</sup><a name="section142931509247"></a>
formatPhoneNumberToE164\(phoneNumber: string, countryCode: string\): Promise<string\>
将电话号码格式化为E.164表示形式，使用promise方式作为异步方法。
需要格式化的手机号码需要与传入国家码相匹配，如中国手机号需要传入国家码CN，否则格式化后的手机号为null。
支持所有国家码。
- 参数
<a name="table929450172416"></a>
<table><thead align="left"><tr id="row629417018244"><th class="cellrowborder" valign="top" width="19.259999999999998%" id="mcps1.1.5.1.1"><p id="p6294140192412"><a name="p6294140192412"></a><a name="p6294140192412"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="20.599999999999998%" id="mcps1.1.5.1.2"><p id="p142951704244"><a name="p142951704244"></a><a name="p142951704244"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="12.36%" id="mcps1.1.5.1.3"><p id="p17295100192410"><a name="p17295100192410"></a><a name="p17295100192410"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="47.78%" id="mcps1.1.5.1.4"><p id="p02952012244"><a name="p02952012244"></a><a name="p02952012244"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row62951502248"><td class="cellrowborder" valign="top" width="19.259999999999998%" headers="mcps1.1.5.1.1 "><p id="p1929519042412"><a name="p1929519042412"></a><a name="p1929519042412"></a>phoneNumber</p>
</td>
<td class="cellrowborder" valign="top" width="20.599999999999998%" headers="mcps1.1.5.1.2 "><p id="p12951018248"><a name="p12951018248"></a><a name="p12951018248"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="12.36%" headers="mcps1.1.5.1.3 "><p id="p17296190132415"><a name="p17296190132415"></a><a name="p17296190132415"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="47.78%" headers="mcps1.1.5.1.4 "><p id="p02966032415"><a name="p02966032415"></a><a name="p02966032415"></a>电话号码。</p>
</td>
</tr>
<tr id="row1929620042416"><td class="cellrowborder" valign="top" width="19.259999999999998%" headers="mcps1.1.5.1.1 "><p id="p129617032419"><a name="p129617032419"></a><a name="p129617032419"></a>countryCode</p>
</td>
<td class="cellrowborder" valign="top" width="20.599999999999998%" headers="mcps1.1.5.1.2 "><p id="p22961403241"><a name="p22961403241"></a><a name="p22961403241"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="12.36%" headers="mcps1.1.5.1.3 "><p id="p179217422351"><a name="p179217422351"></a><a name="p179217422351"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="47.78%" headers="mcps1.1.5.1.4 "><p id="p172967019245"><a name="p172967019245"></a><a name="p172967019245"></a>国家码，如：中国（CN）。</p>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table029711018249"></a>
<table><thead align="left"><tr id="row429710013243"><th class="cellrowborder" valign="top" width="26.06%" id="mcps1.1.3.1.1"><p id="p162971007247"><a name="p162971007247"></a><a name="p162971007247"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="73.94%" id="mcps1.1.3.1.2"><p id="p8298109247"><a name="p8298109247"></a><a name="p8298109247"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row2298100132414"><td class="cellrowborder" valign="top" width="26.06%" headers="mcps1.1.3.1.1 "><p id="p1229819082416"><a name="p1229819082416"></a><a name="p1229819082416"></a>Promise&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="73.94%" headers="mcps1.1.3.1.2 "><p id="p329830142410"><a name="p329830142410"></a><a name="p329830142410"></a>以Promise形式异步返回将电话号码格式化为E.164表示形式的结果。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let promise = call.formatPhoneNumberToE164("138xxxxxxxx", {
countryCode: "CN"
});
promise.then(data => {
console.log(`formatPhoneNumberToE164 success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.error(`formatPhoneNumberToE164 fail, promise: err->${JSON.stringify(err)}`);
});
```
## DialOptions<a name="section12262183471518"></a>
拨打电话的可选参数。
<a name="table426533441512"></a>
<table><thead align="left"><tr id="row1626518342159"><th class="cellrowborder" valign="top" width="11.52%" id="mcps1.1.5.1.1"><p id="p178726479354"><a name="p178726479354"></a><a name="p178726479354"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="14.06%" id="mcps1.1.5.1.2"><p id="p1426519342153"><a name="p1426519342153"></a><a name="p1426519342153"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.299999999999999%" id="mcps1.1.5.1.3"><p id="p17265143471517"><a name="p17265143471517"></a><a name="p17265143471517"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="64.12%" id="mcps1.1.5.1.4"><p id="p1126583411512"><a name="p1126583411512"></a><a name="p1126583411512"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row126610344150"><td class="cellrowborder" valign="top" width="11.52%" headers="mcps1.1.5.1.1 "><p id="p010712258546"><a name="p010712258546"></a><a name="p010712258546"></a>extras</p>
</td>
<td class="cellrowborder" valign="top" width="14.06%" headers="mcps1.1.5.1.2 "><p id="p92665347159"><a name="p92665347159"></a><a name="p92665347159"></a>boolean</p>
</td>
<td class="cellrowborder" valign="top" width="10.299999999999999%" headers="mcps1.1.5.1.3 "><p id="p17266183451512"><a name="p17266183451512"></a><a name="p17266183451512"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="64.12%" headers="mcps1.1.5.1.4 "><p id="p1958121815414"><a name="p1958121815414"></a><a name="p1958121815414"></a>根据extras的值判断是否为视频通话，默认为语音通话。</p>
<a name="ul123261340174514"></a><a name="ul123261340174514"></a><ul id="ul123261340174514"><li>true：视频通话。</li><li>fasle：语音通话。</li></ul>
</td>
</tbody>
</table>
## CallState<a name="section345181318300"></a>
通话状态码。
<a name="table126934822015"></a>
<table><thead align="left"><tr id="row1369315832016"><th class="cellrowborder" valign="top" width="23.79%" id="mcps1.1.4.1.1"><p id="p1871313815402"><a name="p1871313815402"></a><a name="p1871313815402"></a>变量</p>
</th>
<th class="cellrowborder" valign="top" width="18.61%" id="mcps1.1.4.1.2"><p id="p93231392263"><a name="p93231392263"></a><a name="p93231392263"></a>值</p>
</th>
<th class="cellrowborder" valign="top" width="57.599999999999994%" id="mcps1.1.4.1.3"><p id="p145500193814"><a name="p145500193814"></a><a name="p145500193814"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row206942882013"><td class="cellrowborder" valign="top" width="23.79%" headers="mcps1.1.4.1.1 "><p id="p971155020221"><a name="p971155020221"></a><a name="p971155020221"></a>CALL_STATE_UNKNOWN</p>
</td>
<td class="cellrowborder" valign="top" width="18.61%" headers="mcps1.1.4.1.2 "><p id="p2032318912262"><a name="p2032318912262"></a><a name="p2032318912262"></a>-1</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p85619013384"><a name="p85619013384"></a><a name="p85619013384"></a>无效状态，当获取呼叫状态失败时返回。</p>
</td>
</tr>
<tr id="row116945832019"><td class="cellrowborder" valign="top" width="23.79%" headers="mcps1.1.4.1.1 "><p id="p78281110123613"><a name="p78281110123613"></a><a name="p78281110123613"></a>CALL_STATE_IDLE</p>
</td>
<td class="cellrowborder" valign="top" width="18.61%" headers="mcps1.1.4.1.2 "><p id="p10323097261"><a name="p10323097261"></a><a name="p10323097261"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p55617011389"><a name="p55617011389"></a><a name="p55617011389"></a>表示没有正在进行的呼叫。</p>
</td>
</tr>
<tr id="row253218315237"><td class="cellrowborder" valign="top" width="23.79%" headers="mcps1.1.4.1.1 "><p id="p619455134615"><a name="p619455134615"></a><a name="p619455134615"></a>CALL_STATE_RINGING</p>
</td>
<td class="cellrowborder" valign="top" width="18.61%" headers="mcps1.1.4.1.2 "><p id="p632313942617"><a name="p632313942617"></a><a name="p632313942617"></a>1</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p55610014386"><a name="p55610014386"></a><a name="p55610014386"></a>表示来电正在振铃或等待。</p>
</td>
</tr>
<tr id="row859720172311"><td class="cellrowborder" valign="top" width="23.79%" headers="mcps1.1.4.1.1 "><p id="p106062072312"><a name="p106062072312"></a><a name="p106062072312"></a>CALL_STATE_OFFHOOK</p>
</td>
<td class="cellrowborder" valign="top" width="18.61%" headers="mcps1.1.4.1.2 "><p id="p1432310992611"><a name="p1432310992611"></a><a name="p1432310992611"></a>2</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p16572083814"><a name="p16572083814"></a><a name="p16572083814"></a>表示至少有一个呼叫处于拨号、通话中或呼叫保持状态，并且没有新的来电振铃或等待。</p>
</td>
</tr>
</tbody>
</table>
## EmergencyNumberOptions<sup>7+</sup><a name="section03689893518"></a>
判断是否是紧急电话号码的可选参数。
<a name="table16368168133516"></a>
<table><thead align="left"><tr id="row1736813813513"><th class="cellrowborder" valign="top" width="11.52%" id="mcps1.1.5.1.1"><p id="p153686819354"><a name="p153686819354"></a><a name="p153686819354"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="14.06%" id="mcps1.1.5.1.2"><p id="p113698823512"><a name="p113698823512"></a><a name="p113698823512"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.299999999999999%" id="mcps1.1.5.1.3"><p id="p7369188183517"><a name="p7369188183517"></a><a name="p7369188183517"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="64.12%" id="mcps1.1.5.1.4"><p id="p17369118123514"><a name="p17369118123514"></a><a name="p17369118123514"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row13696810352"><td class="cellrowborder" valign="top" width="11.52%" headers="mcps1.1.5.1.1 "><p id="p2036911812355"><a name="p2036911812355"></a><a name="p2036911812355"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="14.06%" headers="mcps1.1.5.1.2 "><p id="p63691085356"><a name="p63691085356"></a><a name="p63691085356"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.299999999999999%" headers="mcps1.1.5.1.3 "><p id="p036938163510"><a name="p036938163510"></a><a name="p036938163510"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="64.12%" headers="mcps1.1.5.1.4 "><p id="p111750457258"><a name="p111750457258"></a><a name="p111750457258"></a>卡槽ID：</p>
<a name="ul134537519529"></a><a name="ul134537519529"></a><ul id="ul134537519529"><li>0：卡槽1。</li><li>1：卡槽2。</li></ul>
</td>
</tr>
</tbody>
</table>
## NumberFormatOptions<sup>7+</sup><a name="section23348305716"></a>
格式化号码的可选参数。
<a name="table13344318576"></a>
<table><thead align="left"><tr id="row53356315717"><th class="cellrowborder" valign="top" width="13.489999999999998%" id="mcps1.1.5.1.1"><p id="p8335536577"><a name="p8335536577"></a><a name="p8335536577"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="12.09%" id="mcps1.1.5.1.2"><p id="p203357395714"><a name="p203357395714"></a><a name="p203357395714"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.299999999999999%" id="mcps1.1.5.1.3"><p id="p23355355711"><a name="p23355355711"></a><a name="p23355355711"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="64.12%" id="mcps1.1.5.1.4"><p id="p63359315715"><a name="p63359315715"></a><a name="p63359315715"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row5335183165719"><td class="cellrowborder" valign="top" width="13.489999999999998%" headers="mcps1.1.5.1.1 "><p id="p733573105712"><a name="p733573105712"></a><a name="p733573105712"></a>countryCode</p>
</td>
<td class="cellrowborder" valign="top" width="12.09%" headers="mcps1.1.5.1.2 "><p id="p3335735578"><a name="p3335735578"></a><a name="p3335735578"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="10.299999999999999%" headers="mcps1.1.5.1.3 "><p id="p73353313575"><a name="p73353313575"></a><a name="p73353313575"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="64.12%" headers="mcps1.1.5.1.4 "><p id="p16200121925613"><a name="p16200121925613"></a><a name="p16200121925613"></a>国家码，支持所有国家的国家码，如：中国（CN），默认为：CN。</p>
</td>
</tr>
</tbody>
</table>
\ No newline at end of file
zh-cn/application-dev/js-reference/短信发送.md 0 → 100755
浏览文件 @ fab6c976
# 短信服务<a name="ZH-CN_TOPIC_0000001150660760"></a>
- [导入模块](#section111401036143)
- [sms.createMessage](#section3831173019331)
- [sms.createMessage](#section9796242123511)
- [sms.sendMessage](#section128401423810)
- [sms.getDefaultSmsSlotId7+](#section46193383478)
- [sms.getDefaultSmsSlotId7+](#section19981626114817)
- [sms.setSmscAddr7+](#section155849574485)
- [sms.setSmscAddr7+](#section7801426144910)
- [sms.getSmscAddr7+](#section347174613494)
- [sms.getSmscAddr7+](#section1178428175016)
- [ShortMessage](#section345181318300)
- [ShortMessageClass](#section141712166453)
- [SendMessageOptions](#section12262183471518)
- [ISendShortMessageCallback](#section16646146115317)
- [IDeliveryShortMessageCallback](#section12183749531)
- [SendSmsResult](#section13290132311575)
>**说明：**
>
>标记7+的表示从API Version 7开始支持，未标记的表示从API Version 6开始支持。
## 导入模块<a name="section111401036143"></a>
```
import sms from '@ohos.telephony.sms';
```
## sms.createMessage<a name="section3831173019331"></a>
createMessage\(pdu: Array<number\>, specification: string, callback: AsyncCallback<ShortMessage\>\): void
根据协议数据单元（PDU）和指定的短信协议创建短信实例，使用callback方式作为异步方法。
- 参数
<a name="table11872418104316"></a>
<table><thead align="left"><tr id="row13873518134320"><th class="cellrowborder" valign="top" width="15.53%" id="mcps1.1.5.1.1"><p id="p1873111820437"><a name="p1873111820437"></a><a name="p1873111820437"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="31.47%" id="mcps1.1.5.1.2"><p id="p687301844313"><a name="p687301844313"></a><a name="p687301844313"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="6.9%" id="mcps1.1.5.1.3"><p id="p19873318114314"><a name="p19873318114314"></a><a name="p19873318114314"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="46.1%" id="mcps1.1.5.1.4"><p id="p1087316184438"><a name="p1087316184438"></a><a name="p1087316184438"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1587321816434"><td class="cellrowborder" valign="top" width="15.53%" headers="mcps1.1.5.1.1 "><p id="p13873218194315"><a name="p13873218194315"></a><a name="p13873218194315"></a>pdu</p>
</td>
<td class="cellrowborder" valign="top" width="31.47%" headers="mcps1.1.5.1.2 "><p id="p11873818114315"><a name="p11873818114315"></a><a name="p11873818114315"></a>Array&lt;number&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="6.9%" headers="mcps1.1.5.1.3 "><p id="p14873018194316"><a name="p14873018194316"></a><a name="p14873018194316"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p19874418104310"><a name="p19874418104310"></a><a name="p19874418104310"></a>协议数据单元，从收到的信息中获取。</p>
</td>
</tr>
<tr id="row1268000144419"><td class="cellrowborder" valign="top" width="15.53%" headers="mcps1.1.5.1.1 "><p id="p46801407448"><a name="p46801407448"></a><a name="p46801407448"></a>specification</p>
</td>
<td class="cellrowborder" valign="top" width="31.47%" headers="mcps1.1.5.1.2 "><p id="p206811503445"><a name="p206811503445"></a><a name="p206811503445"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="6.9%" headers="mcps1.1.5.1.3 "><p id="p1468111016441"><a name="p1468111016441"></a><a name="p1468111016441"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p041710431522"><a name="p041710431522"></a><a name="p041710431522"></a>短信协议类型。</p>
<a name="ul331674955216"></a><a name="ul331674955216"></a><ul id="ul331674955216"><li>3gpp表示GSM/UMTS/LTE SMS</li><li>3gpp2表示CDMA SMS</li></ul>
</td>
</tr>
<tr id="row0874181814310"><td class="cellrowborder" valign="top" width="15.53%" headers="mcps1.1.5.1.1 "><p id="p88742018194313"><a name="p88742018194313"></a><a name="p88742018194313"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="31.47%" headers="mcps1.1.5.1.2 "><p id="p15874718174310"><a name="p15874718174310"></a><a name="p15874718174310"></a>AsyncCallback&lt;<a href="#section345181318300">ShortMessage</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="6.9%" headers="mcps1.1.5.1.3 "><p id="p11874151814438"><a name="p11874151814438"></a><a name="p11874151814438"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p16874618124315"><a name="p16874618124315"></a><a name="p16874618124315"></a>回调函数。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let specification = '3gpp';
let pdu = [0x08, 0x91, ...];
sms.createMessage(pdu, specification, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## sms.createMessage<a name="section9796242123511"></a>
createMessage\(pdu: Array<number\>, specification: string\): Promise<ShortMessage\>
根据协议数据单元（PDU）和指定的短信协议创建短信实例，使用Promise方式作为异步方法。
- 参数
<a name="table1435974516216"></a>
<table><thead align="left"><tr id="row1235934514212"><th class="cellrowborder" valign="top" width="17.66%" id="mcps1.1.5.1.1"><p id="p635914451725"><a name="p635914451725"></a><a name="p635914451725"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="28.18%" id="mcps1.1.5.1.2"><p id="p12359154517217"><a name="p12359154517217"></a><a name="p12359154517217"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="8.06%" id="mcps1.1.5.1.3"><p id="p113593454216"><a name="p113593454216"></a><a name="p113593454216"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="46.1%" id="mcps1.1.5.1.4"><p id="p15359154514213"><a name="p15359154514213"></a><a name="p15359154514213"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row8359104519214"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p143596451823"><a name="p143596451823"></a><a name="p143596451823"></a>pdu</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p6359104512212"><a name="p6359104512212"></a><a name="p6359104512212"></a>Array&lt;number&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p936013452211"><a name="p936013452211"></a><a name="p936013452211"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p1436004511214"><a name="p1436004511214"></a><a name="p1436004511214"></a>协议数据单元，从收到的信息中获取。</p>
</td>
</tr>
<tr id="row63606450217"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p2036011451325"><a name="p2036011451325"></a><a name="p2036011451325"></a>specification</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p18360164515210"><a name="p18360164515210"></a><a name="p18360164515210"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p83600454219"><a name="p83600454219"></a><a name="p83600454219"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p758422312366"><a name="p758422312366"></a><a name="p758422312366"></a>短信协议类型。</p>
<a name="ul178213302362"></a><a name="ul178213302362"></a><ul id="ul178213302362"><li>3gpp表示GSM/UMTS/LTE SMS</li><li>3gpp2表示CDMA SMS</li></ul>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table1918382310112"></a>
<table><thead align="left"><tr id="row7183202315119"><th class="cellrowborder" valign="top" width="26.06%" id="mcps1.1.3.1.1"><p id="p1918414230115"><a name="p1918414230115"></a><a name="p1918414230115"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="73.94%" id="mcps1.1.3.1.2"><p id="p1918412232014"><a name="p1918412232014"></a><a name="p1918412232014"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row2184132316110"><td class="cellrowborder" valign="top" width="26.06%" headers="mcps1.1.3.1.1 "><p id="p1218415231011"><a name="p1218415231011"></a><a name="p1218415231011"></a>Promise&lt;<a href="#section345181318300">ShortMessage</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="73.94%" headers="mcps1.1.3.1.2 "><p id="p1218411231411"><a name="p1218411231411"></a><a name="p1218411231411"></a>以Promise形式返回创建的短信实例。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let specification = '3gpp';
let pdu = [0x08, 0x91, ...];
let promise = sms.createMessage(pdu, specification);
promise.then(data => {
console.log(`createMessage success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.error(`createMessage fail, promise: err->${JSON.stringify(err)}`);
});
```
## sms.sendMessage<a name="section128401423810"></a>
sendMessage\(options: SendMessageOptions\): void
发送短信。
需要ohos.permission.SEND\_MESSAGES权限。
- 参数
<a name="table1170025144917"></a>
<table><thead align="left"><tr id="row14171425124919"><th class="cellrowborder" valign="top" width="19.259999999999998%" id="mcps1.1.5.1.1"><p id="p1617102513494"><a name="p1617102513494"></a><a name="p1617102513494"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="20.599999999999998%" id="mcps1.1.5.1.2"><p id="p181711025174911"><a name="p181711025174911"></a><a name="p181711025174911"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="12.36%" id="mcps1.1.5.1.3"><p id="p61711625174917"><a name="p61711625174917"></a><a name="p61711625174917"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="47.78%" id="mcps1.1.5.1.4"><p id="p181715257498"><a name="p181715257498"></a><a name="p181715257498"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1717292510494"><td class="cellrowborder" valign="top" width="19.259999999999998%" headers="mcps1.1.5.1.1 "><p id="p7172925154911"><a name="p7172925154911"></a><a name="p7172925154911"></a>options</p>
</td>
<td class="cellrowborder" valign="top" width="20.599999999999998%" headers="mcps1.1.5.1.2 "><p id="p5552285116"><a name="p5552285116"></a><a name="p5552285116"></a><a href="#section12262183471518">SendMessageOptions</a></p>
</td>
<td class="cellrowborder" valign="top" width="12.36%" headers="mcps1.1.5.1.3 "><p id="p131725254492"><a name="p131725254492"></a><a name="p131725254492"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="47.78%" headers="mcps1.1.5.1.4 "><p id="p15172625154920"><a name="p15172625154920"></a><a name="p15172625154920"></a>发送短信的参数和回调，参考<a href="#section12262183471518">SendMessageOptions</a>。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let sendCallback = function (err, data) {
console.log(`sendCallback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
}
let deliveryCallback = function (err, data) {
console.log(`deliveryCallback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
}
let slotId = 0;
let content = '短信内容';
let destinationHost = '+861xxxxxxxxxx';
let serviceCenter = '+861xxxxxxxxxx';
let destinationPort = 1000;
let options = {slotId, content, destinationHost, serviceCenter, destinationPort, sendCallback, deliveryCallback};
sms.sendMessage(options);
```
## sms.getDefaultSmsSlotId<sup>7+</sup><a name="section46193383478"></a>
getDefaultSmsSlotId\(callback: AsyncCallback<number\>\): void
获取发送短信的默认SIM卡槽ID，使用callback方式作为异步方法。
- 参数
<a name="table640016365210"></a>
<table><thead align="left"><tr id="row11401163612219"><th class="cellrowborder" valign="top" width="17.66%" id="mcps1.1.5.1.1"><p id="p1340115368214"><a name="p1340115368214"></a><a name="p1340115368214"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="28.18%" id="mcps1.1.5.1.2"><p id="p840110366210"><a name="p840110366210"></a><a name="p840110366210"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="8.06%" id="mcps1.1.5.1.3"><p id="p240115363216"><a name="p240115363216"></a><a name="p240115363216"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="46.1%" id="mcps1.1.5.1.4"><p id="p1940116361021"><a name="p1940116361021"></a><a name="p1940116361021"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1140120361522"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p9401103618216"><a name="p9401103618216"></a><a name="p9401103618216"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p2401103617217"><a name="p2401103617217"></a><a name="p2401103617217"></a>AsyncCallback&lt;number&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p4401036423"><a name="p4401036423"></a><a name="p4401036423"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p440103618212"><a name="p440103618212"></a><a name="p440103618212"></a>回调函数。</p>
<a name="ul9211219141510"></a><a name="ul9211219141510"></a><ul id="ul9211219141510"><li>0：卡槽1</li><li>1：卡槽2</li></ul>
</td>
</tr>
</tbody>
</table>
- 示例
```
sms.getDefaultSmsSlotId((err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## sms.getDefaultSmsSlotId<sup>7+</sup><a name="section19981626114817"></a>
getDefaultSmsSlotId\(\): Promise<number\>
获取发送短信的默认SIM卡槽ID，使用Promise方式作为异步方法。
- 返回值
<a name="table58590561095"></a>
<table><thead align="left"><tr id="row118591561193"><th class="cellrowborder" valign="top" width="26.06%" id="mcps1.1.3.1.1"><p id="p7859056599"><a name="p7859056599"></a><a name="p7859056599"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="73.94%" id="mcps1.1.3.1.2"><p id="p085913569919"><a name="p085913569919"></a><a name="p085913569919"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row28591856299"><td class="cellrowborder" valign="top" width="26.06%" headers="mcps1.1.3.1.1 "><p id="p28631116886"><a name="p28631116886"></a><a name="p28631116886"></a>Promise&lt;number&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="73.94%" headers="mcps1.1.3.1.2 "><p id="p1785920561591"><a name="p1785920561591"></a><a name="p1785920561591"></a>以Promise形式返回发送短信的默认SIM卡：</p>
<a name="ul297310284152"></a><a name="ul297310284152"></a><ul id="ul297310284152"><li>0：卡槽1</li><li>1：卡槽2</li></ul>
</td>
</tr>
</tbody>
</table>
- 示例
```
let promise = call.getDefaultSmsSlotId();
promise.then(data => {
console.log(`getDefaultSmsSlotId success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.error(`getDefaultSmsSlotId fail, promise: err->${JSON.stringify(err)}`);
});
```
## sms.setSmscAddr<sup>7+</sup><a name="section155849574485"></a>
setSmscAddr\(slotId: number, smscAddr: string, callback: AsyncCallback<void\>\): void
设置短信服务中心（SMSC）地址，使用callback方式作为异步方法。
需要ohos.permission.SET\_TELEPHONY\_STATE权限，该权限为系统权限。
- 参数
<a name="table16426938237"></a>
<table><thead align="left"><tr id="row94271538039"><th class="cellrowborder" valign="top" width="17.66%" id="mcps1.1.5.1.1"><p id="p12427738837"><a name="p12427738837"></a><a name="p12427738837"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="28.18%" id="mcps1.1.5.1.2"><p id="p104274381133"><a name="p104274381133"></a><a name="p104274381133"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="8.06%" id="mcps1.1.5.1.3"><p id="p24274381834"><a name="p24274381834"></a><a name="p24274381834"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="46.1%" id="mcps1.1.5.1.4"><p id="p3427738938"><a name="p3427738938"></a><a name="p3427738938"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row184651552734"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p546614524317"><a name="p546614524317"></a><a name="p546614524317"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p104661852439"><a name="p104661852439"></a><a name="p104661852439"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p1635101510417"><a name="p1635101510417"></a><a name="p1635101510417"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p34931544121518"><a name="p34931544121518"></a><a name="p34931544121518"></a>SIM卡槽ID：</p>
<a name="ul3493164411516"></a><a name="ul3493164411516"></a><ul id="ul3493164411516"><li>0：卡槽1</li><li>1：卡槽2</li></ul>
</td>
</tr>
<tr id="row8924552151"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p119251252255"><a name="p119251252255"></a><a name="p119251252255"></a>smscAddr</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p129253521658"><a name="p129253521658"></a><a name="p129253521658"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p8958171314615"><a name="p8958171314615"></a><a name="p8958171314615"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p14925352154"><a name="p14925352154"></a><a name="p14925352154"></a>短信服务中心地址。</p>
</td>
</tr>
<tr id="row4427938632"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p64275383316"><a name="p64275383316"></a><a name="p64275383316"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p11427183811320"><a name="p11427183811320"></a><a name="p11427183811320"></a>AsyncCallback&lt;void&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p20427238435"><a name="p20427238435"></a><a name="p20427238435"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p174278382318"><a name="p174278382318"></a><a name="p174278382318"></a>回调函数。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let slotId = 0;
let smscAddr = '+861xxxxxxxxxx';
sms.setSmscAddr(slotId, smscAddr, (err,data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## sms.setSmscAddr<sup>7+</sup><a name="section7801426144910"></a>
setSmscAddr\(slotId: number, smscAddr: string\): Promise<void\>
设置短信服务中心（SMSC）地址，使用Promise方式作为异步方法。
需要ohos.permission.SET\_TELEPHONY\_STATE权限，该权限为系统权限。
- 参数
<a name="table1859188171115"></a>
<table><thead align="left"><tr id="row9592801111"><th class="cellrowborder" valign="top" width="17.66%" id="mcps1.1.5.1.1"><p id="p115948161111"><a name="p115948161111"></a><a name="p115948161111"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="28.18%" id="mcps1.1.5.1.2"><p id="p1598881115"><a name="p1598881115"></a><a name="p1598881115"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="8.06%" id="mcps1.1.5.1.3"><p id="p25948131119"><a name="p25948131119"></a><a name="p25948131119"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="46.1%" id="mcps1.1.5.1.4"><p id="p55910812119"><a name="p55910812119"></a><a name="p55910812119"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row155911811114"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p105912821114"><a name="p105912821114"></a><a name="p105912821114"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p16014811114"><a name="p16014811114"></a><a name="p16014811114"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p96078111114"><a name="p96078111114"></a><a name="p96078111114"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p11572145614159"><a name="p11572145614159"></a><a name="p11572145614159"></a>SIM卡槽ID：</p>
<a name="ul1357255618156"></a><a name="ul1357255618156"></a><ul id="ul1357255618156"><li>0：卡槽1</li><li>1：卡槽2</li></ul>
</td>
</tr>
<tr id="row66015813112"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p106014821119"><a name="p106014821119"></a><a name="p106014821119"></a>smscAddr</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p66088151118"><a name="p66088151118"></a><a name="p66088151118"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p1860208141117"><a name="p1860208141117"></a><a name="p1860208141117"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p1760108101119"><a name="p1760108101119"></a><a name="p1760108101119"></a>短信服务中心地址。</p>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table119691243144714"></a>
<table><thead align="left"><tr id="row096954364719"><th class="cellrowborder" valign="top" width="26.69%" id="mcps1.1.3.1.1"><p id="p897019436475"><a name="p897019436475"></a><a name="p897019436475"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="73.31%" id="mcps1.1.3.1.2"><p id="p16970114344720"><a name="p16970114344720"></a><a name="p16970114344720"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row16970443194710"><td class="cellrowborder" valign="top" width="26.69%" headers="mcps1.1.3.1.1 "><p id="p19970343174717"><a name="p19970343174717"></a><a name="p19970343174717"></a>Promise&lt;void&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="73.31%" headers="mcps1.1.3.1.2 "><p id="p169703434472"><a name="p169703434472"></a><a name="p169703434472"></a>以Promise形式异步返回设置结果。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let slotId = 0;
let smscAddr = '+861xxxxxxxxxx';
let promise = sms.setSmscAddr(slotId, smscAddr);
promise.then(data => {
console.log(`setSmscAddr success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.error(`setSmscAddr fail, promise: err->${JSON.stringify(err)}`);
});
```
## sms.getSmscAddr<sup>7+</sup><a name="section347174613494"></a>
getSmscAddr\(slotId: number, callback: AsyncCallback<string\>\): void
获取短信服务中心（SMSC）地址，使用callback方式作为异步方法。
需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。
- 参数
<a name="table1688918415185"></a>
<table><thead align="left"><tr id="row108899481812"><th class="cellrowborder" valign="top" width="17.66%" id="mcps1.1.5.1.1"><p id="p10889242180"><a name="p10889242180"></a><a name="p10889242180"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="28.18%" id="mcps1.1.5.1.2"><p id="p13889142181"><a name="p13889142181"></a><a name="p13889142181"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="8.06%" id="mcps1.1.5.1.3"><p id="p089019419181"><a name="p089019419181"></a><a name="p089019419181"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="46.1%" id="mcps1.1.5.1.4"><p id="p48901943187"><a name="p48901943187"></a><a name="p48901943187"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1789084151812"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p16890124201811"><a name="p16890124201811"></a><a name="p16890124201811"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p138907411185"><a name="p138907411185"></a><a name="p138907411185"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p789064191816"><a name="p789064191816"></a><a name="p789064191816"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p1085441121615"><a name="p1085441121615"></a><a name="p1085441121615"></a>SIM卡槽ID：</p>
<a name="ul285420116165"></a><a name="ul285420116165"></a><ul id="ul285420116165"><li>0：卡槽1</li><li>1：卡槽2</li></ul>
</td>
</tr>
<tr id="row18906441819"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p78915410183"><a name="p78915410183"></a><a name="p78915410183"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p1789116417184"><a name="p1789116417184"></a><a name="p1789116417184"></a>AsyncCallback&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p108912047185"><a name="p108912047185"></a><a name="p108912047185"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p188916414188"><a name="p188916414188"></a><a name="p188916414188"></a>回调函数。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let slotId = 0;
sms.getSmscAddr(slotId, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## sms.getSmscAddr<sup>7+</sup><a name="section1178428175016"></a>
getSmscAddr\(slotId: number\): Promise<string\>
获取短信服务中心（SMSC）地址，使用Promise方式作为异步方法。
需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。
- 参数
<a name="table789120415189"></a>
<table><thead align="left"><tr id="row18924416186"><th class="cellrowborder" valign="top" width="17.66%" id="mcps1.1.5.1.1"><p id="p38921346181"><a name="p38921346181"></a><a name="p38921346181"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="28.18%" id="mcps1.1.5.1.2"><p id="p78924412188"><a name="p78924412188"></a><a name="p78924412188"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="8.06%" id="mcps1.1.5.1.3"><p id="p1789211412185"><a name="p1789211412185"></a><a name="p1789211412185"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="46.1%" id="mcps1.1.5.1.4"><p id="p16892104181816"><a name="p16892104181816"></a><a name="p16892104181816"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1892643184"><td class="cellrowborder" valign="top" width="17.66%" headers="mcps1.1.5.1.1 "><p id="p12892184171813"><a name="p12892184171813"></a><a name="p12892184171813"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="28.18%" headers="mcps1.1.5.1.2 "><p id="p989215451810"><a name="p989215451810"></a><a name="p989215451810"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="8.06%" headers="mcps1.1.5.1.3 "><p id="p1889217491813"><a name="p1889217491813"></a><a name="p1889217491813"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="p8956122311162"><a name="p8956122311162"></a><a name="p8956122311162"></a>SIM卡槽ID：</p>
<a name="ul1495632314162"></a><a name="ul1495632314162"></a><ul id="ul1495632314162"><li>0：卡槽1</li><li>1：卡槽2</li></ul>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table989334161814"></a>
<table><thead align="left"><tr id="row198934419185"><th class="cellrowborder" valign="top" width="26.06%" id="mcps1.1.3.1.1"><p id="p1889312413181"><a name="p1889312413181"></a><a name="p1889312413181"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="73.94%" id="mcps1.1.3.1.2"><p id="p1389316413180"><a name="p1389316413180"></a><a name="p1389316413180"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1789312451812"><td class="cellrowborder" valign="top" width="26.06%" headers="mcps1.1.3.1.1 "><p id="p1893134121818"><a name="p1893134121818"></a><a name="p1893134121818"></a>Promise&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="73.94%" headers="mcps1.1.3.1.2 "><p id="p68944416186"><a name="p68944416186"></a><a name="p68944416186"></a>以Promise形式返回获取短信服务中心地址的结果。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let slotId = 0;
let promise = sms.getSmscAddr(slotId);
promise.then(data => {
console.log(`getSmscAddr success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.error(`getSmscAddr fail, promise: err->${JSON.stringify(err)}`);
});
```
## ShortMessage<a name="section345181318300"></a>
短信实例
<a name="table126934822015"></a>
<table><thead align="left"><tr id="row1369315832016"><th class="cellrowborder" valign="top" width="23.34%" id="mcps1.1.4.1.1"><p id="p1871313815402"><a name="p1871313815402"></a><a name="p1871313815402"></a>变量</p>
</th>
<th class="cellrowborder" valign="top" width="19.06%" id="mcps1.1.4.1.2"><p id="p93231392263"><a name="p93231392263"></a><a name="p93231392263"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="57.599999999999994%" id="mcps1.1.4.1.3"><p id="p145500193814"><a name="p145500193814"></a><a name="p145500193814"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row13344184392519"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p85256525218"><a name="p85256525218"></a><a name="p85256525218"></a>emailAddress</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p107115501923"><a name="p107115501923"></a><a name="p107115501923"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p202695241341"><a name="p202695241341"></a><a name="p202695241341"></a>电子邮件地址。</p>
</td>
</tr>
<tr id="row206942882013"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p773310541229"><a name="p773310541229"></a><a name="p773310541229"></a>emailMessageBody</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p181441457223"><a name="p181441457223"></a><a name="p181441457223"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p15573202884013"><a name="p15573202884013"></a><a name="p15573202884013"></a>电子邮件正文。</p>
</td>
</tr>
<tr id="row116945832019"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p12155162811211"><a name="p12155162811211"></a><a name="p12155162811211"></a>hasReplyPath</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p14794525926"><a name="p14794525926"></a><a name="p14794525926"></a>boolean</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p13754174585919"><a name="p13754174585919"></a><a name="p13754174585919"></a>收到的短信是否包含“TP-Reply-Path”，默认为false。</p>
<a name="ul1470498307"></a><a name="ul1470498307"></a><ul id="ul1470498307"><li>“TP-Reply-Path”：移动电话根据发送SMS消息的短消息中心进行回复。</li></ul>
</td>
</tr>
<tr id="row253218315237"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p140111161132"><a name="p140111161132"></a><a name="p140111161132"></a>isEmailMessage</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p146951018131"><a name="p146951018131"></a><a name="p146951018131"></a>boolean</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p887603743519"><a name="p887603743519"></a><a name="p887603743519"></a>收到的短信是否为电子邮件。</p>
</td>
</tr>
<tr id="row859720172311"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p166361920323"><a name="p166361920323"></a><a name="p166361920323"></a>isReplaceMessage</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p01812236216"><a name="p01812236216"></a><a name="p01812236216"></a>boolean</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p022761413014"><a name="p022761413014"></a><a name="p022761413014"></a>收到的短信是否为“替换短信”，默认为false。</p>
<a name="ul42891226707"></a><a name="ul42891226707"></a><ul id="ul42891226707"><li>“替换短信”有关详细信息，参见 “3GPP TS 23.040 9.2.3.9”。</li></ul>
</td>
</tr>
<tr id="row764111193410"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p1410313450214"><a name="p1410313450214"></a><a name="p1410313450214"></a>isSmsStatusReportMessage</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p1644311475213"><a name="p1644311475213"></a><a name="p1644311475213"></a>boolean</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p5701488344"><a name="p5701488344"></a><a name="p5701488344"></a>当前消息是否为“短信状态报告”，默认为false。</p>
<a name="ul14539561111"></a><a name="ul14539561111"></a><ul id="ul14539561111"><li>“短信状态报告”是一种特定格式的短信，被用来从Service Center到Mobile Station传送状态报告。</li></ul>
</td>
</tr>
<tr id="row109475100345"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p19837318220"><a name="p19837318220"></a><a name="p19837318220"></a>messageClass</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p161336593118"><a name="p161336593118"></a><a name="p161336593118"></a><a href="#section141712166453">ShortMessageClass</a></p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p55610014386"><a name="p55610014386"></a><a name="p55610014386"></a>短信类型。</p>
</td>
</tr>
<tr id="row13623612346"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p5114831626"><a name="p5114831626"></a><a name="p5114831626"></a>pdu</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p17402133611219"><a name="p17402133611219"></a><a name="p17402133611219"></a>Array&lt;number&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p177241026133411"><a name="p177241026133411"></a><a name="p177241026133411"></a>SMS消息中的协议数据单元 （PDU）。</p>
</td>
</tr>
<tr id="row498012918341"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p4552841928"><a name="p4552841928"></a><a name="p4552841928"></a>protocolId</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p11390871024"><a name="p11390871024"></a><a name="p11390871024"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p16572083814"><a name="p16572083814"></a><a name="p16572083814"></a>发送短信时使用的协议标识。</p>
</td>
</tr>
<tr id="row87231262349"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p32951810223"><a name="p32951810223"></a><a name="p32951810223"></a>scAddress</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p4631111219219"><a name="p4631111219219"></a><a name="p4631111219219"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p136431815349"><a name="p136431815349"></a><a name="p136431815349"></a>短消息服务中心（SMSC）地址。</p>
</td>
</tr>
<tr id="row1294964403418"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p1253815422"><a name="p1253815422"></a><a name="p1253815422"></a>scTimestamp</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p1498814171127"><a name="p1498814171127"></a><a name="p1498814171127"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p294716100345"><a name="p294716100345"></a><a name="p294716100345"></a>SMSC时间戳。</p>
</td>
</tr>
<tr id="row169548183414"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p16266133910216"><a name="p16266133910216"></a><a name="p16266133910216"></a>status</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p1955441329"><a name="p1955441329"></a><a name="p1955441329"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p59491344113419"><a name="p59491344113419"></a><a name="p59491344113419"></a>SMS-STATUS-REPORT消息中的短信状态指示短信服务中心（SMSC）发送的短信状态。</p>
</td>
</tr>
<tr id="row1526817245344"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p156631801631"><a name="p156631801631"></a><a name="p156631801631"></a>userRawData</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p861981315311"><a name="p861981315311"></a><a name="p861981315311"></a>Array&lt;number&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p8487922358"><a name="p8487922358"></a><a name="p8487922358"></a>除数据头外的用户数据。</p>
</td>
</tr>
<tr id="row183801940133512"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p396619450120"><a name="p396619450120"></a><a name="p396619450120"></a>visibleMessageBody</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p819218501110"><a name="p819218501110"></a><a name="p819218501110"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p85619013384"><a name="p85619013384"></a><a name="p85619013384"></a>短信正文。</p>
</td>
</tr>
<tr id="row98751137153511"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p12309536110"><a name="p12309536110"></a><a name="p12309536110"></a>visibleRawAddress</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p559135510111"><a name="p559135510111"></a><a name="p559135510111"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p55617011389"><a name="p55617011389"></a><a name="p55617011389"></a>发送者地址。</p>
</td>
</tr>
</tbody>
</table>
## ShortMessageClass<a name="section141712166453"></a>
短信类型。
<a name="table12281144104511"></a>
<table><thead align="left"><tr id="row10281144124514"><th class="cellrowborder" valign="top" width="23.34%" id="mcps1.1.4.1.1"><p id="p128194419456"><a name="p128194419456"></a><a name="p128194419456"></a>变量</p>
</th>
<th class="cellrowborder" valign="top" width="19.06%" id="mcps1.1.4.1.2"><p id="p1528204484519"><a name="p1528204484519"></a><a name="p1528204484519"></a>值</p>
</th>
<th class="cellrowborder" valign="top" width="57.599999999999994%" id="mcps1.1.4.1.3"><p id="p82824447459"><a name="p82824447459"></a><a name="p82824447459"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row12821744124513"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p1366413819465"><a name="p1366413819465"></a><a name="p1366413819465"></a>UNKNOWN</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p182826444455"><a name="p182826444455"></a><a name="p182826444455"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p4282244154515"><a name="p4282244154515"></a><a name="p4282244154515"></a>未知类型。</p>
</td>
</tr>
<tr id="row1828218449455"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p20401438488"><a name="p20401438488"></a><a name="p20401438488"></a>INSTANT_MESSAGE</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p9282184418454"><a name="p9282184418454"></a><a name="p9282184418454"></a>1</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p1728234434513"><a name="p1728234434513"></a><a name="p1728234434513"></a>即时消息，收到后立即显示。</p>
</td>
</tr>
<tr id="row1528364416454"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p17720456485"><a name="p17720456485"></a><a name="p17720456485"></a>OPTIONAL_MESSAGE</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p928314454518"><a name="p928314454518"></a><a name="p928314454518"></a>2</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p1428354414451"><a name="p1428354414451"></a><a name="p1428354414451"></a>存储在设备或SIM卡上的短信。</p>
</td>
</tr>
<tr id="row676864804613"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p1724510489488"><a name="p1724510489488"></a><a name="p1724510489488"></a>SIM_MESSAGE</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p1176924824615"><a name="p1176924824615"></a><a name="p1176924824615"></a>3</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p157698488462"><a name="p157698488462"></a><a name="p157698488462"></a>包含SIM卡信息的短信，需要存储在SIM卡中。</p>
</td>
</tr>
<tr id="row17327345184610"><td class="cellrowborder" valign="top" width="23.34%" headers="mcps1.1.4.1.1 "><p id="p17950155010481"><a name="p17950155010481"></a><a name="p17950155010481"></a>FORWARD_MESSAGE</p>
</td>
<td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.1.4.1.2 "><p id="p6328134594614"><a name="p6328134594614"></a><a name="p6328134594614"></a>4</p>
</td>
<td class="cellrowborder" valign="top" width="57.599999999999994%" headers="mcps1.1.4.1.3 "><p id="p183286452464"><a name="p183286452464"></a><a name="p183286452464"></a>要转发到另一台设备的短信。</p>
</td>
</tr>
</tbody>
</table>
## SendMessageOptions<a name="section12262183471518"></a>
发送短信的参数和回调。
根据SendMessageOptions中的可选参数content的值判断短信类型。
<a name="table426533441512"></a>
<table><thead align="left"><tr id="row1626518342159"><th class="cellrowborder" valign="top" width="18.69%" id="mcps1.1.5.1.1"><p id="p178726479354"><a name="p178726479354"></a><a name="p178726479354"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="22.07%" id="mcps1.1.5.1.2"><p id="p1426519342153"><a name="p1426519342153"></a><a name="p1426519342153"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="6.88%" id="mcps1.1.5.1.3"><p id="p17265143471517"><a name="p17265143471517"></a><a name="p17265143471517"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="52.35999999999999%" id="mcps1.1.5.1.4"><p id="p1126583411512"><a name="p1126583411512"></a><a name="p1126583411512"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row126610344150"><td class="cellrowborder" valign="top" width="18.69%" headers="mcps1.1.5.1.1 "><p id="p414313350720"><a name="p414313350720"></a><a name="p414313350720"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="22.07%" headers="mcps1.1.5.1.2 "><p id="p19298134416718"><a name="p19298134416718"></a><a name="p19298134416718"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="6.88%" headers="mcps1.1.5.1.3 "><p id="p17266183451512"><a name="p17266183451512"></a><a name="p17266183451512"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="52.35999999999999%" headers="mcps1.1.5.1.4 "><p id="p1563734381412"><a name="p1563734381412"></a><a name="p1563734381412"></a>用于发送短信的SIM卡槽ID：</p>
<a name="ul1226144151514"></a><a name="ul1226144151514"></a><ul id="ul1226144151514"><li>0：卡槽1</li><li>1：卡槽2</li></ul>
</td>
</tr>
<tr id="row11791572064"><td class="cellrowborder" valign="top" width="18.69%" headers="mcps1.1.5.1.1 "><p id="p11588175111715"><a name="p11588175111715"></a><a name="p11588175111715"></a>destinationHost</p>
</td>
<td class="cellrowborder" valign="top" width="22.07%" headers="mcps1.1.5.1.2 "><p id="p52991257274"><a name="p52991257274"></a><a name="p52991257274"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="6.88%" headers="mcps1.1.5.1.3 "><p id="p181791171161"><a name="p181791171161"></a><a name="p181791171161"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="52.35999999999999%" headers="mcps1.1.5.1.4 "><p id="p2017987066"><a name="p2017987066"></a><a name="p2017987066"></a>短信的发送地址。</p>
</td>
</tr>
<tr id="row16360111493118"><td class="cellrowborder" valign="top" width="18.69%" headers="mcps1.1.5.1.1 "><p id="p76811119810"><a name="p76811119810"></a><a name="p76811119810"></a>content</p>
</td>
<td class="cellrowborder" valign="top" width="22.07%" headers="mcps1.1.5.1.2 "><p id="p153513192820"><a name="p153513192820"></a><a name="p153513192820"></a>string | Array&lt;number&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="6.88%" headers="mcps1.1.5.1.3 "><p id="p482451216615"><a name="p482451216615"></a><a name="p482451216615"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="52.35999999999999%" headers="mcps1.1.5.1.4 "><p id="p15340948132416"><a name="p15340948132416"></a><a name="p15340948132416"></a>如果内容是字符串，则这是一条文本短信。</p>
<p id="p12824111212619"><a name="p12824111212619"></a><a name="p12824111212619"></a>如果内容是字节数组，则这是一条数据短信。</p>
</td>
</tr>
<tr id="row17902109267"><td class="cellrowborder" valign="top" width="18.69%" headers="mcps1.1.5.1.1 "><p id="p1441441820"><a name="p1441441820"></a><a name="p1441441820"></a>serviceCenter</p>
</td>
<td class="cellrowborder" valign="top" width="22.07%" headers="mcps1.1.5.1.2 "><p id="p1755119718816"><a name="p1755119718816"></a><a name="p1755119718816"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="6.88%" headers="mcps1.1.5.1.3 "><p id="p990279068"><a name="p990279068"></a><a name="p990279068"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="52.35999999999999%" headers="mcps1.1.5.1.4 "><p id="p1890229663"><a name="p1890229663"></a><a name="p1890229663"></a>短信中心地址。默认使用SIM卡中的短信中心地址。</p>
</td>
</tr>
<tr id="row12412215961"><td class="cellrowborder" valign="top" width="18.69%" headers="mcps1.1.5.1.1 "><p id="p750262516813"><a name="p750262516813"></a><a name="p750262516813"></a>destinationPort</p>
</td>
<td class="cellrowborder" valign="top" width="22.07%" headers="mcps1.1.5.1.2 "><p id="p1727917299816"><a name="p1727917299816"></a><a name="p1727917299816"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="6.88%" headers="mcps1.1.5.1.3 "><p id="p10412111519610"><a name="p10412111519610"></a><a name="p10412111519610"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="52.35999999999999%" headers="mcps1.1.5.1.4 "><p id="p1541319151266"><a name="p1541319151266"></a><a name="p1541319151266"></a>如果发送数据消息，destinationPort 是必需的。否则是可选的。</p>
</td>
</tr>
<tr id="row169402191669"><td class="cellrowborder" valign="top" width="18.69%" headers="mcps1.1.5.1.1 "><p id="p82028327818"><a name="p82028327818"></a><a name="p82028327818"></a>sendCallback</p>
</td>
<td class="cellrowborder" valign="top" width="22.07%" headers="mcps1.1.5.1.2 "><p id="p835213618913"><a name="p835213618913"></a><a name="p835213618913"></a>AsyncCallback</p>
<p id="p449664817810"><a name="p449664817810"></a><a name="p449664817810"></a>&lt;<a href="#section16646146115317">ISendShortMessageCallback</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="6.88%" headers="mcps1.1.5.1.3 "><p id="p1940131914612"><a name="p1940131914612"></a><a name="p1940131914612"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="52.35999999999999%" headers="mcps1.1.5.1.4 "><p id="p9940151920617"><a name="p9940151920617"></a><a name="p9940151920617"></a>短信发送结果回调，返回短信发送的结果，参考<a href="#section16646146115317">ISendShortMessageCallback</a>。</p>
</td>
</tr>
<tr id="row196683176615"><td class="cellrowborder" valign="top" width="18.69%" headers="mcps1.1.5.1.1 "><p id="p1764495320816"><a name="p1764495320816"></a><a name="p1764495320816"></a>deliveryCallback</p>
</td>
<td class="cellrowborder" valign="top" width="22.07%" headers="mcps1.1.5.1.2 "><p id="p3892339195"><a name="p3892339195"></a><a name="p3892339195"></a>AsyncCallback</p>
<p id="p8149858286"><a name="p8149858286"></a><a name="p8149858286"></a>&lt;<a href="#section12183749531">IDeliveryShortMessageCallback</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="6.88%" headers="mcps1.1.5.1.3 "><p id="p176695171565"><a name="p176695171565"></a><a name="p176695171565"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="52.35999999999999%" headers="mcps1.1.5.1.4 "><p id="p3669151714610"><a name="p3669151714610"></a><a name="p3669151714610"></a>短信送达结果回调，返回短信递送报告，参考<a href="#section12183749531">IDeliveryShortMessageCallback</a>。</p>
</td>
</tr>
</tbody>
</table>
## ISendShortMessageCallback<a name="section16646146115317"></a>
回调实例。返回短信发送结果、存储已发送短信的URI和是否为长短信的最后一部分。
<a name="table1964615620539"></a>
<table><thead align="left"><tr id="row964614675318"><th class="cellrowborder" valign="top" width="11.940000000000001%" id="mcps1.1.5.1.1"><p id="p1964613635311"><a name="p1964613635311"></a><a name="p1964613635311"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="23.27%" id="mcps1.1.5.1.2"><p id="p16646136115317"><a name="p16646136115317"></a><a name="p16646136115317"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="7.8100000000000005%" id="mcps1.1.5.1.3"><p id="p76461662532"><a name="p76461662532"></a><a name="p76461662532"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="56.98%" id="mcps1.1.5.1.4"><p id="p1664611620539"><a name="p1664611620539"></a><a name="p1664611620539"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row71461356335"><td class="cellrowborder" valign="top" width="11.940000000000001%" headers="mcps1.1.5.1.1 "><p id="p6680712195510"><a name="p6680712195510"></a><a name="p6680712195510"></a>isLastPart</p>
</td>
<td class="cellrowborder" valign="top" width="23.27%" headers="mcps1.1.5.1.2 "><p id="p10985814205514"><a name="p10985814205514"></a><a name="p10985814205514"></a>boolean</p>
</td>
<td class="cellrowborder" valign="top" width="7.8100000000000005%" headers="mcps1.1.5.1.3 "><p id="p19647176105316"><a name="p19647176105316"></a><a name="p19647176105316"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="56.98%" headers="mcps1.1.5.1.4 "><p id="p391010266511"><a name="p391010266511"></a><a name="p391010266511"></a>指定这是否是长短信的最后一部分。true表示这是长短信的最后一部分，false表示不是。默认为false。</p>
</td>
</tr>
<tr id="row66462665318"><td class="cellrowborder" valign="top" width="11.940000000000001%" headers="mcps1.1.5.1.1 "><p id="p12719120115514"><a name="p12719120115514"></a><a name="p12719120115514"></a>result</p>
</td>
<td class="cellrowborder" valign="top" width="23.27%" headers="mcps1.1.5.1.2 "><p id="p118240345516"><a name="p118240345516"></a><a name="p118240345516"></a><a href="#section13290132311575">SendSmsResult</a></p>
</td>
<td class="cellrowborder" valign="top" width="7.8100000000000005%" headers="mcps1.1.5.1.3 "><p id="p8647465537"><a name="p8647465537"></a><a name="p8647465537"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="56.98%" headers="mcps1.1.5.1.4 "><p id="p364756125310"><a name="p364756125310"></a><a name="p364756125310"></a>短信发送结果。</p>
</td>
</tr>
<tr id="row86473614538"><td class="cellrowborder" valign="top" width="11.940000000000001%" headers="mcps1.1.5.1.1 "><p id="p01183720558"><a name="p01183720558"></a><a name="p01183720558"></a>url</p>
</td>
<td class="cellrowborder" valign="top" width="23.27%" headers="mcps1.1.5.1.2 "><p id="p1994379185512"><a name="p1994379185512"></a><a name="p1994379185512"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="7.8100000000000005%" headers="mcps1.1.5.1.3 "><p id="p116472685320"><a name="p116472685320"></a><a name="p116472685320"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="56.98%" headers="mcps1.1.5.1.4 "><p id="p176471666538"><a name="p176471666538"></a><a name="p176471666538"></a>存储发送短信的URI。</p>
</td>
</tr>
</tbody>
</table>
## IDeliveryShortMessageCallback<a name="section12183749531"></a>
回调实例。返回短信送达报告。
<a name="table218311405312"></a>
<table><thead align="left"><tr id="row1618314495318"><th class="cellrowborder" valign="top" width="11.940000000000001%" id="mcps1.1.5.1.1"><p id="p17183849534"><a name="p17183849534"></a><a name="p17183849534"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="23.27%" id="mcps1.1.5.1.2"><p id="p2184945531"><a name="p2184945531"></a><a name="p2184945531"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="7.8100000000000005%" id="mcps1.1.5.1.3"><p id="p41841749538"><a name="p41841749538"></a><a name="p41841749538"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="56.98%" id="mcps1.1.5.1.4"><p id="p131841745531"><a name="p131841745531"></a><a name="p131841745531"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row17184446536"><td class="cellrowborder" valign="top" width="11.940000000000001%" headers="mcps1.1.5.1.1 "><p id="p13636519105610"><a name="p13636519105610"></a><a name="p13636519105610"></a>pdu</p>
</td>
<td class="cellrowborder" valign="top" width="23.27%" headers="mcps1.1.5.1.2 "><p id="p1762201610565"><a name="p1762201610565"></a><a name="p1762201610565"></a>Array&lt;number&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="7.8100000000000005%" headers="mcps1.1.5.1.3 "><p id="p018415405317"><a name="p018415405317"></a><a name="p018415405317"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="56.98%" headers="mcps1.1.5.1.4 "><p id="p18584153316316"><a name="p18584153316316"></a><a name="p18584153316316"></a>短信送达报告。</p>
</td>
</tr>
</tbody>
</table>
## SendSmsResult<a name="section13290132311575"></a>
短信发送结果。
<a name="table102901123175720"></a>
<table><thead align="left"><tr id="row13290023145720"><th class="cellrowborder" valign="top" width="43.47%" id="mcps1.1.4.1.1"><p id="p629042314578"><a name="p629042314578"></a><a name="p629042314578"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="9.51%" id="mcps1.1.4.1.2"><p id="p16291323135715"><a name="p16291323135715"></a><a name="p16291323135715"></a>值</p>
</th>
<th class="cellrowborder" valign="top" width="47.02%" id="mcps1.1.4.1.3"><p id="p62916234577"><a name="p62916234577"></a><a name="p62916234577"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row12911223125718"><td class="cellrowborder" valign="top" width="43.47%" headers="mcps1.1.4.1.1 "><p id="p59203610580"><a name="p59203610580"></a><a name="p59203610580"></a>SEND_SMS_SUCCESS</p>
</td>
<td class="cellrowborder" valign="top" width="9.51%" headers="mcps1.1.4.1.2 "><p id="p1529172310579"><a name="p1529172310579"></a><a name="p1529172310579"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="47.02%" headers="mcps1.1.4.1.3 "><p id="p1329122335715"><a name="p1329122335715"></a><a name="p1329122335715"></a>发送短信成功。</p>
</td>
</tr>
<tr id="row458123655717"><td class="cellrowborder" valign="top" width="43.47%" headers="mcps1.1.4.1.1 "><p id="p478263820580"><a name="p478263820580"></a><a name="p478263820580"></a>SEND_SMS_FAILURE_UNKNOWN</p>
</td>
<td class="cellrowborder" valign="top" width="9.51%" headers="mcps1.1.4.1.2 "><p id="p458223645713"><a name="p458223645713"></a><a name="p458223645713"></a>1</p>
</td>
<td class="cellrowborder" valign="top" width="47.02%" headers="mcps1.1.4.1.3 "><p id="p558253614573"><a name="p558253614573"></a><a name="p558253614573"></a>发送短信失败，原因未知。</p>
</td>
</tr>
<tr id="row2045810344577"><td class="cellrowborder" valign="top" width="43.47%" headers="mcps1.1.4.1.1 "><p id="p13459184185812"><a name="p13459184185812"></a><a name="p13459184185812"></a>SEND_SMS_FAILURE_RADIO_OFF</p>
</td>
<td class="cellrowborder" valign="top" width="9.51%" headers="mcps1.1.4.1.2 "><p id="p164591834155714"><a name="p164591834155714"></a><a name="p164591834155714"></a>2</p>
</td>
<td class="cellrowborder" valign="top" width="47.02%" headers="mcps1.1.4.1.3 "><p id="p4459734125717"><a name="p4459734125717"></a><a name="p4459734125717"></a>发送短信失败，原因为调制解调器关机。</p>
</td>
</tr>
<tr id="row0114132105714"><td class="cellrowborder" valign="top" width="43.47%" headers="mcps1.1.4.1.1 "><p id="p1586519435581"><a name="p1586519435581"></a><a name="p1586519435581"></a>SEND_SMS_FAILURE_SERVICE_UNAVAILABLE</p>
</td>
<td class="cellrowborder" valign="top" width="9.51%" headers="mcps1.1.4.1.2 "><p id="p1111493218571"><a name="p1111493218571"></a><a name="p1111493218571"></a>3</p>
</td>
<td class="cellrowborder" valign="top" width="47.02%" headers="mcps1.1.4.1.3 "><p id="p159271549104318"><a name="p159271549104318"></a><a name="p159271549104318"></a>发送短信失败，原因为网络不可用、不支持发送或接收短信。</p>
</td>
</tr>
</tbody>
</table>
zh-cn/application-dev/js-reference/网络搜索.md 0 → 100755
浏览文件 @ fab6c976
# Radio<a name="ZH-CN_TOPIC_0000001145113322"></a>
- [导入模块](#s56d19203690d4782bfc74069abb6bd71)
- [radio.getRadioTech](#section18401172810207)
- [radio.getRadioTech](#section686385662419)
- [radio.getNetworkState](#section2090641619263)
- [radio.getNetworkState](#section392520433402)
- [radio.getNetworkState](#section20661545182918)
- [radio.getNetworkSelectionMode](#section79561056114711)
- [radio.getNetworkSelectionMode](#section553074612507)
- [radio.getISOCountryCodeForNetwork7+](#section16183194320525)
- [radio.getISOCountryCodeForNetwork7+](#section56144132559)
- [radio.getSignalInformation](#section1153532721018)
- [radio.getSignalInformation](#section1859512161511)
- [radio.isRadioOn7+](#section5456161711228)
- [radio.isRadioOn7+](#section178817520243)
- [RadioTechnology](#section1072135204020)
- [SignalInformation](#section10701756164212)
- [NetworkType](#section519718112466)
- [NetworkState](#section1691213911470)
- [RegState](#section18174131911514)
- [NsaState](#section448018155317)
- [NetworkSelectionMode](#section14219361268)
>**说明：**
>
>标记7+的表示从API Version 7开始支持，未标记的表示从API Version 6开始支持。
## 导入模块<a name="s56d19203690d4782bfc74069abb6bd71"></a>
```
import radio from '@ohos.telephony.radio'
```
## radio.getRadioTech<a name="section18401172810207"></a>
getRadioTech\(slotId: number, callback: AsyncCallback<\{psRadioTech: RadioTechnology, csRadioTech: RadioTechnology\}\>\): void
获取当前接入的CS域和PS域无线接入技术，使用callback方式作为异步方法。
需要ohos.permission.GET\_NETWORK\_INFO权限。
- 参数
<a name="table799351710213"></a>
<table><thead align="left"><tr id="row1799411175217"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p899411179212"><a name="p899411179212"></a><a name="p899411179212"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="58.76%" id="mcps1.1.5.1.2"><p id="p9994017112117"><a name="p9994017112117"></a><a name="p9994017112117"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.26%" id="mcps1.1.5.1.3"><p id="p169941617192115"><a name="p169941617192115"></a><a name="p169941617192115"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="19.93%" id="mcps1.1.5.1.4"><p id="p499491722118"><a name="p499491722118"></a><a name="p499491722118"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row107581022174417"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p1231917335444"><a name="p1231917335444"></a><a name="p1231917335444"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="58.76%" headers="mcps1.1.5.1.2 "><p id="p275912223446"><a name="p275912223446"></a><a name="p275912223446"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.26%" headers="mcps1.1.5.1.3 "><p id="p27599224442"><a name="p27599224442"></a><a name="p27599224442"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="19.93%" headers="mcps1.1.5.1.4 "><p id="p111750457258"><a name="p111750457258"></a><a name="p111750457258"></a>卡槽ID。</p>
<p id="p39541754174217"><a name="p39541754174217"></a><a name="p39541754174217"></a>0：卡槽1</p>
<p id="p1016919004317"><a name="p1016919004317"></a><a name="p1016919004317"></a>1：卡槽2</p>
</td>
</tr>
<tr id="row79942177215"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p1299481713210"><a name="p1299481713210"></a><a name="p1299481713210"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="58.76%" headers="mcps1.1.5.1.2 "><p id="p112321515195213"><a name="p112321515195213"></a><a name="p112321515195213"></a>AsyncCallback&lt;{psRadioTech: <a href="#section1072135204020">RadioTechnology</a>, csRadioTech: <a href="#section1072135204020">RadioTechnology</a>}&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="10.26%" headers="mcps1.1.5.1.3 "><p id="p1599411782114"><a name="p1599411782114"></a><a name="p1599411782114"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="19.93%" headers="mcps1.1.5.1.4 "><p id="p10994181720215"><a name="p10994181720215"></a><a name="p10994181720215"></a>回调函数。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let slotId = 0;
radio.getRadioTech(slotId, (err, data) =>{
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## radio.getRadioTech<a name="section686385662419"></a>
getRadioTech\(slotId: number\): Promise<\{psRadioTech: RadioTechnology, csRadioTech: RadioTechnology\}\>
获取当前接入的CS域和PS域无线接入技术，使用Promise方式作为异步方法。
需要ohos.permission.GET\_NETWORK\_INFO权限。
- 参数
<a name="table125907710127"></a>
<table><thead align="left"><tr id="row1659112714124"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p175911273125"><a name="p175911273125"></a><a name="p175911273125"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p14591157191213"><a name="p14591157191213"></a><a name="p14591157191213"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p125911791210"><a name="p125911791210"></a><a name="p125911791210"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p1459110712122"><a name="p1459110712122"></a><a name="p1459110712122"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row159111720120"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p14591177151217"><a name="p14591177151217"></a><a name="p14591177151217"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p11591177201215"><a name="p11591177201215"></a><a name="p11591177201215"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p7591117181212"><a name="p7591117181212"></a><a name="p7591117181212"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p359112718122"><a name="p359112718122"></a><a name="p359112718122"></a>卡槽ID。</p>
<p id="p19591137181219"><a name="p19591137181219"></a><a name="p19591137181219"></a>0：卡槽1</p>
<p id="p5591072124"><a name="p5591072124"></a><a name="p5591072124"></a>1：卡槽2</p>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table11130132420365"></a>
<table><thead align="left"><tr id="row1213092453617"><th class="cellrowborder" valign="top" width="50.94%" id="mcps1.1.3.1.1"><p id="p191308246365"><a name="p191308246365"></a><a name="p191308246365"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="49.059999999999995%" id="mcps1.1.3.1.2"><p id="p513092453618"><a name="p513092453618"></a><a name="p513092453618"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row01311524183615"><td class="cellrowborder" valign="top" width="50.94%" headers="mcps1.1.3.1.1 "><p id="p28631116886"><a name="p28631116886"></a><a name="p28631116886"></a>Promise&lt;{psRadioTech: <a href="#section1072135204020">RadioTechnology</a>, csRadioTech: <a href="#section1072135204020">RadioTechnology</a>}&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="49.059999999999995%" headers="mcps1.1.3.1.2 "><p id="p11311424123610"><a name="p11311424123610"></a><a name="p11311424123610"></a>以Promise形式<span>返回</span><span>获取当前接入的CS域和PS域技术</span>。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let slotId = 0;
let promise = radio.getRadioTech(slotId);
promise.then(data => {
console.log(`getRadioTech success, data->${JSON.stringify(data)}`);
}).catch(err => {
console.log(`getRadioTech fail, err->${JSON.stringify(err)}`);
});
```
## radio.getNetworkState<a name="section2090641619263"></a>
getNetworkState\(callback: AsyncCallback<NetworkState\>\): void
获取网络状态，使用callback方式作为异步方法。
需要ohos.permission.GET\_NETWORK\_INFO权限。
- 参数
<a name="table1133014121782"></a>
<table><thead align="left"><tr id="row4330111211811"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p833161216811"><a name="p833161216811"></a><a name="p833161216811"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p033111121185"><a name="p033111121185"></a><a name="p033111121185"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p1233110127818"><a name="p1233110127818"></a><a name="p1233110127818"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p1233119121882"><a name="p1233119121882"></a><a name="p1233119121882"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row63317121487"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p633118122815"><a name="p633118122815"></a><a name="p633118122815"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p150313319819"><a name="p150313319819"></a><a name="p150313319819"></a>AsyncCallback&lt;<a href="#section1691213911470">NetworkState</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p3331171217820"><a name="p3331171217820"></a><a name="p3331171217820"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p1533161212817"><a name="p1533161212817"></a><a name="p1533161212817"></a>回调函数。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
radio.getNetworkState((err, data) =>{
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## radio.getNetworkState<a name="section392520433402"></a>
getNetworkState\(slotId: number, callback: AsyncCallback<NetworkState\>\): void
获取网络状态，使用callback方式作为异步方法。
需要ohos.permission.GET\_NETWORK\_INFO权限。
- 参数
<a name="table11928163052718"></a>
<table><thead align="left"><tr id="row199283309273"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p49281530182712"><a name="p49281530182712"></a><a name="p49281530182712"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p129283306273"><a name="p129283306273"></a><a name="p129283306273"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p15928123012278"><a name="p15928123012278"></a><a name="p15928123012278"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p79284305276"><a name="p79284305276"></a><a name="p79284305276"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1292853016277"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p9928143082716"><a name="p9928143082716"></a><a name="p9928143082716"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p09298306275"><a name="p09298306275"></a><a name="p09298306275"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p1892914308275"><a name="p1892914308275"></a><a name="p1892914308275"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p1092913032717"><a name="p1092913032717"></a><a name="p1092913032717"></a>卡槽ID。</p>
<p id="p392918309278"><a name="p392918309278"></a><a name="p392918309278"></a>0：卡槽1</p>
<p id="p15929030192713"><a name="p15929030192713"></a><a name="p15929030192713"></a>1：卡槽2</p>
</td>
</tr>
<tr id="row199291302270"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p0929130162711"><a name="p0929130162711"></a><a name="p0929130162711"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p1992993032712"><a name="p1992993032712"></a><a name="p1992993032712"></a>AsyncCallback&lt;<a href="#section1691213911470">NetworkState</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p2929183042710"><a name="p2929183042710"></a><a name="p2929183042710"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p129291308276"><a name="p129291308276"></a><a name="p129291308276"></a>回调函数。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let slotId = 0;
radio.getNetworkState(slotId, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## radio.getNetworkState<a name="section20661545182918"></a>
getNetworkState\(slotId?: number\): Promise<NetworkState\>
获取网络状态，使用Promise方式作为异步方法。
需要ohos.permission.GET\_NETWORK\_INFO权限。
- 参数
<a name="table65021374111"></a>
<table><thead align="left"><tr id="row150151312414"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p175061334120"><a name="p175061334120"></a><a name="p175061334120"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p195021364111"><a name="p195021364111"></a><a name="p195021364111"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p1350913134110"><a name="p1350913134110"></a><a name="p1350913134110"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p205091319419"><a name="p205091319419"></a><a name="p205091319419"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row6501513184114"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p1931012820452"><a name="p1931012820452"></a><a name="p1931012820452"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p1031014286451"><a name="p1031014286451"></a><a name="p1031014286451"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p1131022813452"><a name="p1131022813452"></a><a name="p1131022813452"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p10310928164516"><a name="p10310928164516"></a><a name="p10310928164516"></a>卡槽ID。</p>
<p id="p10311928124516"><a name="p10311928124516"></a><a name="p10311928124516"></a>0：卡槽1</p>
<p id="p131142814456"><a name="p131142814456"></a><a name="p131142814456"></a>1：卡槽2</p>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table041714530438"></a>
<table><thead align="left"><tr id="row18418853104314"><th class="cellrowborder" valign="top" width="26.419999999999998%" id="mcps1.1.3.1.1"><p id="p11418553184319"><a name="p11418553184319"></a><a name="p11418553184319"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="73.58%" id="mcps1.1.3.1.2"><p id="p1941885354313"><a name="p1941885354313"></a><a name="p1941885354313"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row16418253194313"><td class="cellrowborder" valign="top" width="26.419999999999998%" headers="mcps1.1.3.1.1 "><p id="p84416171396"><a name="p84416171396"></a><a name="p84416171396"></a>Promise&lt;<a href="#section1691213911470">NetworkState</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="73.58%" headers="mcps1.1.3.1.2 "><p id="p1537012718231"><a name="p1537012718231"></a><a name="p1537012718231"></a>以Promise形式返回网络状态。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let slotId = 0;
let promise = radio.getNetworkState(slotId);
promise.then(data => {
console.log(`getNetworkState success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.log(`getNetworkState fail, promise: err->${JSON.stringify(err)}`);
});
```
## radio.getNetworkSelectionMode<a name="section79561056114711"></a>
getNetworkSelectionMode\(slotId: number, callback: AsyncCallback<NetworkSelectionMode\>\): void
获取当前选网模式，使用callback方式作为异步方法。
- 参数
<a name="table474813715499"></a>
<table><thead align="left"><tr id="row1374814711498"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p13748137194915"><a name="p13748137194915"></a><a name="p13748137194915"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p37481719495"><a name="p37481719495"></a><a name="p37481719495"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p87481714913"><a name="p87481714913"></a><a name="p87481714913"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p9748157124912"><a name="p9748157124912"></a><a name="p9748157124912"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1074857154914"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p1074837134913"><a name="p1074837134913"></a><a name="p1074837134913"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p07489714919"><a name="p07489714919"></a><a name="p07489714919"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p37481717493"><a name="p37481717493"></a><a name="p37481717493"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p17748176496"><a name="p17748176496"></a><a name="p17748176496"></a>卡槽ID。</p>
<p id="p2748673497"><a name="p2748673497"></a><a name="p2748673497"></a>0：卡槽1</p>
<p id="p8748970499"><a name="p8748970499"></a><a name="p8748970499"></a>1：卡槽2</p>
</td>
</tr>
<tr id="row127482774919"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p177481764920"><a name="p177481764920"></a><a name="p177481764920"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p14749275495"><a name="p14749275495"></a><a name="p14749275495"></a>AsyncCallback&lt;<a href="#section14219361268">NetworkSelectionMode</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p874910724910"><a name="p874910724910"></a><a name="p874910724910"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p474917710499"><a name="p474917710499"></a><a name="p474917710499"></a>回调函数。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let slotId = 0;
radio.getNetworkSelectionMode(slotId, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## radio.getNetworkSelectionMode<a name="section553074612507"></a>
getNetworkSelectionMode\(slotId: number\): Promise<NetworkSelectionMode\>
获取当前选网模式，使用Promise方式作为异步方法。
- 参数
<a name="table2530104655016"></a>
<table><thead align="left"><tr id="row125311446175016"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p1353110468506"><a name="p1353110468506"></a><a name="p1353110468506"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p115311468502"><a name="p115311468502"></a><a name="p115311468502"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p15531204685014"><a name="p15531204685014"></a><a name="p15531204685014"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p10531546105013"><a name="p10531546105013"></a><a name="p10531546105013"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row4531174695017"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p165311746125015"><a name="p165311746125015"></a><a name="p165311746125015"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p185312463502"><a name="p185312463502"></a><a name="p185312463502"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p165311546155018"><a name="p165311546155018"></a><a name="p165311546155018"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p20531204614508"><a name="p20531204614508"></a><a name="p20531204614508"></a>卡槽ID。</p>
<p id="p353134613501"><a name="p353134613501"></a><a name="p353134613501"></a>0：卡槽1</p>
<p id="p85313462508"><a name="p85313462508"></a><a name="p85313462508"></a>1：卡槽2</p>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table549425625112"></a>
<table><thead align="left"><tr id="row1249475613515"><th class="cellrowborder" valign="top" width="39.129999999999995%" id="mcps1.1.3.1.1"><p id="p9494185617519"><a name="p9494185617519"></a><a name="p9494185617519"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="60.870000000000005%" id="mcps1.1.3.1.2"><p id="p1449415610512"><a name="p1449415610512"></a><a name="p1449415610512"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1749495611517"><td class="cellrowborder" valign="top" width="39.129999999999995%" headers="mcps1.1.3.1.1 "><p id="p184941456145112"><a name="p184941456145112"></a><a name="p184941456145112"></a>Promise&lt;<a href="#section14219361268">NetworkSelectionMode</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="60.870000000000005%" headers="mcps1.1.3.1.2 "><p id="p849415562515"><a name="p849415562515"></a><a name="p849415562515"></a>以Promise形式返回当前选网模式。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let slotId = 0;
let promise = radio.getNetworkSelectionMode(slotId);
promise.then(data => {
console.log(`getNetworkSelectionMode success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.log(`getNetworkSelectionMode fail, promise: err->${JSON.stringify(err)}`);
});
```
## radio.getISOCountryCodeForNetwork<sup>7+</sup><a name="section16183194320525"></a>
getISOCountryCodeForNetwork\(slotId: number, callback: AsyncCallback<string\>\): void
获取注册网络所在国家的ISO国家码，使用callback方式作为异步方法。
- 参数
<a name="table577030205412"></a>
<table><thead align="left"><tr id="row197719017543"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p577117016544"><a name="p577117016544"></a><a name="p577117016544"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p1177150125418"><a name="p1177150125418"></a><a name="p1177150125418"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p187717019541"><a name="p187717019541"></a><a name="p187717019541"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p87718015419"><a name="p87718015419"></a><a name="p87718015419"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row077118019543"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p1377117013545"><a name="p1377117013545"></a><a name="p1377117013545"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p1572174331119"><a name="p1572174331119"></a><a name="p1572174331119"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p377112016542"><a name="p377112016542"></a><a name="p377112016542"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p13148175975910"><a name="p13148175975910"></a><a name="p13148175975910"></a>卡槽ID。</p>
<p id="p2148659155913"><a name="p2148659155913"></a><a name="p2148659155913"></a>0：卡槽1</p>
<p id="p214855925911"><a name="p214855925911"></a><a name="p214855925911"></a>1：卡槽2</p>
</td>
</tr>
<tr id="row9772701543"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p1977220014542"><a name="p1977220014542"></a><a name="p1977220014542"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p6772160205414"><a name="p6772160205414"></a><a name="p6772160205414"></a>AsyncCallback&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p777220017542"><a name="p777220017542"></a><a name="p777220017542"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p12772150105420"><a name="p12772150105420"></a><a name="p12772150105420"></a>回调函数。返回国家码，例如：CN（中国）。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let slotId = 0;
radio.getISOCountryCodeForNetwork(slotId, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## radio.getISOCountryCodeForNetwork<sup>7+</sup><a name="section56144132559"></a>
getISOCountryCodeForNetwork\(slotId: number\): Promise<string\>
获取注册网络所在国家的ISO国家码，使用Promise方式作为异步方法。
- 参数
<a name="table152728255611"></a>
<table><thead align="left"><tr id="row927352125610"><th class="cellrowborder" valign="top" width="11.05%" id="mcps1.1.5.1.1"><p id="p1327372165611"><a name="p1327372165611"></a><a name="p1327372165611"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="42%" id="mcps1.1.5.1.2"><p id="p172731224566"><a name="p172731224566"></a><a name="p172731224566"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.42%" id="mcps1.1.5.1.3"><p id="p9273626569"><a name="p9273626569"></a><a name="p9273626569"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.53%" id="mcps1.1.5.1.4"><p id="p72733245613"><a name="p72733245613"></a><a name="p72733245613"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row32737215613"><td class="cellrowborder" valign="top" width="11.05%" headers="mcps1.1.5.1.1 "><p id="p1427311216568"><a name="p1427311216568"></a><a name="p1427311216568"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.1.5.1.2 "><p id="p202739212562"><a name="p202739212562"></a><a name="p202739212562"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.42%" headers="mcps1.1.5.1.3 "><p id="p122731323565"><a name="p122731323565"></a><a name="p122731323565"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="36.53%" headers="mcps1.1.5.1.4 "><p id="p15811441804"><a name="p15811441804"></a><a name="p15811441804"></a>卡槽ID。</p>
<p id="p181241801"><a name="p181241801"></a><a name="p181241801"></a>0：卡槽1</p>
<p id="p18254701"><a name="p18254701"></a><a name="p18254701"></a>1：卡槽2</p>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table13274112165615"></a>
<table><thead align="left"><tr id="row2274152185612"><th class="cellrowborder" valign="top" width="26.419999999999998%" id="mcps1.1.3.1.1"><p id="p927412275611"><a name="p927412275611"></a><a name="p927412275611"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="73.58%" id="mcps1.1.3.1.2"><p id="p2027415216563"><a name="p2027415216563"></a><a name="p2027415216563"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row32748295615"><td class="cellrowborder" valign="top" width="26.419999999999998%" headers="mcps1.1.3.1.1 "><p id="p12274102115614"><a name="p12274102115614"></a><a name="p12274102115614"></a>Promise&lt;string&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="73.58%" headers="mcps1.1.3.1.2 "><p id="p132743214560"><a name="p132743214560"></a><a name="p132743214560"></a>以Promise形式返回注册网络所在国家的ISO国家码，例如CN（中国）。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let slotId = 0;
let promise = radio.getISOCountryCodeForNetwork(slotId);
promise.then(data => {
console.log(`getISOCountryCodeForNetwork success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.log(`getISOCountryCodeForNetwork fail, promise: err->${JSON.stringify(err)}`);
});
```
## radio.getSignalInformation<a name="section1153532721018"></a>
getSignalInformation\(slotId: number, callback: AsyncCallback<Array<SignalInformation\>\>\): void
获取指定SIM卡槽对应的注册网络信号强度信息列表，使用callback方式作为异步方法。
- 参数
<a name="table1061723612116"></a>
<table><thead align="left"><tr id="row5617336171118"><th class="cellrowborder" valign="top" width="11.03%" id="mcps1.1.5.1.1"><p id="p661833613111"><a name="p661833613111"></a><a name="p661833613111"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="33.550000000000004%" id="mcps1.1.5.1.2"><p id="p4618133681114"><a name="p4618133681114"></a><a name="p4618133681114"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="8.92%" id="mcps1.1.5.1.3"><p id="p18618173610115"><a name="p18618173610115"></a><a name="p18618173610115"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="46.5%" id="mcps1.1.5.1.4"><p id="p56180360114"><a name="p56180360114"></a><a name="p56180360114"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1361816361115"><td class="cellrowborder" valign="top" width="11.03%" headers="mcps1.1.5.1.1 "><p id="p1661843641119"><a name="p1661843641119"></a><a name="p1661843641119"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="33.550000000000004%" headers="mcps1.1.5.1.2 "><p id="p1061843651117"><a name="p1061843651117"></a><a name="p1061843651117"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="8.92%" headers="mcps1.1.5.1.3 "><p id="p761175974216"><a name="p761175974216"></a><a name="p761175974216"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.5%" headers="mcps1.1.5.1.4 "><p id="p971654194213"><a name="p971654194213"></a><a name="p971654194213"></a>卡槽ID。</p>
<p id="p8719545423"><a name="p8719545423"></a><a name="p8719545423"></a>0：卡槽1</p>
<p id="p0711254194218"><a name="p0711254194218"></a><a name="p0711254194218"></a>1：卡槽2</p>
</td>
</tr>
<tr id="row1661913611113"><td class="cellrowborder" valign="top" width="11.03%" headers="mcps1.1.5.1.1 "><p id="p10619103610112"><a name="p10619103610112"></a><a name="p10619103610112"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="33.550000000000004%" headers="mcps1.1.5.1.2 "><p id="p8619173671111"><a name="p8619173671111"></a><a name="p8619173671111"></a>AsyncCallback&lt;Array&lt;<a href="#section10701756164212">SignalInformation</a>&gt;&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="8.92%" headers="mcps1.1.5.1.3 "><p id="p861933610118"><a name="p861933610118"></a><a name="p861933610118"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="46.5%" headers="mcps1.1.5.1.4 "><p id="p861912364116"><a name="p861912364116"></a><a name="p861912364116"></a>回调函数，返回<a href="#section10701756164212">SignalInformation</a>对象的数组。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let slotId = 0;
radio.getSignalInformation(slotId, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## radio.getSignalInformation<a name="section1859512161511"></a>
getSignalInformation\(slotId: number\): Promise<Array<SignalInformation\>\>
获取指定SIM卡槽对应的注册网络信号强度信息列表，使用Promise方式作为异步方法。
- 参数
<a name="table11589811191613"></a>
<table><thead align="left"><tr id="row558971111617"><th class="cellrowborder" valign="top" width="11.03%" id="mcps1.1.5.1.1"><p id="p658961121619"><a name="p658961121619"></a><a name="p658961121619"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="33.550000000000004%" id="mcps1.1.5.1.2"><p id="p1758941151610"><a name="p1758941151610"></a><a name="p1758941151610"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="13.139999999999999%" id="mcps1.1.5.1.3"><p id="p1758919111164"><a name="p1758919111164"></a><a name="p1758919111164"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="42.28%" id="mcps1.1.5.1.4"><p id="p658916113164"><a name="p658916113164"></a><a name="p658916113164"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row15589191118166"><td class="cellrowborder" valign="top" width="11.03%" headers="mcps1.1.5.1.1 "><p id="p258921171613"><a name="p258921171613"></a><a name="p258921171613"></a>slotId</p>
</td>
<td class="cellrowborder" valign="top" width="33.550000000000004%" headers="mcps1.1.5.1.2 "><p id="p1759018111168"><a name="p1759018111168"></a><a name="p1759018111168"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="13.139999999999999%" headers="mcps1.1.5.1.3 "><p id="p1359051110161"><a name="p1359051110161"></a><a name="p1359051110161"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="42.28%" headers="mcps1.1.5.1.4 "><p id="p488718104314"><a name="p488718104314"></a><a name="p488718104314"></a>卡槽ID。</p>
<p id="p88872817438"><a name="p88872817438"></a><a name="p88872817438"></a>0：卡槽1</p>
<p id="p11887138144315"><a name="p11887138144315"></a><a name="p11887138144315"></a>1：卡槽2</p>
</td>
</tr>
</tbody>
</table>
- 返回值
<a name="table1159021111163"></a>
<table><thead align="left"><tr id="row7590811181610"><th class="cellrowborder" valign="top" width="26.06%" id="mcps1.1.3.1.1"><p id="p115901114164"><a name="p115901114164"></a><a name="p115901114164"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="73.94%" id="mcps1.1.3.1.2"><p id="p859016114165"><a name="p859016114165"></a><a name="p859016114165"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row75911811101617"><td class="cellrowborder" valign="top" width="26.06%" headers="mcps1.1.3.1.1 "><p id="p8591171115160"><a name="p8591171115160"></a><a name="p8591171115160"></a>Promise&lt;Array&lt;<a href="#section10701756164212">SignalInformation</a>&gt;&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="73.94%" headers="mcps1.1.3.1.2 "><p id="p159191118166"><a name="p159191118166"></a><a name="p159191118166"></a>以Promise形式返回网络信号强度<a href="#section10701756164212">SignalInformation</a>对象的数组。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let slotId = 0;
let promise = radio.getSignalInformation(slotId);
promise.then(data => {
console.log(`getSignalInformation success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.error(`getSignalInformation fail, promise: err->${JSON.stringify(err)}`);
});
```
## radio.isRadioOn<sup>7+</sup><a name="section5456161711228"></a>
isRadioOn\(callback: AsyncCallback<boolean\>\): void
判断Radio是否打开，使用callback方式作为异步方法。
需要ohos.permission.GET\_NETWORK\_INFO权限。
- 参数
<a name="table16621218192311"></a>
<table><thead align="left"><tr id="row16628188235"><th class="cellrowborder" valign="top" width="11.03%" id="mcps1.1.5.1.1"><p id="p766231810235"><a name="p766231810235"></a><a name="p766231810235"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="25.77%" id="mcps1.1.5.1.2"><p id="p4663131812313"><a name="p4663131812313"></a><a name="p4663131812313"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="14.45%" id="mcps1.1.5.1.3"><p id="p19663121892310"><a name="p19663121892310"></a><a name="p19663121892310"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="48.75%" id="mcps1.1.5.1.4"><p id="p11663418112315"><a name="p11663418112315"></a><a name="p11663418112315"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row166637182231"><td class="cellrowborder" valign="top" width="11.03%" headers="mcps1.1.5.1.1 "><p id="p116632186237"><a name="p116632186237"></a><a name="p116632186237"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="25.77%" headers="mcps1.1.5.1.2 "><p id="p12663518122318"><a name="p12663518122318"></a><a name="p12663518122318"></a>AsyncCallback&lt;boolean&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="14.45%" headers="mcps1.1.5.1.3 "><p id="p17663121813232"><a name="p17663121813232"></a><a name="p17663121813232"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="48.75%" headers="mcps1.1.5.1.4 "><p id="p766310184235"><a name="p766310184235"></a><a name="p766310184235"></a>回调函数。</p>
<p id="p12663101892317"><a name="p12663101892317"></a><a name="p12663101892317"></a>true：Radio打开</p>
<p id="p8663181852316"><a name="p8663181852316"></a><a name="p8663181852316"></a>false：Radio关闭</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
radio.isRadioOn((err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## radio.isRadioOn<sup>7+</sup><a name="section178817520243"></a>
isRadioOn\(\): Promise<boolean\>
判断Radio是否打开，使用Promise方式作为异步方法。
需要ohos.permission.GET\_NETWORK\_INFO权限。
- 返回值
<a name="table1089962622517"></a>
<table><thead align="left"><tr id="row1290042613253"><th class="cellrowborder" valign="top" width="26.419999999999998%" id="mcps1.1.3.1.1"><p id="p1590072682510"><a name="p1590072682510"></a><a name="p1590072682510"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="73.58%" id="mcps1.1.3.1.2"><p id="p1190042652517"><a name="p1190042652517"></a><a name="p1190042652517"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row14900152617253"><td class="cellrowborder" valign="top" width="26.419999999999998%" headers="mcps1.1.3.1.1 "><p id="p2900172614252"><a name="p2900172614252"></a><a name="p2900172614252"></a>Promise&lt;boolean&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="73.58%" headers="mcps1.1.3.1.2 "><p id="p11900182612518"><a name="p11900182612518"></a><a name="p11900182612518"></a>以Promise形式返回判断Radio是否打开的结果。</p>
<p id="p290052615251"><a name="p290052615251"></a><a name="p290052615251"></a>true：Radio打开</p>
<p id="p290018264259"><a name="p290018264259"></a><a name="p290018264259"></a>false：Radio关闭</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
let promise = radio.isRadioOn();
promise.then(data => {
console.log(`isRadioOn success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.error(`isRadioOn fail, promise: err->${JSON.stringify(err)}`);
});
```
## RadioTechnology<a name="section1072135204020"></a>
无线接入技术。
<a name="table0381514104112"></a>
<table><thead align="left"><tr id="row9381121434113"><th class="cellrowborder" valign="top" width="34.953495349534954%" id="mcps1.1.4.1.1"><p id="p1538171414110"><a name="p1538171414110"></a><a name="p1538171414110"></a>变量</p>
</th>
<th class="cellrowborder" valign="top" width="11.021102110211022%" id="mcps1.1.4.1.2"><p id="p923145715145"><a name="p923145715145"></a><a name="p923145715145"></a>值</p>
</th>
<th class="cellrowborder" valign="top" width="54.02540254025403%" id="mcps1.1.4.1.3"><p id="p738101484113"><a name="p738101484113"></a><a name="p738101484113"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row20381111417414"><td class="cellrowborder" valign="top" width="34.953495349534954%" headers="mcps1.1.4.1.1 "><p id="p18382151414110"><a name="p18382151414110"></a><a name="p18382151414110"></a>RADIO_TECHNOLOGY_UNKNOWN</p>
</td>
<td class="cellrowborder" valign="top" width="11.021102110211022%" headers="mcps1.1.4.1.2 "><p id="p1123125741418"><a name="p1123125741418"></a><a name="p1123125741418"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="54.02540254025403%" headers="mcps1.1.4.1.3 "><p id="p738221417411"><a name="p738221417411"></a><a name="p738221417411"></a>未知无线接入技术（RAT）。</p>
</td>
</tr>
<tr id="row6382171434119"><td class="cellrowborder" valign="top" width="34.953495349534954%" headers="mcps1.1.4.1.1 "><p id="p5382014134114"><a name="p5382014134114"></a><a name="p5382014134114"></a>RADIO_TECHNOLOGY_GSM</p>
</td>
<td class="cellrowborder" valign="top" width="11.021102110211022%" headers="mcps1.1.4.1.2 "><p id="p5231257131412"><a name="p5231257131412"></a><a name="p5231257131412"></a>1</p>
</td>
<td class="cellrowborder" valign="top" width="54.02540254025403%" headers="mcps1.1.4.1.3 "><p id="p1426645312125"><a name="p1426645312125"></a><a name="p1426645312125"></a>无线接入技术GSM（Global System For Mobile Communication）。</p>
</td>
</tr>
<tr id="row4382914104115"><td class="cellrowborder" valign="top" width="34.953495349534954%" headers="mcps1.1.4.1.1 "><p id="p10382181464115"><a name="p10382181464115"></a><a name="p10382181464115"></a>RADIO_TECHNOLOGY_1XRTT</p>
</td>
<td class="cellrowborder" valign="top" width="11.021102110211022%" headers="mcps1.1.4.1.2 "><p id="p823195781418"><a name="p823195781418"></a><a name="p823195781418"></a>2</p>
</td>
<td class="cellrowborder" valign="top" width="54.02540254025403%" headers="mcps1.1.4.1.3 "><p id="p63831214174116"><a name="p63831214174116"></a><a name="p63831214174116"></a>无线接入技术1XRTT（Single-Carrier Radio Transmission Technology）。</p>
</td>
</tr>
<tr id="row1383201444113"><td class="cellrowborder" valign="top" width="34.953495349534954%" headers="mcps1.1.4.1.1 "><p id="p16383121420413"><a name="p16383121420413"></a><a name="p16383121420413"></a>RADIO_TECHNOLOGY_WCDMA</p>
</td>
<td class="cellrowborder" valign="top" width="11.021102110211022%" headers="mcps1.1.4.1.2 "><p id="p172345717145"><a name="p172345717145"></a><a name="p172345717145"></a>3</p>
</td>
<td class="cellrowborder" valign="top" width="54.02540254025403%" headers="mcps1.1.4.1.3 "><p id="p838431454114"><a name="p838431454114"></a><a name="p838431454114"></a>无线接入技术WCDMA（Wideband Code Division Multiple Access）。</p>
</td>
</tr>
<tr id="row123841214204119"><td class="cellrowborder" valign="top" width="34.953495349534954%" headers="mcps1.1.4.1.1 "><p id="p19384314164111"><a name="p19384314164111"></a><a name="p19384314164111"></a>RADIO_TECHNOLOGY_HSPA</p>
</td>
<td class="cellrowborder" valign="top" width="11.021102110211022%" headers="mcps1.1.4.1.2 "><p id="p1023457161417"><a name="p1023457161417"></a><a name="p1023457161417"></a>4</p>
</td>
<td class="cellrowborder" valign="top" width="54.02540254025403%" headers="mcps1.1.4.1.3 "><p id="p153841414164111"><a name="p153841414164111"></a><a name="p153841414164111"></a>无线接入技术HSPA（High Speed Packet Access）。</p>
</td>
</tr>
<tr id="row1438561454118"><td class="cellrowborder" valign="top" width="34.953495349534954%" headers="mcps1.1.4.1.1 "><p id="p238581418410"><a name="p238581418410"></a><a name="p238581418410"></a>RADIO_TECHNOLOGY_HSPAP</p>
</td>
<td class="cellrowborder" valign="top" width="11.021102110211022%" headers="mcps1.1.4.1.2 "><p id="p623125720142"><a name="p623125720142"></a><a name="p623125720142"></a>5</p>
</td>
<td class="cellrowborder" valign="top" width="54.02540254025403%" headers="mcps1.1.4.1.3 "><p id="p654462715234"><a name="p654462715234"></a><a name="p654462715234"></a>无线接入技术HSPAP（High Speed packet access (HSPA+) ）。</p>
</td>
</tr>
<tr id="row153856148415"><td class="cellrowborder" valign="top" width="34.953495349534954%" headers="mcps1.1.4.1.1 "><p id="p153854146414"><a name="p153854146414"></a><a name="p153854146414"></a>RADIO_TECHNOLOGY_TD_SCDMA</p>
</td>
<td class="cellrowborder" valign="top" width="11.021102110211022%" headers="mcps1.1.4.1.2 "><p id="p5238578147"><a name="p5238578147"></a><a name="p5238578147"></a>6</p>
</td>
<td class="cellrowborder" valign="top" width="54.02540254025403%" headers="mcps1.1.4.1.3 "><p id="p73851614144114"><a name="p73851614144114"></a><a name="p73851614144114"></a>无线接入技术TDSCDMA（TimeDivision-Synchronous Code Division Multiple Access）。</p>
</td>
</tr>
<tr id="row20385914144118"><td class="cellrowborder" valign="top" width="34.953495349534954%" headers="mcps1.1.4.1.1 "><p id="p12386614144116"><a name="p12386614144116"></a><a name="p12386614144116"></a>RADIO_TECHNOLOGY_EVDO</p>
</td>
<td class="cellrowborder" valign="top" width="11.021102110211022%" headers="mcps1.1.4.1.2 "><p id="p13235578149"><a name="p13235578149"></a><a name="p13235578149"></a>7</p>
</td>
<td class="cellrowborder" valign="top" width="54.02540254025403%" headers="mcps1.1.4.1.3 "><p id="p18386214164119"><a name="p18386214164119"></a><a name="p18386214164119"></a>无线接入技术EVDO（Evolution、Data Only）。</p>
</td>
</tr>
<tr id="row14386181444117"><td class="cellrowborder" valign="top" width="34.953495349534954%" headers="mcps1.1.4.1.1 "><p id="p1386161420417"><a name="p1386161420417"></a><a name="p1386161420417"></a>RADIO_TECHNOLOGY_EHRPD</p>
</td>
<td class="cellrowborder" valign="top" width="11.021102110211022%" headers="mcps1.1.4.1.2 "><p id="p4236579145"><a name="p4236579145"></a><a name="p4236579145"></a>8</p>
</td>
<td class="cellrowborder" valign="top" width="54.02540254025403%" headers="mcps1.1.4.1.3 "><p id="p0815111425214"><a name="p0815111425214"></a><a name="p0815111425214"></a>无线接入技术EHRPD（Evolved High Rate Package Data）。</p>
</td>
</tr>
<tr id="row16389101413415"><td class="cellrowborder" valign="top" width="34.953495349534954%" headers="mcps1.1.4.1.1 "><p id="p1139091474115"><a name="p1139091474115"></a><a name="p1139091474115"></a>RADIO_TECHNOLOGY_LTE</p>
</td>
<td class="cellrowborder" valign="top" width="11.021102110211022%" headers="mcps1.1.4.1.2 "><p id="p122395715146"><a name="p122395715146"></a><a name="p122395715146"></a>9</p>
</td>
<td class="cellrowborder" valign="top" width="54.02540254025403%" headers="mcps1.1.4.1.3 "><p id="p639011418416"><a name="p639011418416"></a><a name="p639011418416"></a>无线接入技术LTE（Long Term Evolution）。</p>
</td>
</tr>
<tr id="row53901144414"><td class="cellrowborder" valign="top" width="34.953495349534954%" headers="mcps1.1.4.1.1 "><p id="p4390181484116"><a name="p4390181484116"></a><a name="p4390181484116"></a>RADIO_TECHNOLOGY_LTE_CA</p>
</td>
<td class="cellrowborder" valign="top" width="11.021102110211022%" headers="mcps1.1.4.1.2 "><p id="p162385719147"><a name="p162385719147"></a><a name="p162385719147"></a>10</p>
</td>
<td class="cellrowborder" valign="top" width="54.02540254025403%" headers="mcps1.1.4.1.3 "><p id="p16390121464116"><a name="p16390121464116"></a><a name="p16390121464116"></a>无线接入技术LTE_CA（Long Term Evolution_Carrier Aggregation）。</p>
</td>
</tr>
<tr id="row43905141411"><td class="cellrowborder" valign="top" width="34.953495349534954%" headers="mcps1.1.4.1.1 "><p id="p1739091414110"><a name="p1739091414110"></a><a name="p1739091414110"></a>RADIO_TECHNOLOGY_IWLAN</p>
</td>
<td class="cellrowborder" valign="top" width="11.021102110211022%" headers="mcps1.1.4.1.2 "><p id="p8232057121414"><a name="p8232057121414"></a><a name="p8232057121414"></a>11</p>
</td>
<td class="cellrowborder" valign="top" width="54.02540254025403%" headers="mcps1.1.4.1.3 "><p id="p9391191474110"><a name="p9391191474110"></a><a name="p9391191474110"></a>无线接入技术IWLAN（Industrial Wireless LAN）。</p>
</td>
</tr>
<tr id="row153917149411"><td class="cellrowborder" valign="top" width="34.953495349534954%" headers="mcps1.1.4.1.1 "><p id="p239118143418"><a name="p239118143418"></a><a name="p239118143418"></a>RADIO_TECHNOLOGY_NR</p>
</td>
<td class="cellrowborder" valign="top" width="11.021102110211022%" headers="mcps1.1.4.1.2 "><p id="p7237573146"><a name="p7237573146"></a><a name="p7237573146"></a>12</p>
</td>
<td class="cellrowborder" valign="top" width="54.02540254025403%" headers="mcps1.1.4.1.3 "><p id="p9391121419416"><a name="p9391121419416"></a><a name="p9391121419416"></a>无线接入技术NR（New Radio）。</p>
</td>
</tr>
</tbody>
</table>
## SignalInformation<a name="section10701756164212"></a>
网络信号强度信息对象。
<a name="table15599174814312"></a>
<table><thead align="left"><tr id="row125991548184313"><th class="cellrowborder" valign="top" width="34.4034403440344%" id="mcps1.1.4.1.1"><p id="p17599848174311"><a name="p17599848174311"></a><a name="p17599848174311"></a>属性名</p>
</th>
<th class="cellrowborder" valign="top" width="20.89208920892089%" id="mcps1.1.4.1.2"><p id="p165996488433"><a name="p165996488433"></a><a name="p165996488433"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="44.704470447044706%" id="mcps1.1.4.1.3"><p id="p559954854315"><a name="p559954854315"></a><a name="p559954854315"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1360044844315"><td class="cellrowborder" valign="top" width="34.4034403440344%" headers="mcps1.1.4.1.1 "><p id="p2600154864317"><a name="p2600154864317"></a><a name="p2600154864317"></a>signalType</p>
</td>
<td class="cellrowborder" valign="top" width="20.89208920892089%" headers="mcps1.1.4.1.2 "><p id="p1960014844311"><a name="p1960014844311"></a><a name="p1960014844311"></a><a href="#section519718112466">NetworkType</a></p>
</td>
<td class="cellrowborder" valign="top" width="44.704470447044706%" headers="mcps1.1.4.1.3 "><p id="p760084810435"><a name="p760084810435"></a><a name="p760084810435"></a>网络信号强度类型。</p>
</td>
</tr>
<tr id="row5600648124317"><td class="cellrowborder" valign="top" width="34.4034403440344%" headers="mcps1.1.4.1.1 "><p id="p1060014884311"><a name="p1060014884311"></a><a name="p1060014884311"></a>signalLevel</p>
</td>
<td class="cellrowborder" valign="top" width="20.89208920892089%" headers="mcps1.1.4.1.2 "><p id="p14600144814436"><a name="p14600144814436"></a><a name="p14600144814436"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="44.704470447044706%" headers="mcps1.1.4.1.3 "><p id="p1360094874317"><a name="p1360094874317"></a><a name="p1360094874317"></a>网络信号强度等级。</p>
</td>
</tr>
</tbody>
</table>
## NetworkType<a name="section519718112466"></a>
网络类型。
<a name="table169468114719"></a>
<table><thead align="left"><tr id="row19946141204716"><th class="cellrowborder" valign="top" width="29.59%" id="mcps1.1.4.1.1"><p id="p19946111184714"><a name="p19946111184714"></a><a name="p19946111184714"></a>变量</p>
</th>
<th class="cellrowborder" valign="top" width="11.85%" id="mcps1.1.4.1.2"><p id="p199467115477"><a name="p199467115477"></a><a name="p199467115477"></a>值</p>
</th>
<th class="cellrowborder" valign="top" width="58.56%" id="mcps1.1.4.1.3"><p id="p1387273215116"><a name="p1387273215116"></a><a name="p1387273215116"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row18947191134714"><td class="cellrowborder" valign="top" width="29.59%" headers="mcps1.1.4.1.1 "><p id="p10947215473"><a name="p10947215473"></a><a name="p10947215473"></a>NETWORK_TYPE_UNKNOWN</p>
</td>
<td class="cellrowborder" valign="top" width="11.85%" headers="mcps1.1.4.1.2 "><p id="p694715114717"><a name="p694715114717"></a><a name="p694715114717"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="58.56%" headers="mcps1.1.4.1.3 "><p id="p13872123215111"><a name="p13872123215111"></a><a name="p13872123215111"></a>未知网络类型。</p>
</td>
</tr>
<tr id="row19947512478"><td class="cellrowborder" valign="top" width="29.59%" headers="mcps1.1.4.1.1 "><p id="p1994716112477"><a name="p1994716112477"></a><a name="p1994716112477"></a>NETWORK_TYPE_GSM</p>
</td>
<td class="cellrowborder" valign="top" width="11.85%" headers="mcps1.1.4.1.2 "><p id="p09471311474"><a name="p09471311474"></a><a name="p09471311474"></a>1</p>
</td>
<td class="cellrowborder" valign="top" width="58.56%" headers="mcps1.1.4.1.3 "><p id="p18872133231117"><a name="p18872133231117"></a><a name="p18872133231117"></a>网络类型为GSM（Global System For Mobile Communication）。</p>
</td>
</tr>
<tr id="row194716112479"><td class="cellrowborder" valign="top" width="29.59%" headers="mcps1.1.4.1.1 "><p id="p5947181154720"><a name="p5947181154720"></a><a name="p5947181154720"></a>NETWORK_TYPE_CDMA</p>
</td>
<td class="cellrowborder" valign="top" width="11.85%" headers="mcps1.1.4.1.2 "><p id="p494861154718"><a name="p494861154718"></a><a name="p494861154718"></a>2</p>
</td>
<td class="cellrowborder" valign="top" width="58.56%" headers="mcps1.1.4.1.3 "><p id="p76281531111318"><a name="p76281531111318"></a><a name="p76281531111318"></a>网络类型为CDMA（Code Division Multiple Access）。</p>
</td>
</tr>
<tr id="row294817154719"><td class="cellrowborder" valign="top" width="29.59%" headers="mcps1.1.4.1.1 "><p id="p6948121134711"><a name="p6948121134711"></a><a name="p6948121134711"></a>NETWORK_TYPE_WCDMA</p>
</td>
<td class="cellrowborder" valign="top" width="11.85%" headers="mcps1.1.4.1.2 "><p id="p11948612475"><a name="p11948612475"></a><a name="p11948612475"></a>3</p>
</td>
<td class="cellrowborder" valign="top" width="58.56%" headers="mcps1.1.4.1.3 "><p id="p956153291315"><a name="p956153291315"></a><a name="p956153291315"></a>网络类型为WCDMA（Wideband Code Division Multiple Access）。</p>
</td>
</tr>
<tr id="row1794817118475"><td class="cellrowborder" valign="top" width="29.59%" headers="mcps1.1.4.1.1 "><p id="p8948311475"><a name="p8948311475"></a><a name="p8948311475"></a>NETWORK_TYPE_TDSCDMA</p>
</td>
<td class="cellrowborder" valign="top" width="11.85%" headers="mcps1.1.4.1.2 "><p id="p39492134718"><a name="p39492134718"></a><a name="p39492134718"></a>4</p>
</td>
<td class="cellrowborder" valign="top" width="58.56%" headers="mcps1.1.4.1.3 "><p id="p17358203301314"><a name="p17358203301314"></a><a name="p17358203301314"></a>网络类型为TDSCDMA（TimeDivision-Synchronous Code Division Multiple Access）。</p>
</td>
</tr>
<tr id="row39491314476"><td class="cellrowborder" valign="top" width="29.59%" headers="mcps1.1.4.1.1 "><p id="p139491712474"><a name="p139491712474"></a><a name="p139491712474"></a>NETWORK_TYPE_LTE</p>
</td>
<td class="cellrowborder" valign="top" width="11.85%" headers="mcps1.1.4.1.2 "><p id="p139493113479"><a name="p139493113479"></a><a name="p139493113479"></a>5</p>
</td>
<td class="cellrowborder" valign="top" width="58.56%" headers="mcps1.1.4.1.3 "><p id="p17282834141317"><a name="p17282834141317"></a><a name="p17282834141317"></a>网络类型为LTE（Long Term Evolution）。</p>
</td>
</tr>
<tr id="row7949515473"><td class="cellrowborder" valign="top" width="29.59%" headers="mcps1.1.4.1.1 "><p id="p20950151114718"><a name="p20950151114718"></a><a name="p20950151114718"></a>NETWORK_TYPE_NR</p>
</td>
<td class="cellrowborder" valign="top" width="11.85%" headers="mcps1.1.4.1.2 "><p id="p1950131164710"><a name="p1950131164710"></a><a name="p1950131164710"></a>6</p>
</td>
<td class="cellrowborder" valign="top" width="58.56%" headers="mcps1.1.4.1.3 "><p id="p12872143291113"><a name="p12872143291113"></a><a name="p12872143291113"></a>网络类型为5G NR（New Radio）。</p>
</td>
</tr>
</tbody>
</table>
## NetworkState<a name="section1691213911470"></a>
网络注册状态。
<a name="table14636181774820"></a>
<table><thead align="left"><tr id="row1263781714819"><th class="cellrowborder" valign="top" width="21.57%" id="mcps1.1.4.1.1"><p id="p8637131764817"><a name="p8637131764817"></a><a name="p8637131764817"></a>变量</p>
</th>
<th class="cellrowborder" valign="top" width="17.14%" id="mcps1.1.4.1.2"><p id="p16637317174815"><a name="p16637317174815"></a><a name="p16637317174815"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.4.1.3"><p id="p1041654112217"><a name="p1041654112217"></a><a name="p1041654112217"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row15637917164813"><td class="cellrowborder" valign="top" width="21.57%" headers="mcps1.1.4.1.1 "><p id="p17637617174816"><a name="p17637617174816"></a><a name="p17637617174816"></a>longOperatorName</p>
</td>
<td class="cellrowborder" valign="top" width="17.14%" headers="mcps1.1.4.1.2 "><p id="p86378179487"><a name="p86378179487"></a><a name="p86378179487"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.4.1.3 "><p id="p124161741172213"><a name="p124161741172213"></a><a name="p124161741172213"></a>注册网络的长运营商名称。</p>
</td>
</tr>
<tr id="row963719172483"><td class="cellrowborder" valign="top" width="21.57%" headers="mcps1.1.4.1.1 "><p id="p6637131716488"><a name="p6637131716488"></a><a name="p6637131716488"></a>shortOperatorName</p>
</td>
<td class="cellrowborder" valign="top" width="17.14%" headers="mcps1.1.4.1.2 "><p id="p8638417184820"><a name="p8638417184820"></a><a name="p8638417184820"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.4.1.3 "><p id="p16416174117229"><a name="p16416174117229"></a><a name="p16416174117229"></a>注册网络的短运营商名称。</p>
</td>
</tr>
<tr id="row15638917184813"><td class="cellrowborder" valign="top" width="21.57%" headers="mcps1.1.4.1.1 "><p id="p063891718484"><a name="p063891718484"></a><a name="p063891718484"></a>plmnNumeric</p>
</td>
<td class="cellrowborder" valign="top" width="17.14%" headers="mcps1.1.4.1.2 "><p id="p126387173485"><a name="p126387173485"></a><a name="p126387173485"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.4.1.3 "><p id="p54168419229"><a name="p54168419229"></a><a name="p54168419229"></a>注册网络的PLMN码。</p>
</td>
</tr>
<tr id="row663811784813"><td class="cellrowborder" valign="top" width="21.57%" headers="mcps1.1.4.1.1 "><p id="p1263811712484"><a name="p1263811712484"></a><a name="p1263811712484"></a>isRoaming</p>
</td>
<td class="cellrowborder" valign="top" width="17.14%" headers="mcps1.1.4.1.2 "><p id="p13638181734816"><a name="p13638181734816"></a><a name="p13638181734816"></a>boolean</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.4.1.3 "><p id="p9416114118220"><a name="p9416114118220"></a><a name="p9416114118220"></a>是否处于漫游状态。</p>
</td>
</tr>
<tr id="row063861734816"><td class="cellrowborder" valign="top" width="21.57%" headers="mcps1.1.4.1.1 "><p id="p116394172485"><a name="p116394172485"></a><a name="p116394172485"></a>regState</p>
</td>
<td class="cellrowborder" valign="top" width="17.14%" headers="mcps1.1.4.1.2 "><p id="p1963951713482"><a name="p1963951713482"></a><a name="p1963951713482"></a><a href="#section18174131911514">RegState</a></p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.4.1.3 "><p id="p12416114142214"><a name="p12416114142214"></a><a name="p12416114142214"></a>设备的网络注册状态。</p>
</td>
</tr>
<tr id="row963941719485"><td class="cellrowborder" valign="top" width="21.57%" headers="mcps1.1.4.1.1 "><p id="p1763919175480"><a name="p1763919175480"></a><a name="p1763919175480"></a>nsaState</p>
</td>
<td class="cellrowborder" valign="top" width="17.14%" headers="mcps1.1.4.1.2 "><p id="p13639111794814"><a name="p13639111794814"></a><a name="p13639111794814"></a><a href="#section448018155317">NsaState</a></p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.4.1.3 "><p id="p641684114224"><a name="p641684114224"></a><a name="p641684114224"></a>设备的NSA网络注册状态。</p>
</td>
</tr>
<tr id="row163901754816"><td class="cellrowborder" valign="top" width="21.57%" headers="mcps1.1.4.1.1 "><p id="p10639181717481"><a name="p10639181717481"></a><a name="p10639181717481"></a>isCaActive</p>
</td>
<td class="cellrowborder" valign="top" width="17.14%" headers="mcps1.1.4.1.2 "><p id="p96391178489"><a name="p96391178489"></a><a name="p96391178489"></a>boolean</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.4.1.3 "><p id="p10416124119227"><a name="p10416124119227"></a><a name="p10416124119227"></a>CA的状态。</p>
</td>
</tr>
<tr id="row126392017124814"><td class="cellrowborder" valign="top" width="21.57%" headers="mcps1.1.4.1.1 "><p id="p1164061784815"><a name="p1164061784815"></a><a name="p1164061784815"></a>isEmergency</p>
</td>
<td class="cellrowborder" valign="top" width="17.14%" headers="mcps1.1.4.1.2 "><p id="p56401317204812"><a name="p56401317204812"></a><a name="p56401317204812"></a>boolean</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.4.1.3 "><p id="p1141624122217"><a name="p1141624122217"></a><a name="p1141624122217"></a>此设备是否只允许拨打紧急呼叫。</p>
</td>
</tr>
</tbody>
</table>
## RegState<a name="section18174131911514"></a>
网络注册状态。
<a name="table10902144118519"></a>
<table><thead align="left"><tr id="row1290316411519"><th class="cellrowborder" valign="top" width="39.89%" id="mcps1.1.4.1.1"><p id="p13903441175110"><a name="p13903441175110"></a><a name="p13903441175110"></a>变量</p>
</th>
<th class="cellrowborder" valign="top" width="8.6%" id="mcps1.1.4.1.2"><p id="p114671121109"><a name="p114671121109"></a><a name="p114671121109"></a>值</p>
</th>
<th class="cellrowborder" valign="top" width="51.51%" id="mcps1.1.4.1.3"><p id="p15903144110513"><a name="p15903144110513"></a><a name="p15903144110513"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row890394125118"><td class="cellrowborder" valign="top" width="39.89%" headers="mcps1.1.4.1.1 "><p id="p4903114117517"><a name="p4903114117517"></a><a name="p4903114117517"></a>REG_STATE_NO_SERVICE</p>
</td>
<td class="cellrowborder" valign="top" width="8.6%" headers="mcps1.1.4.1.2 "><p id="p63116311601"><a name="p63116311601"></a><a name="p63116311601"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="51.51%" headers="mcps1.1.4.1.3 "><p id="p11904204116516"><a name="p11904204116516"></a><a name="p11904204116516"></a>设备不能使用任何服务。</p>
</td>
</tr>
<tr id="row69041416512"><td class="cellrowborder" valign="top" width="39.89%" headers="mcps1.1.4.1.1 "><p id="p1990464145113"><a name="p1990464145113"></a><a name="p1990464145113"></a>REG_STATE_IN_SERVICE</p>
</td>
<td class="cellrowborder" valign="top" width="8.6%" headers="mcps1.1.4.1.2 "><p id="p12318311201"><a name="p12318311201"></a><a name="p12318311201"></a>1</p>
</td>
<td class="cellrowborder" valign="top" width="51.51%" headers="mcps1.1.4.1.3 "><p id="p5904124117510"><a name="p5904124117510"></a><a name="p5904124117510"></a>设备可以正常使用业务。</p>
</td>
</tr>
<tr id="row1790444111513"><td class="cellrowborder" valign="top" width="39.89%" headers="mcps1.1.4.1.1 "><p id="p4904124115114"><a name="p4904124115114"></a><a name="p4904124115114"></a>REG_STATE_EMERGENCY_CALL_ONLY</p>
</td>
<td class="cellrowborder" valign="top" width="8.6%" headers="mcps1.1.4.1.2 "><p id="p831103116014"><a name="p831103116014"></a><a name="p831103116014"></a>2</p>
</td>
<td class="cellrowborder" valign="top" width="51.51%" headers="mcps1.1.4.1.3 "><p id="p2905164125113"><a name="p2905164125113"></a><a name="p2905164125113"></a>设备只能使用紧急呼叫业务。</p>
</td>
</tr>
<tr id="row13905134155112"><td class="cellrowborder" valign="top" width="39.89%" headers="mcps1.1.4.1.1 "><p id="p2090554114517"><a name="p2090554114517"></a><a name="p2090554114517"></a>REG_STATE_POWER_OFF</p>
</td>
<td class="cellrowborder" valign="top" width="8.6%" headers="mcps1.1.4.1.2 "><p id="p17311831701"><a name="p17311831701"></a><a name="p17311831701"></a>3</p>
</td>
<td class="cellrowborder" valign="top" width="51.51%" headers="mcps1.1.4.1.3 "><p id="p49051241195116"><a name="p49051241195116"></a><a name="p49051241195116"></a>蜂窝无线电已关闭。</p>
</td>
</tr>
</tbody>
</table>
## NsaState<a name="section448018155317"></a>
非独立组网状态。
<a name="table14733122165317"></a>
<table><thead align="left"><tr id="row17734172155311"><th class="cellrowborder" valign="top" width="31.64%" id="mcps1.1.4.1.1"><p id="p573442114538"><a name="p573442114538"></a><a name="p573442114538"></a>变量</p>
</th>
<th class="cellrowborder" valign="top" width="8.19%" id="mcps1.1.4.1.2"><p id="p93344475918"><a name="p93344475918"></a><a name="p93344475918"></a>值</p>
</th>
<th class="cellrowborder" valign="top" width="60.17%" id="mcps1.1.4.1.3"><p id="p147341921155319"><a name="p147341921155319"></a><a name="p147341921155319"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1973402111537"><td class="cellrowborder" valign="top" width="31.64%" headers="mcps1.1.4.1.1 "><p id="p1073502120538"><a name="p1073502120538"></a><a name="p1073502120538"></a>NSA_STATE_NOT_SUPPORT</p>
</td>
<td class="cellrowborder" valign="top" width="8.19%" headers="mcps1.1.4.1.2 "><p id="p941614817596"><a name="p941614817596"></a><a name="p941614817596"></a>1</p>
</td>
<td class="cellrowborder" valign="top" width="60.17%" headers="mcps1.1.4.1.3 "><p id="p207355214533"><a name="p207355214533"></a><a name="p207355214533"></a>设备在不支持NSA的LTE小区下处于空闲状态或连接状态。</p>
</td>
</tr>
<tr id="row773514215536"><td class="cellrowborder" valign="top" width="31.64%" headers="mcps1.1.4.1.1 "><p id="p273552135316"><a name="p273552135316"></a><a name="p273552135316"></a>NSA_STATE_NO_DETECT</p>
</td>
<td class="cellrowborder" valign="top" width="8.19%" headers="mcps1.1.4.1.2 "><p id="p24167488593"><a name="p24167488593"></a><a name="p24167488593"></a>2</p>
</td>
<td class="cellrowborder" valign="top" width="60.17%" headers="mcps1.1.4.1.3 "><p id="p1973562110534"><a name="p1973562110534"></a><a name="p1973562110534"></a>在支持NSA但不支持NR覆盖检测的LTE小区下，设备处于空闲状态。</p>
</td>
</tr>
<tr id="row073512214530"><td class="cellrowborder" valign="top" width="31.64%" headers="mcps1.1.4.1.1 "><p id="p1873615217534"><a name="p1873615217534"></a><a name="p1873615217534"></a>NSA_STATE_CONNECTED_DETECT</p>
</td>
<td class="cellrowborder" valign="top" width="8.19%" headers="mcps1.1.4.1.2 "><p id="p164163487594"><a name="p164163487594"></a><a name="p164163487594"></a>3</p>
</td>
<td class="cellrowborder" valign="top" width="60.17%" headers="mcps1.1.4.1.3 "><p id="p14601215104116"><a name="p14601215104116"></a><a name="p14601215104116"></a>设备在LTE小区下连接到LTE网络支持NSA和NR覆盖检测。</p>
</td>
</tr>
<tr id="row873672165310"><td class="cellrowborder" valign="top" width="31.64%" headers="mcps1.1.4.1.1 "><p id="p1873642117539"><a name="p1873642117539"></a><a name="p1873642117539"></a>NSA_STATE_IDLE_DETECT</p>
</td>
<td class="cellrowborder" valign="top" width="8.19%" headers="mcps1.1.4.1.2 "><p id="p141714484593"><a name="p141714484593"></a><a name="p141714484593"></a>4</p>
</td>
<td class="cellrowborder" valign="top" width="60.17%" headers="mcps1.1.4.1.3 "><p id="p0736122115536"><a name="p0736122115536"></a><a name="p0736122115536"></a>支持NSA和NR覆盖检测的LTE小区下设备处于空闲状态。</p>
</td>
</tr>
<tr id="row5736132165315"><td class="cellrowborder" valign="top" width="31.64%" headers="mcps1.1.4.1.1 "><p id="p47378214537"><a name="p47378214537"></a><a name="p47378214537"></a>NSA_STATE_DUAL_CONNECTED</p>
</td>
<td class="cellrowborder" valign="top" width="8.19%" headers="mcps1.1.4.1.2 "><p id="p7417144895917"><a name="p7417144895917"></a><a name="p7417144895917"></a>5</p>
</td>
<td class="cellrowborder" valign="top" width="60.17%" headers="mcps1.1.4.1.3 "><p id="p273710215539"><a name="p273710215539"></a><a name="p273710215539"></a>设备在支持NSA的LTE小区下连接到LTE + NR网络。</p>
</td>
</tr>
<tr id="row17737121165319"><td class="cellrowborder" valign="top" width="31.64%" headers="mcps1.1.4.1.1 "><p id="p1873732111538"><a name="p1873732111538"></a><a name="p1873732111538"></a>NSA_STATE_SA_ATTACHED</p>
</td>
<td class="cellrowborder" valign="top" width="8.19%" headers="mcps1.1.4.1.2 "><p id="p2417154810591"><a name="p2417154810591"></a><a name="p2417154810591"></a>6</p>
</td>
<td class="cellrowborder" valign="top" width="60.17%" headers="mcps1.1.4.1.3 "><p id="p197371921165317"><a name="p197371921165317"></a><a name="p197371921165317"></a>设备在5GC附着时在NG-RAN小区下空闲或连接到NG-RAN小区。</p>
</td>
</tr>
</tbody>
</table>
## NetworkSelectionMode<a name="section14219361268"></a>
选网模式。
<a name="table15891165716617"></a>
<table><thead align="left"><tr id="row689105713614"><th class="cellrowborder" valign="top" width="33.78%" id="mcps1.1.4.1.1"><p id="p589165719612"><a name="p589165719612"></a><a name="p589165719612"></a>变量</p>
</th>
<th class="cellrowborder" valign="top" width="15.43%" id="mcps1.1.4.1.2"><p id="p889114571869"><a name="p889114571869"></a><a name="p889114571869"></a>值</p>
</th>
<th class="cellrowborder" valign="top" width="50.79%" id="mcps1.1.4.1.3"><p id="p04101554174620"><a name="p04101554174620"></a><a name="p04101554174620"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1589117571365"><td class="cellrowborder" valign="top" width="33.78%" headers="mcps1.1.4.1.1 "><p id="p1989275716618"><a name="p1989275716618"></a><a name="p1989275716618"></a>NETWORK_SELECTION_UNKNOWN</p>
</td>
<td class="cellrowborder" valign="top" width="15.43%" headers="mcps1.1.4.1.2 "><p id="p178921578616"><a name="p178921578616"></a><a name="p178921578616"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50.79%" headers="mcps1.1.4.1.3 "><p id="p541011547461"><a name="p541011547461"></a><a name="p541011547461"></a>未知选网模式。</p>
</td>
</tr>
<tr id="row1089245714617"><td class="cellrowborder" valign="top" width="33.78%" headers="mcps1.1.4.1.1 "><p id="p18921557369"><a name="p18921557369"></a><a name="p18921557369"></a>NETWORK_SELECTION_AUTOMATIC</p>
</td>
<td class="cellrowborder" valign="top" width="15.43%" headers="mcps1.1.4.1.2 "><p id="p489255718612"><a name="p489255718612"></a><a name="p489255718612"></a>1</p>
</td>
<td class="cellrowborder" valign="top" width="50.79%" headers="mcps1.1.4.1.3 "><p id="p104105544465"><a name="p104105544465"></a><a name="p104105544465"></a>自动选网模式。</p>
</td>
</tr>
<tr id="row13892155719619"><td class="cellrowborder" valign="top" width="33.78%" headers="mcps1.1.4.1.1 "><p id="p18921571165"><a name="p18921571165"></a><a name="p18921571165"></a>NETWORK_SELECTION_MANUAL</p>
</td>
<td class="cellrowborder" valign="top" width="15.43%" headers="mcps1.1.4.1.2 "><p id="p1489345710611"><a name="p1489345710611"></a><a name="p1489345710611"></a>2</p>
</td>
<td class="cellrowborder" valign="top" width="50.79%" headers="mcps1.1.4.1.3 "><p id="p741015444617"><a name="p741015444617"></a><a name="p741015444617"></a>手动选网模式。</p>
</td>
</tr>
</tbody>
</table>
\ No newline at end of file
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或