短信服務(wù)

導(dǎo)入模塊

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

sms.createMessage

createMessage(pdu: Array<number>, specification: string, callback: AsyncCallback<ShortMessage>): void

根據(jù)協(xié)議數(shù)據(jù)單元（PDU）和指定的短信協(xié)議創(chuàng)建短信實(shí)例。使用callback異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.SmsMms

參數(shù)：

示例：

const specification = '3gpp';
// 以數(shù)組的形式顯示協(xié)議數(shù)據(jù)單元（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<number>, specification: string): Promise<ShortMessage>

根據(jù)協(xié)議數(shù)據(jù)單元（PDU）和指定的短信協(xié)議創(chuàng)建短信實(shí)例。使用Promise異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.SmsMms

參數(shù)：

返回值：

示例：

const specification = '3gpp';
// 以數(shù)組的形式顯示協(xié)議數(shù)據(jù)單元（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 failed, promise: err->${JSON.stringify(err)}`);
});

sms.sendMessage

sendMessage(options: SendMessageOptions): void

發(fā)送短信。

需要權(quán)限：ohos.permission.SEND_MESSAGES

系統(tǒng)能力：SystemCapability.Telephony.SmsMms

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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 = '短信內(nèi)容';
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<number>): void

獲取發(fā)送短信的默認(rèn)SIM卡槽ID。使用callback異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.SmsMms

參數(shù)：

示例：

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

sms.getDefaultSmsSlotId7+

getDefaultSmsSlotId(): Promise<number>

獲取發(fā)送短信的默認(rèn)SIM卡槽ID。使用Promise異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.SmsMms

返回值：

示例：

let promise = sms.getDefaultSmsSlotId();
promise.then(data => {
    console.log(`getDefaultSmsSlotId success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.error(`getDefaultSmsSlotId failed, promise: err->${JSON.stringify(err)}`);
});

sms.hasSmsCapability7+

hasSmsCapability(): boolean

檢查當(dāng)前設(shè)備是否具備短信發(fā)送和接收能力，該方法是同步方法。

系統(tǒng)能力：SystemCapability.Telephony.SmsMms

返回值：

let result = sms.hasSmsCapability(); 
console.log(`hasSmsCapability: ${JSON.stringify(result)}`);

ShortMessage

短信實(shí)例。

系統(tǒng)能力：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Telephony.SmsMms。

ShortMessageClass

短信類型。

系統(tǒng)能力：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Telephony.SmsMms。

SendMessageOptions

發(fā)送短信的參數(shù)和回調(diào)。根據(jù)SendMessageOptions中的可選參數(shù)content的值判斷短信類型。

系統(tǒng)能力：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Telephony.SmsMms。

ISendShortMessageCallback

回調(diào)實(shí)例。返回短信發(fā)送結(jié)果、存儲(chǔ)已發(fā)送短信的URI和是否為長短信的最后一部分。

系統(tǒng)能力：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Telephony.SmsMms。

IDeliveryShortMessageCallback

回調(diào)實(shí)例，返回短信送達(dá)報(bào)告。

系統(tǒng)能力：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Telephony.SmsMms。

SendSmsResult

短信發(fā)送結(jié)果。

系統(tǒng)能力：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Telephony.SmsMms。