短信服務

說明：
開發前請熟悉鴻蒙開發指導文檔 ：[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

參數：

示例：

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

參數：

返回值：

示例：

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

參數：

示例：

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

參數：

示例：

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

返回值：

示例：

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 ：該接口為系統接口，三方應用不支持調用。

參數：

示例：

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 ：該接口為系統接口，三方應用不支持調用。

參數：

返回值：

示例：

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 ：該接口為系統接口，三方應用不支持調用。

參數：

示例：

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 ：該接口為系統接口，三方應用不支持調用。

參數：

返回值：

示例：

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

返回值：

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

ShortMessage

短信實例。

系統能力 ：以下各項對應的系統能力均為SystemCapability.Telephony.SmsMms。

ShortMessageClass

短信類型。

系統能力 ：以下各項對應的系統能力均為SystemCapability.Telephony.SmsMms。

SendMessageOptions

發送短信的參數和回調。根據SendMessageOptions中的可選參數content的值判斷短信類型。

系統能力 ：以下各項對應的系統能力均為SystemCapability.Telephony.SmsMms。

ISendShortMessageCallback

回調實例。返回短信發送結果、存儲已發送短信的URI和是否為長短信的最后一部分。

系統能力 ：以下各項對應的系統能力均為SystemCapability.Telephony.SmsMms。

IDeliveryShortMessageCallback

回調實例。返回短信送達報告。

系統能力 ：以下各項對應的系統能力均為SystemCapability.Telephony.SmsMms。

SendSmsResult

短信發送結果。

系統能力 ：以下各項對應的系統能力均為SystemCapability.Telephony.SmsMms。

審核編輯 黃宇