鸿蒙开发电话服务：ohos.telephony.sms之短信服务

jf_46214456 2024-06-17 468

电子说

1.3w人已加入

描述

短信服务

说明：
开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import sms from '@ohos.telephony.sms';

sms.createMessage

createMessage(pdu: Array, specification: string, callback: AsyncCallback): void

根据协议数据单元（PDU）和指定的短信协议创建短信实例，使用callback方式作为异步方法。

系统能力 ：SystemCapability.Telephony.SmsMms

参数：

参数名类型必填说明
pduArray是协议数据单元，从收到的信息中获取。
specificationstring是短信协议类型。 - 3gpp表示GSM/UMTS/LTE SMS - 3gpp2表示CDMA SMS
callbackAsyncCallback<[ShortMessage]>是回调函数。

示例：

const specification = '3gpp';
// 以数组的形式显示协议数据单元（PDU），类型为number，例如[0x08, 0x91, ...]
const pdu = [0x08, 0x91];
sms.createMessage(pdu, specification, (err, data) = > {
    console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});

sms.createMessage

createMessage(pdu: Array, specification: string): Promise

根据协议数据单元（PDU）和指定的短信协议创建短信实例，使用Promise方式作为异步方法。

系统能力 ：SystemCapability.Telephony.SmsMms

参数：

参数名类型必填说明
pduArray是协议数据单元，从收到的信息中获取。
specificationstring是短信协议类型。 - 3gpp表示GSM/UMTS/LTE SMS - 3gpp2表示CDMA SMS

返回值：

类型说明
Promise<[ShortMessage]>以Promise形式返回创建的短信实例。

示例：

const specification = '3gpp';
// 以数组的形式显示协议数据单元（PDU），类型为number，例如[0x08, 0x91, ...]
const 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

sendMessage(options: SendMessageOptions): void

发送短信。

需要权限 ：ohos.permission.SEND_MESSAGES

系统能力 ：SystemCapability.Telephony.SmsMms

参数：

参数名类型必填说明
options[SendMessageOptions]是发送短信的参数和回调，参考[SendMessageOptions]。

示例：

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.getDefaultSmsSlotId7+

getDefaultSmsSlotId(callback: AsyncCallback): void

获取发送短信的默认SIM卡槽ID，使用callback方式作为异步方法。

系统能力 ：SystemCapability.Telephony.SmsMms

参数：

参数名类型必填说明
callbackAsyncCallback是回调函数。 - 0：卡槽1 - 1：卡槽2

示例：

sms.getDefaultSmsSlotId((err, data) = > {
    console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});

sms.getDefaultSmsSlotId7+

getDefaultSmsSlotId(): Promise

获取发送短信的默认SIM卡槽ID，使用Promise方式作为异步方法。

系统能力 ：SystemCapability.Telephony.SmsMms

返回值：

类型说明
Promise以Promise形式返回发送短信的默认SIM卡： - 0：卡槽1 - 1：卡槽2

示例：

let promise = sms.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.setSmscAddr7+

setSmscAddr(slotId: number, smscAddr: string, callback: AsyncCallback): void

设置短信服务中心（SMSC）地址，使用callback方式作为异步方法。

需要权限 ：ohos.permission.SET_TELEPHONY_STATE，该权限为系统权限

系统能力 ：SystemCapability.Telephony.SmsMms

系统API ：该接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
slotIdnumber是SIM卡槽ID： - 0：卡槽1 - 1：卡槽2
smscAddrstring是短信服务中心地址。
callbackAsyncCallback是回调函数。

示例：

let slotId = 0;
let smscAddr = '+861xxxxxxxxxx';
sms.setSmscAddr(slotId, smscAddr, (err,data) = > {
      console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});

sms.setSmscAddr7+

setSmscAddr(slotId: number, smscAddr: string): Promise

设置短信服务中心（SMSC）地址，使用Promise方式作为异步方法。

需要权限 ：ohos.permission.SET_TELEPHONY_STATE，该权限为系统权限

系统能力 ：SystemCapability.Telephony.SmsMms

系统API ：该接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
slotIdnumber是SIM卡槽ID： - 0：卡槽1 - 1：卡槽2
smscAddrstring是短信服务中心地址。

返回值：

类型说明
Promise以Promise形式异步返回设置结果。

示例：

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.getSmscAddr7+

getSmscAddr(slotId: number, callback: AsyncCallback): void

获取短信服务中心（SMSC）地址，使用callback方式作为异步方法。

需要权限 ：ohos.permission.GET_TELEPHONY_STATE，该权限为系统权限

系统能力 ：SystemCapability.Telephony.SmsMms

系统API ：该接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
slotIdnumber是SIM卡槽ID： - 0：卡槽1 - 1：卡槽2
callbackAsyncCallback是回调函数。

示例：

let slotId = 0;
sms.getSmscAddr(slotId, (err, data) = > {
      console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});

sms.getSmscAddr7+

getSmscAddr(slotId: number): Promise

获取短信服务中心（SMSC）地址，使用Promise方式作为异步方法。

需要权限 ：ohos.permission.GET_TELEPHONY_STATE，该权限为系统权限

系统能力 ：SystemCapability.Telephony.SmsMms

系统API ：该接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
slotIdnumber是SIM卡槽ID： - 0：卡槽1 - 1：卡槽2

返回值：

类型说明
Promise以Promise形式返回获取短信服务中心地址的结果。

示例：

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)}`);
});

sms.hasSmsCapability7+

hasSmsCapability(): boolean

检查当前设备是否具备短信发送和接收能力，该方法是同步方法。

系统能力 ：SystemCapability.Telephony.SmsMms

返回值：

类型说明
boolean- true：设备具备短信发送和接收能力 - false：设备不具备短信发送和接收能力
let result = sms.hasSmsCapability(); 
console.log(`hasSmsCapability: ${JSON.stringify(result)}`);

ShortMessage

短信实例。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Telephony.SmsMms。

参数名类型说明
hasReplyPathboolean收到的短信是否包含“TP-Reply-Path”，默认为false。 “TP-Reply-Path”：设备根据发送SMS消息的短消息中心进行回复。
isReplaceMessageboolean收到的短信是否为“替换短信”，默认为false。 “替换短信”有关详细信息，参见 “3GPP TS 23.040 9.2.3.9”。
isSmsStatusReportMessageboolean当前消息是否为“短信状态报告”，默认为false。 “短信状态报告”是一种特定格式的短信，被用来从Service Center到Mobile Station传送状态报告。
messageClass[ShortMessageClass]短信类型。
pduArraySMS消息中的协议数据单元 （PDU）。
protocolIdnumber发送短信时使用的协议标识。
scAddressstring短消息服务中心（SMSC）地址。
scTimestampnumberSMSC时间戳。
statusnumberSMS-STATUS-REPORT消息中的短信状态指示短信服务中心（SMSC）发送的短信状态。
visibleMessageBodystring短信正文。
visibleRawAddressstring发送者地址。

ShortMessageClass

短信类型。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Telephony.SmsMms。

名称值说明
UNKNOWN0未知类型。
INSTANT_MESSAGE1即时消息，收到后立即显示。
OPTIONAL_MESSAGE2存储在设备或SIM卡上的短信。
SIM_MESSAGE3包含SIM卡信息的短信，需要存储在SIM卡中。
FORWARD_MESSAGE4要转发到另一台设备的短信。

SendMessageOptions

发送短信的参数和回调。根据SendMessageOptions中的可选参数content的值判断短信类型。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Telephony.SmsMms。

参数名类型必填说明
slotIdnumber是用于发送短信的SIM卡槽ID： - 0：卡槽1 - 1：卡槽2
destinationHoststring是短信的发送地址。
contentstringArray是
serviceCenterstring否短信中心地址。默认使用SIM卡中的短信中心地址。
destinationPortnumber否如果发送数据消息，destinationPort 是必需的。否则是可选的。
sendCallbackAsyncCallback<[ISendShortMessageCallback]>否短信发送结果回调，返回短信发送的结果，参考[ISendShortMessageCallback]。
deliveryCallbackAsyncCallback<[IDeliveryShortMessageCallback]>否短信送达结果回调，返回短信递送报告，参考[IDeliveryShortMessageCallback]。

ISendShortMessageCallback

回调实例。返回短信发送结果、存储已发送短信的URI和是否为长短信的最后一部分。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Telephony.SmsMms。

参数名类型必填说明
isLastPartboolean否指定这是否是长短信的最后一部分。true表示这是长短信的最后一部分，false表示不是。默认为false。
result[SendSmsResult]是短信发送结果。
urlstring是存储发送短信的URI。

IDeliveryShortMessageCallback

回调实例。返回短信送达报告。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Telephony.SmsMms。

参数名类型必填说明
pduArray是短信送达报告。HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿

鸿蒙

SendSmsResult

短信发送结果。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Telephony.SmsMms。

名称值说明
SEND_SMS_SUCCESS0发送短信成功。
SEND_SMS_FAILURE_UNKNOWN1发送短信失败，原因未知。
SEND_SMS_FAILURE_RADIO_OFF2发送短信失败，原因为调制解调器关机。
SEND_SMS_FAILURE_SERVICE_UNAVAILABLE3发送短信失败，原因为网络不可用、不支持发送或接收短信。

审核编辑 黄宇

打开APP阅读更多精彩内容
声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容侵权或者其他违规问题，请联系本站处理。 举报投诉

全部0条评论

快来发表一下你的评论吧 !

下载APP
|投诉反馈|电子发烧友网
© 2021 elecfans.com
湘ICP备2023018690号
×
20
完善资料，
赚取积分